配置 OpenClaw 接入 New API 的教程

[coda8]

标题

配置 OpenClaw 接入 New API 的教程

正文

以下是一步步把 OpenClaw 指向 New API 的操作指南，假设你已经按照仓库 README 部署好了 New API 与 CLIProxyAPI：

1. 准备 New API Token

1. 打开 http://<你的服务器>:3000 登录 New API 控制台（默认账号 root / 密码 123456，生产环境务必修改）。
2. 在左侧的 令牌 / Tokens 页面里新建令牌，记录生成的 sk-xxxx。
3. 如果你计划从 OpenClaw 访问多个上游渠道，建议在 New API 内先配置好渠道和路由策略。

2. 新建 OpenClaw 外部通道

1. 在 OpenClaw 后台（openclaw dashboard 或 openclaw channel add）创建一个新的 REST 外部通道。
2. 关键参数示例：
   • Base URL：http://<你的服务器>:3000/v1
   • Auth Header：Authorization: Bearer <New API Token>
   • Timeout：30s（根据网络情况调整）
3. 如需透传模型名称，可在 「模型映射」里把 OpenClaw 的模型 ID 映射到 New API 里配置的模型名，例如：

   mappings:
     gpt-4o-mini: newapi::gpt-4o-mini
     deepseek-r1: newapi::deepseek-r1

3. CLIProxyAPI 备用策略（可选）

• 若想让 OpenClaw 访问 CLIProxyAPI，只需把 Base URL 改为 http://<你的服务器>:8317/v1，API Key 改成 llm-stack-default-key（或你配置的值）。
• 可以在 OpenClaw 的策略机制里设置「主用 New API、备用 CLIProxyAPI」，实现自动切换。

4. 测试

1. 在 OpenClaw 里选用刚创建的外部通道，发送一条测试消息，看能否返回结果。
2. 如果失败，请检查：
   • 防火墙或端口是否对 OpenClaw 所在主机开放
   • New API 日志（docker compose logs -f new-api）
   • OpenClaw 外部通道配置里的 URL/Token 是否正确

5. 常见问题

• 429 / 超限：说明 New API 对应渠道限制了请求速率，调整路由策略或并发配置。
• 401：检查 Token 是否正确、是否已被禁用。
• 模型不存在：确认映射的模型名已经在 New API 内配置。

如有补充请在后续评论里提出。