OpenClaw 接入 code0.ai 中转 API 配置指南

本文档旨在说明如何在 OpenClaw 中正确配置并使用 code0.ai 提供的第三方中转 API（特别是 Claude 系列模型）。由于 OpenClaw 对工具调用（Tool Use）和思维链（Thinking Blocks）的格式要求非常严格，错误的配置会导致模型陷入死循环或静默失败。

核心原则：必须使用 Anthropic 格式

在接入 Claude 系列模型（如 claude-sonnet-4-6）时，必须使用 anthropic-messages API 格式，绝不能使用 openai-completions 格式。

如果使用 openai-completions 格式接入 Claude 模型，会导致以下严重问题：

工具调用失败：中转站返回的是 OpenAI 格式的 toolCall，而 OpenClaw 内部期望的是 Anthropic 原生的 tool_use。这会导致 OpenClaw 无法识别模型的工具调用请求，表现为“模型在思考但什么都没做”。

历史重放错误：OpenAI 格式无法正确处理 Anthropic 特有的思维链（Thinking Blocks），在多轮对话重放历史时会引发解析错误。

死循环挂机：由于工具调用被静默忽略，模型会持续返回空内容，最终导致 OpenClaw 陷入死循环并触发超时挂机。

正确的配置示例

请修改 ~/.openclaw/openclaw.json 文件，在 models.providers 下添加或修改 code0 的配置：

{
  "models": {
    "providers": {
      "code0": {
        "baseUrl": "https://code0.ai",
        "apiKey": "sk-你的API密钥",
        "api": "anthropic-messages",
        "models": [
          {
            "id": "claude-sonnet-4-6",
            "name": "Claude Sonnet 4.6",
            "api": "anthropic-messages",
            "reasoning": true,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 500000,
            "maxTokens": 32768
          }
        ]
      }
    }
  }
}

配置细节说明

字段	正确值	错误值	说明
`api`	`anthropic-messages`	`openai-completions`	必须在 provider 级别和 model 级别都指定为 `anthropic-messages`。
`baseUrl`	`https://code0.ai`	`https://code0.ai/v1`	OpenClaw 在使用 `anthropic-messages` 模式时，会自动在 baseUrl 后追加 `/v1/messages`。如果 baseUrl 包含 `/v1`，最终请求会变成 `/v1/v1/messages` 导致 404 错误。
`reasoning`	`true`	`false`	启用 Claude 模型的思维链（Thinking）功能。

故障排查

如果你在修改配置前已经遇到了挂机或消息遗漏的问题，说明当前会话（Session）的历史记录已经被错误的格式污染。

修复步骤：

按照上述指南修改 openclaw.json。

重启 OpenClaw Gateway 服务以加载新配置。

在你的聊天客户端（如 Telegram）中，向机器人发送 /new 命令，强制开启一个全新的会话。

版本要求

强烈建议将 OpenClaw 升级至 2026.3.13 或更高版本。该版本修复了多个与第三方中转兼容性相关的底层问题（如 PR #44432 和 #44843），能显著提升中转 API 的稳定性。

OpenClaw 接入 code0.ai 中转 API 配置指南

核心原则：必须使用 Anthropic 格式#

正确的配置示例#

配置细节说明#

故障排查#

版本要求#

核心原则：必须使用 Anthropic 格式

正确的配置示例

配置细节说明

故障排查

版本要求