1. 小龙虾 OpenClaw 到底是什么为什么值得折腾OpenClaw 在中文圈被叫成“小龙虾”本质是一个可以自托管的 AI Agent Gateway。它跑在你自己的电脑或服务器上对外提供 Web 控制台、聊天渠道入口对内连接大模型 API、本地模型、文件系统、浏览器自动化和各种工具。你可以把它理解成一个“AI 中枢”用户从控制台或 Telegram、飞书、Discord 发消息消息进入 OpenClaw GatewayGateway 再决定调用哪个模型、执行哪个工具、返回什么结果。它和普通聊天网页最大的区别在于可扩展性。普通网页只能聊天OpenClaw 能挂工具、能读文件、能跑浏览器自动化、能接多个模型供应商。对想搭个人 AI 助手、做自动化工作流、或者单纯想有个本地可控入口的人来说这东西很值得折腾一次。这篇教程聚焦四平台完整安装Windows、macOS、Linux、WSL2并且重点演示怎么用 TaoToken 统一 Key 完成模型接入。TaoToken 官网是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 。它的价值在于一个 Key 就能走多个模型通道省去在 OpenClaw 里反复切换供应商配置的麻烦。适合谁适合第一次装 OpenClaw 的新手、想统一管理模型 Key 的开发者、以及在 Windows 上想用 WSL2 跑长期服务的进阶用户。安装前先确认环境Node.js 推荐 2422.16 也能用内存 8GB 起步16GB 更舒服磁盘至少留 3GB首次安装需要联网。终端工具用系统自带的就行浏览器 Chrome、Edge、Firefox 都可以。新手推荐路线很简单Windows 用 PowerShell 官方脚本macOS 和 Linux 用 curl 官方脚本Windows 进阶用户走 WSL2已经有 Node 环境的直接 npm 全局安装。下面按平台逐个拆。2. TaoToken 统一 Key 的前置准备与模型选型在装 OpenClaw 之前先把模型通道准备好这样初始化时能一次填对少走回头路。TaoToken 的作用是提供一个统一的 API 入口你拿到一个 Key就能在 OpenClaw 里配置多个模型不用为每个供应商单独维护一套 Base URL 和密钥。先去 TaoToken 控制台创建 API Key。打开 https://taotoken.net/api 进入控制台后找到 API Keys 页面新建一个 Key 并复制保存。这个 Key 只显示一次丢了就得重建。建议命名成 openclaw-local 之类方便以后区分用途。模型选型上OpenClaw 初始化时会让你填 Provider、Base URL、API Key、Default Model。用 TaoToken 的话Base URL 统一填 https://taotoken.net/api Key 填刚创建的那串Model ID 按你要用的模型填。常见可选模型包括 deepseek-chat、qwen-plus、gpt-4.1、claude-3-5-sonnet 等具体以 TaoToken 控制台模型列表为准。模型名必须和平台文档完全一致大小写、连字符都不能错这是后面“模型不回复”最常见的坑。如果你还想接本地模型可以另外装 OllamaBase URL 填 http://127.0.0.1:11434 Model 填 ollama list 里显示的名字比如 qwen2.5:7b。本地模型和 TaoToken 通道可以共存OpenClaw 里配置多个 Provider 即可。这里给一份 OpenClaw 模型配置的 JSON 片段路径通常在 ~/.openclaw/config.json Windows 是 C:\Users\你的用户名.openclaw\config.json 字段名以你实际版本为准核心是 Base URL、Key、Model ID 三件套{ providers: { taotoken: { baseUrl: https://taotoken.net/api, apiKey: sk-你的TaoToken密钥, models: { default: deepseek-chat, fallback: qwen-plus } }, ollama: { baseUrl: http://127.0.0.1:11434, apiKey: ollama, models: { default: qwen2.5:7b } } }, defaultProvider: taotoken }注意apiKey 不要写进公开仓库、不要截图发群、不要贴到博客里。如果怀疑泄露立刻去 TaoToken 控制台删除旧 Key 并重建。如果你用的是 Claude Code 类工具做代码润色或者想通过 Coding Plan 长期跑 Agent 任务TaoToken 也提供对应入口模型对话在 https://taotoken.net/api Coding Plan 在 https://taotoken.net/api 接入文档在 https://taotoken.net/api 。这些 deep link 都带 utm_sourcetaotoken_aicg_blog_endutm_content 和 utm_campaignrewrite方便你从文章直接跳转。前置准备做完就可以进入各平台安装了。记住一个原则先装 OpenClaw再 onboard 填 TaoToken 配置最后验证连通性。3. Windows / macOS / Linux / WSL2 四平台可复制安装配置这一节是全文操作密度最高的部分每个平台都给完整命令复制就能跑。装完统一做验证。3.1 Windows PowerShell 安装以管理员身份打开 PowerShell先看版本$PSVersionTable.PSVersion如果脚本执行被限制临时放开当前窗口Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass然后跑官方脚本iwr -useb https://openclaw.ai/install.ps1 | iex不想自动进初始化向导用这个 ([scriptblock]::Create((iwr -useb https://openclaw.ai/install.ps1))) -NoOnboard装完新开一个 PowerShell 窗口验证openclaw --version openclaw doctor3.2 macOS 安装打开终端跑curl -fsSL https://openclaw.ai/install.sh | bash不自动初始化curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard验证openclaw --version openclaw doctor3.3 Linux 安装Ubuntu / Debian 先更新sudo apt update sudo apt install -y curl ca-certificatesCentOS / Rocky / AlmaLinuxsudo dnf install -y curl ca-certificates然后curl -fsSL https://openclaw.ai/install.sh | bash不自动初始化加-s -- --no-onboard验证同上。3.4 WSL2 安装管理员 PowerShell 里wsl --install重启后确认wsl -l -v看到 Ubuntu 且版本是 2 就对了。进入wsl在 WSL2 里更新并安装sudo apt update sudo apt install -y curl ca-certificates curl -fsSL https://openclaw.ai/install.sh | bash验证openclaw --version openclaw doctorWSL2 里 Gateway 跑起来后Windows 浏览器访问 http://127.0.0.1:18789/ 通常能直接打开。3.5 npm 手动安装已有 Node 环境node -v npm -v npm install -g openclawlatestpnpm 用户pnpm add -g openclawlatest3.6 初始化并写入 TaoToken 配置四平台通用openclaw onboard --install-daemon向导里 Provider 选自定义或 OpenAI 兼容Base URL 填 https://taotoken.net/api API Key 填你的 TaoToken KeyDefault Model 填 deepseek-chat 或你选的模型。--install-daemon会把 Gateway 装成后台服务关终端也不停。如果你用 CC Switch 或 Cline MCP 管理配置记得三件套写全Base URL、Key、Model ID缺一个都会连不上。4. 验证请求与成功结果Gateway 状态、Dashboard 与模型回复装完不验证等于没装。这一节按顺序做连通性检查每一步都有预期结果。先看 Gateway 状态openclaw gateway status预期看到 running 或 active。没起来就openclaw gateway start改了配置后重启openclaw gateway restart停止openclaw gateway stop打开控制台openclaw dashboard或者浏览器手动开 http://127.0.0.1:18789/ 。能进 Dashboard 说明 Gateway 正常。接下来验证模型通道。在 Dashboard 里发一条测试消息比如“你好请回复你的模型名”。如果收到回复说明 TaoToken 通道通了。没回复就按第五节排查。再验证 Ollama如果装了ollama list ollama run qwen2.5:7b能进交互就说明本地模型正常。OpenClaw 里 Ollama 的 Base URL 填 http://127.0.0.1:11434 Model 填 ollama list 显示的名字改完openclaw gateway restart。一个完整的成功链路是这样的Dashboard 能打开 → 发消息 → Gateway 日志显示请求发出 → TaoToken 返回 200 → Dashboard 显示模型回复。任何一环断了看下一节。提示验证阶段先用最基础的模型比如 deepseek-chat别一上来就填复杂模型名。基础模型通了再换高级模型能快速定位是配置问题还是模型名问题。5. 本篇常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错对照每条给原因和解决动作。401 UnauthorizedTaoToken Key 错了、过期了、或者没填。去控制台重建 Key确认 Base URL 是 https://taotoken.net/api Key 没有多余空格。改完重启 Gateway。local proxy failed本地代理或端口冲突。检查 18789 端口是否被占用openclaw gateway status看服务状态必要时换端口或重启。WSL2 用户注意 Windows 和 WSL 的端口映射127.0.0.1 在两边含义不同。reading choices 报错通常是模型返回格式和 OpenClaw 预期不一致常见于模型名写错或 Base URL 指向了不兼容的端点。确认 Model ID 和 TaoToken 文档一致Base URL 没有多写路径。OAuth 相关报错如果你在配置里混用了 OAuth 流程和 API Key 流程会冲突。OpenClaw 接 TaoToken 用 API Key 模式不要走 OAuth。清掉旧认证缓存重新 onboard。openclaw 不是内部或外部命令npm 全局路径没进 PATH。npm config get prefix找到路径Windows 常见是 C:\Users\你的用户名\AppData\Roaming\npm 加进系统环境变量重开终端。PowerShell 不允许执行脚本Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass后重跑。Node 版本太低node -v确认低于 22.16 就升级到 24。npm 权限不足 EACCES别乱用 sudo用 nvm 管理 Nodenvm install 24 nvm use 24 npm install -g openclawlatestGateway 启动失败openclaw doctor看诊断检查端口、配置文件、API Key、Node 版本、防火墙。控制台打不开openclaw gateway status和restart再查防火墙。模型一直不回复按顺序查 Key、Base URL、Model ID、余额、网络、Gateway 是否重启。Ollama 能用但 OpenClaw 调不通ollama list确认模型名OpenClaw 里 Base URL 填 http://127.0.0.1:11434 Model 和 list 一致重启 Gateway。排障时如果反复卡在接入环节直接看 TaoToken 的 API Keys 页面和接入文档https://taotoken.net/api 。验证模型是否正常用模型对话入口https://taotoken.net/api 。长期跑编码或 Agent 任务看 Coding Planhttps://taotoken.net/api 。6. 安全收尾与长期使用建议OpenClaw 能调工具、读文件、跑浏览器能力越大风险越高。装完做几件事不要随便装陌生 Skills尤其是curl xxx | bash、powershell -enc xxx、来源不明的 npm 包不要直接把 0.0.0.0:18789 暴露公网远程访问用 SSH 隧道或带认证的反向代理API Key 不进截图、不进仓库、不进群聊权限最小化不需要文件权限就不开不需要命令执行就不开。卸载重装流程openclaw gateway stop→npm uninstall -g openclaw→ 删配置目录 ~/.openclaw Windows 是 C:\Users\你的用户名.openclaw → 重装 → 重新 onboard。删配置目录会清空认证和缓存谨慎操作。验收清单openclaw --version有版本号openclaw doctor无严重错误onboard 已执行openclaw gateway status正常浏览器能开 127.0.0.1:18789Dashboard 能进TaoToken 模型能回复Ollama 模型在 list 里Key 没公开控制台没暴露公网。命令速查Windows 装iwr -useb https://openclaw.ai/install.ps1 | iexmacOS/Linux/WSL2 装curl -fsSL https://openclaw.ai/install.sh | bashnpm 装npm install -g openclawlatest初始化openclaw onboard --install-daemon诊断openclaw doctorGateway 状态openclaw gateway status重启openclaw gateway restart控制台openclaw dashboardOllama 拉模型ollama pull qwen2.5:7b。最后说个实际经验装 OpenClaw 最容易翻车的不是安装本身而是模型配置那一步。Base URL、Key、Model ID 三件套只要有一个不对表现就是“模型不回复”但报错信息往往很模糊。我的做法是先用 TaoToken 的 deepseek-chat 跑通最小链路确认 Dashboard 能收到回复再逐步加 Ollama、加其他模型。这样出问题时能快速定位是新配置引入的还是基础链路本来就没通。