1. 先别急着把 Key 粘进 onboard先处理掉 Invalid API key部署 OpenClaw 时第 4.1 节的 openclaw onboard 引导向导会要求粘贴模型 API Key很多人随手填了临时 Key重启 gateway 就收到 Invalid API key 或 401。其实只要先到 TaoToken 官网 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 创建一把自己的 Key再粘回 onboard整个 Key 无效的坑就绕开了。下面按 5 分钟跑通的节奏从环境检查、安装 OpenClaw、修改配置文件到启动 gateway一步步说清楚。1.1 那台报错的机器通常缺的不是 OpenClaw 而是可用 Key触发 Invalid API key 时openclaw gateway 能正常监听 18789 端口日志里也显示服务起来了但只要一请求模型就返回 401。原因是多方面的Key 敲错、复制时带了换行、Key 本身没有对应模型权限或者那只是临时生成的测试 Key 没有余额。原文 7.3 给出的方案是openclaw config set models.default.apiKey sk-xxx把 Key 换掉再重启。这个方向是对的但很多人卡在「不知道去哪里换一把真正能用的 Key」。1.2 TaoToken 在这个环节扮演的角色TaoToken 是统一 API 兼容通道它不改变 OpenClaw 的使用方式。你在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 注册账号、创建 API Key然后在 onboard 或 openclaw.json 里把 Key 填进去模型请求就改走这条通道。它的价值不是让你绕过谁而是让 OpenClaw 的默认模型在 Key 无效时有一个干净的替代入口同一把 Key 可以对应多个模型控制台能直接看到每次调用是否成功部署阶段不用反复猜「是不是 Key 又被平台清了」。2. 环境准备OpenClaw 需要 Node.js 22别在旧版本上浪费时间2.1 先做 30 秒检查原文一开头就要求检查 Node.js 版本。这一步最容易跳过但 OpenClaw 用了 Node.js 22 引入的异步特性和模块系统旧版本会直接语法错误。在终端依次跑node --version npm --version如果输出不是 v22.x 或更高就按下面的方式装一个 Node 24。不要用包管理器里那个落后两三个大版本的 Node后面装 OpenClaw 大概率报错。2.2 用 nvm 装 Node 24最省事nvm 可以在同一台机器上切换多个 Node 版本装错了还能退回旧版本。按原文推荐给开发者的方案curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash source ~/.bashrc # 如果用的是 zsh改成 source ~/.zshrc nvm install 24 nvm use 24 nvm alias default 24完成后重新跑node --version确认输出 v24.x再进入下一步。这里多花一分钟后面部署能省五分钟。3. 安装 OpenClaw 并跑通 openclaw onboard 的 apiKey 输入3.1 全局安装 openclaw执行npm install -g openclawlatest openclaw --version看到版本号输出就说明安装成功。npm 如果报 EACCES 权限错误说明全局目录没有写权限正确做法是把 npm 全局目录指到用户目录而不是直接 sudo 硬装mkdir -p ~/.npm-global npm config set prefix ~/.npm-global echo export PATH~/.npm-global/bin:$PATH ~/.bashrc source ~/.bashrc3.2 onboard 引导向导里把 Key 换成 TaoToken 的执行openclaw onboard向导会依次问 Gateway 端口、认证令牌、AI 模型、API Key。到 API Key 这一步不要再粘临时 Key打开 TaoToken 注册账户在控制台创建一把 API Key复制后粘贴到 onboard 的 apiKey 输入处。这里有两个容易踩的细节。第一模型 ID 不要凭印象填回到 TaoToken 模型广场看当前列表复制里面实际显示的模型 ID。第二onboard 让你选择 OpenAI、Claude 还是 DeepSeek 时按你选定的模型类型选TaoToken 作为统一接入通道通常以兼容方式工作关键是 Key 必须来自 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 而不是随手填的临时值。3.3 如果向导已经配置完只想改 Key已经跑过 onboard、不想重来一遍的可以只用命令改 Keyopenclaw config set models.default.apiKey YOUR_API_KEY但这只改了 Key没有改 Base URL。要让 OpenClaw 完整走 TaoToken 通道建议直接编辑 openclaw.json见下一节。4. 手动改 openclaw.jsonmodels.default 指向 TaoToken4.1 先看真实文件onboard 生成的文件在~/.openclaw/openclaw.json结构类似{ gateway: { port: 18789, authToken: your-strong-password-here }, models: { default: { provider: openai, model: gpt-4o-mini, apiKey: sk-xxx } } }TaoToken 只改models.default这一整段其它配置保持原样。4.2 把 apiKey 替换为 TaoToken Key并补上 baseURL直接创建一份干净的配置mkdir -p ~/.openclaw cat ~/.openclaw/openclaw.json EOF { gateway: { port: 18789, authToken: your-strong-password-here }, models: { default: { provider: openai, model: YOUR_MODEL_ID, apiKey: YOUR_API_KEY, baseURL: https://taotoken.net/api } } } EOF三个注意点。第一YOUR_API_KEY是从 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台创建的不是抄示例里的字符串。第二YOUR_MODEL_ID以模型广场当时列表为准不要写死。第三baseURL只填https://taotoken.net/api末尾不要加/v1。官网落地页和接口地址是两回事前者用来注册、创建 Key、看用量后者用来填进工具。4.3 provider 字段怎么处理如果你的模型广场里选的是 Claude 系列而 OpenClaw 要求写anthropic那就把provider从openai改成对应值。TaoToken 是统一 API 兼容通道provider 跟着 OpenClaw 版本和模型类型走README 或配置 schema 为准。最核心的动作只有两个apiKey替换成 TaoToken 的 KeybaseURL补上 https://taotoken.net/api。5. 启动 gateway 并发送第一条测试消息5.1 前台启动看日志openclaw gateway --verbose看到Gateway ready说明启动成功。如果马上出现Invalid API key或401直接跳到第 6 节排查。前台模式在终端里能看到全部日志第一次跑建议用这个模式不要一上来就后台运行。5.2 健康检查和测试消息另开一个终端openclaw gateway status openclaw agent --message 你好请介绍一下你自己能收到正常回复说明 Key 和 Base URL 都通了。也可以按原文的 HTTP 方式验证curl -X POST http://localhost:18789/api/chat \ -H Authorization: Bearer your-strong-password-here \ -H Content-Type: application/json \ -d {message:你好}注意这里Authorization用的是 gateway 的authToken不是 TaoToken 的 API Key模型侧的 Key 已经在 openclaw.json 里配好了。5.3 后台运行确认稳定后按原文用openclaw gateway start后台运行日志用openclaw logs --follow查看。TaoToken 只影响模型连接这一层不影响 daemon 或 Docker 部署方式。6. 排障401 和 Invalid API key 的几种常见写法6.1 Key 复制不干净日志里出现Invalid API key时先看当前配置openclaw config get models.default.apiKey常见问题是复制时带了空格、换行或者把官网首页地址当成了 Key。重新去 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 控制台的 API Keys 页面复制完整 Key粘贴后重启 gateway。6.2 Base URL 填成了官网或带了 /v1另一个高频原因是把https://taotoken.net/api写成了https://taotoken.net/或者自己加了/v1。OpenClaw 会在 Base URL 后面拼接请求路径多一层路径会让请求打不到正确的模型接口表现就是请求失败或鉴权不过。配置里只保留https://taotoken.net/api。6.3 模型 ID 不在 TaoToken 模型广场有的报错不是Invalid API key而是Model not found。这类情况核对 openclaw.json 的model字段确保与 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 模型广场显示的 ID 完全一致包括大小写。模型广场列表会更新以当时显示为准不要照抄任何教程里的固定值。6.4 gateway 的 401 与模型 API 的 401 是两回事原文 7.2 讲认证失败7.3 讲 API Key 无效都对应 HTTP 401但排查思路不同。curl 测试返回 401先确认Authorization用的是 gateway 的authTokenopenclaw agent返回 401才去查apiKey和baseURL。把这两者混在一起查最容易走弯路。7. 跑通之后去控制台对一下这次调用部署全部走完后打开 TaoToken 模型对话 用同一把 Key 发一条消息确认刚才openclaw agent的调用真的记到了本次用量里。这样既能排除「gateway 显示成功但模型其实是空跑」的情况也能看清楚模型 ID 对应的实际消耗。如果要把这台 OpenClaw 长期跑业务建议先看 Coding Plan 的套餐是否覆盖日常调用需要轮换 Key 就去 控制台 API Keys 重新创建。将来若还想把 Claude Code 也接到同一账号Claude Code 接入文档 里的环境变量可以直接照抄。最后留一句个人体会部署 OpenClaw 最花时间的往往不是 OpenClaw 本身而是 Key 来源不明确时反复试错。先把 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_end 上的 Key 准备好再进 onboard整条部署链会顺畅很多。