Clawdbot 配好 Claude Code 中转，没那么难

file

我折腾了两天，终于把 Clawdbot 接上 Claude Code 的中转 API，跑起来了。中间踩了好几个坑，尤其是那个“必须写 models 字段”的问题，差点让我以为是服务端挂了。

如果你也想用本地 Clawdbot + 第三方 Claude 中转（比如 MaynorAI 提供的那种），这篇记录或许能帮你少走弯路。

先说结论：关键就一点

别信环境变量！
很多人以为设个 ANTHROPIC_BASE_URL 就行，不行。Clawdbot 只认配置文件里的 models.providers.anthropic 设置。

而且，四个字段一个都不能少：

  • baseUrl
  • apiKey
  • api: "anthropic-messages"
  • models: [] ← 这个空数组最容易漏，但少了就报错

我是怎么装起来的？

  1. 系统准备
    • macOS（Linux 应该差不多）
    • Node.js 22+（用 nvm install 22 && nvm use 22 切）
    • 装了 pnpm（Clawdbot 推荐）

⚠️ 如果你用的是 Homebrew 装的 node，可能版本卡在 20.x。一定要用 nvm 或 volta 切到 22。

  1. 安装
    我用了官方一键脚本，省事：

curl -fsSL https://clawd.bot/install.sh | bash

装完跑 clawdbot onboard，跟着向导走。

向导里会问你用哪种 Anthropic 认证方式。如果你有 Claude Max 订阅，选 “setup-token”，不用额外买 API Key。只要在另一个终端运行 claude setup-token，粘贴生成的 token 就行。

📌 注意：这个 token 不是 API Key，是专为 CLI 工具设计的长期凭证。

  1. 配置中转 API（重点！）

向导走完后，默认还是连官方 Anthropic。要切到中转，得手动改配置文件：

nano ~/.clawdbot/clawdbot.json

找到或新建 models 字段，填成这样：

{
"models": {
"providers": {
"anthropic": {
"baseUrl": "https://code.claude-opus.top/api",
"apiKey": "cr_xxxxxxxxxxxxx",
"api": "anthropic-messages",
"models": []
}
}
}
}

特别注意最后那行 "models": [] —— 我第一次漏了它，Gateway 启动就崩，日志里只有一句：

Invalid input: expected array

查了半天才意识到是 schema 校验失败。

  1. 重启 & 测试

改完配置，必须重启 Gateway：

clawdbot gateway restart

然后打开 Web UI（默认 http://127.0.0.1:18789/，带 token 的链接向导最后会给），发一句 “hi”，看能不能收到回复。

如果卡住，先看日志：

tail -f ~/.clawdbot/logs/gateway.err.log

常见错误：

  • fetch failed → API 地址或 key 不对
  • Invalid config → JSON 格式错 or 缺字段
  • Gateway 一直重启 → 可能是 Telegram 初始化失败（先关掉试试）

几个实用技巧

关掉 Telegram（临时）
我一开始启用了 Telegram Bot，结果因为网络问题，Gateway 反复崩溃。后来发现可以临时禁用：

clawdbot config set channels.telegram.enabled false
clawdbot gateway restart

等主流程跑通再开回来。

快速看日志
除了 gateway.err.log，详细请求日志在：

tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log

里面是 JSON 格式的完整请求/响应，调试 API 问题很有用。

重置配置
搞乱了？直接删目录重来：

clawdbot gateway stop
rm -rf ~/.clawdbot
clawdbot onboard

安全提醒（别忽视）

  • API Key 别提交 Git：.clawdbot 目录默认没加到 .gitignore，小心泄露。
  • Web UI 别外放：默认只监听 127.0.0.1，但如果用 --bind 0.0.0.0，记得加 token 或走 Tailscale。
  • 定期换 token：尤其是分享过带 token 的 URL。

最后

Clawdbot 本身是个很强大的本地 AI 枢纽，但文档有点散，错误提示也不够友好。希望这篇实操记录能帮你避开我踩过的雷。

配通那一刻，看着 Web UI 里 Claude 正常回消息，真的有种“成了”的爽感。祝你也顺利跑起来！