1. OpenClaw接入
Code0.ai
  • 默认模块
    • 引言
      • 引言
      • 添加客服
    • 快速开始(小白篇)
      • 5分钟快速开始
      • 新用户:怎么拿到 Key?
      • 发出请求
      • 计费说明
      • 如何查询用量日志
    • 平台能力概览(入门篇)
      • 平台定位
      • 模型指纹检测(模型掺水检测)
      • 中转站基本介绍
        • 分组的特殊性及价格差异
        • 代理接口调用地址
        • 聊天完成对象
      • 关于我们的模型
        • 模型总览一览表
        • 不知道选哪个模型?
        • 我们的模型系列
          • OpenAI — 共 9 个模型
          • Anthropic Claude — 共 8 个模型
          • Google Gemini — 共 11 个模型
          • 阿里巴巴(通义千问)— 共 4 个模型
          • 智谱(GLM)— 共 4 个模型
          • 豆包 Doubao(字节跳动)— 共 3 个模型
        • 模型能力对比
          • 文本对话能力
          • 代码生成能力
          • 图像能力
    • API Key 管理(进阶篇)
      • 创建与管理 Key
      • 密钥安全与批量操作
    • FAQ常见问题(小白篇)
      • 故障自查
        • 连接失败 / 报错 / 无响应先看这里
        • 错误码速查表
          • API报错了?!
        • Token 消耗异常排查
          • Cherry Studio 联网搜索导致 Token 爆炸
          • Claude Code autoCompact 无限重试
          • 客户端超时后自动重试
          • API 请求失败但被扣费
          • 生图API请求失败但显示消费
      • 常见问题Top 20
        • 后台显示的 "$" 是美元吗?
        • 充 10 块为什么实际付了 15?
        • 分组倍率 6x 是什么意思?
        • 模型名写 4.6 还是 4-6?
        • 创建令牌时可以不选分组吗?
        • 怎么开启 1M 上下文?
        • 开了梯子后调用 API 报 401 怎么办?
        • code0.ai / hk.code0.ai / jp.code0.ai 用哪个?
        • 你们会存储我传的图片/对话数据吗?
        • 调用图片生成模型扣费但未显示图片
    • 🔥 核心 API (进阶篇)
      • 对话生成(Chat Completions)
        • Anthropic Claude 接口
          • 聊天完成对象
          • 聊天完成块对象
          • 创建聊天补全
          • 创建函数调用 (流式)
          • 创建格式化输出
          • 创建思考聊天
          • 联网搜索
          • PDF支持
        • ChatGPT聊天(Chat)
          • ChatGPT接口
            • 测试对话接口
            • 函数调用
          • 创建聊天识图 (流式)
          • 创建聊天补全 (非流)
          • 创建聊天补全 (流式)
          • 创建聊天识图 (流式) best64
          • 创建聊天识图 (非流)
          • 创建聊天创作图 (非流)
          • 官方Function calling调用
          • 官方N测试
          • 列出模型
          • 创建聊天函数调用
          • 创建结构化输出
          • 控制推理模型努力程度
        • Gemini接口
          • 标准接口
            • 文本生成-非流
            • 文本生成-流
            • 文本生成+思考-流
            • 图片理解
            • 格式化输出
            • 函数调用
            • 文档理解
            • 视频理解
            • 音频理解
            • 文本生成 gemini-3-pro-preview:generateContent
          • 兼容接口
            • Gemini 图片创作接口 [Chat 兼容格式]
            • 聊天接口 [Chat 兼容格式]
            • 聊天接口-思考1 [Chat 兼容格式]
            • 聊天接口-思考2 [Chat 兼容格式]
            • 识图接口 [Chat 兼容格式]
            • 聊天+读取文件接口 [Chat 兼容格式]
      • 对话生成 (Responses API)
        • Gemini接口
          • URL context [原生格式]
          • URL context
          • google search
          • 代码执行
        • GPT接口
          • 创建函数调用 Copy
      • 图片生成/绘画模型(Images)
        • 默认模块
        • Gemini接口
          • 图片生成
          • 图片生成 gemini-2.5-flash-image
          • 图片生成 gemini-2.5-flash-image 控制宽高比
          • 图片生成 gemini-3-pro-image-preview 控制宽高比 +清晰度
          • 图片编辑
          • Imagen 生成图片
        • 豆包doubao接口
          • 创建 Image
          • doubao-seedream-4-5-251128 图文生图(单图输入单图输出)
          • doubao-seedream-4-5-251128 多图融合(多图输入单图输出)
          • doubao-seedream-4-5-251128 组图输出(多图输出)
          • doubao-seedream-4-5-251128 单张图生组图
          • doubao-seedream-4-5-251128 多参考图生组图
        • Grok Image 系列
          • 创建image
          • 编辑 image
        • OpenAI接口
          • 图片生成image2
          • 图片编辑image2
      • 语音(Audio)
        • 语音转文字(STT / Whisper)
        • 文字转语音(TTS)
        • 实时语音对话
      • 向量嵌入(Embeddings)
        • Gemini接口
          • Embeddings
          • 文本嵌入
      • 文件管理(Files)
        • 上传文件
        • 文件列表
        • 获取文件信息
        • 删除文件
      • 模型管理(Models)
        • 获取模型列表
      • 审核/安全(Moderations)
        • 内容审核
    • SDK 与接入教程(进阶篇)
      • PHP 配置方式
        • PHP 使用图片编辑 Demo
      • NodeJS 配置方式
        • NodeJS 基础对话
      • Python配置方式
        • Python连续对话
    • 软件 / 插件配置教程(进阶篇)
      • Cherry Studio 接入
      • Roo Code接入(VScode插件)
      • Trae IDE 接入
      • Codex 接入(CLI )
      • Codex 接入(桌面版)
      • Hermes Agent 接入
      • workbuddy接入
      • Dify 接入
      • AutoClaw 接入
      • IntelliJ IDEA接入
      • OpenClaw接入
        • OpenClaw Claude 系列模型接入 code0.ai 中转 API 配置指南
        • 飞书 OpenClaw 配置 code0.ai 接口教程
      • opencode接入
        • opencode接入(终端cli)
        • OpenCode 接入(桌面版)
      • Cursor 配置
        • 通过插件实现Cursor配置(免费)
        • Cursor 配置 API 中转站(需要付费)
      • ChatBox 配置
        • Chatbox 接入 code0 API 配置教程(2026)
      • image2
        • gpt-image-2 图片生成配置教程
        • GPT-Image-2 图像生成与编辑开发指南
  1. OpenClaw接入

OpenClaw Claude 系列模型接入 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 模型,会导致以下严重问题:
1.
工具调用失败:中转站返回的是 OpenAI 格式的 toolCall,而 OpenClaw 内部期望的是 Anthropic 原生的 tool_use。这会导致 OpenClaw 无法识别模型的工具调用请求,表现为“模型在思考但什么都没做”。
2.
历史重放错误:OpenAI 格式无法正确处理 Anthropic 特有的思维链(Thinking Blocks),在多轮对话重放历史时会引发解析错误。
3.
死循环挂机:由于工具调用被静默忽略,模型会持续返回空内容,最终导致 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
          }
        ]
      }
    }
  }
}

配置细节说明#

字段正确值错误值说明
apianthropic-messagesopenai-completions必须在 provider 级别和 model 级别都指定为 anthropic-messages。
baseUrlhttps://code0.aihttps://code0.ai/v1OpenClaw 在使用 anthropic-messages 模式时,会自动在 baseUrl 后追加 /v1/messages。如果 baseUrl 包含 /v1,最终请求会变成 /v1/v1/messages 导致 404 错误。
reasoningtruefalse启用 Claude 模型的思维链(Thinking)功能。

故障排查#

如果你在修改配置前已经遇到了挂机或消息遗漏的问题,说明当前会话(Session)的历史记录已经被错误的格式污染。
修复步骤:
1.
按照上述指南修改 openclaw.json。
2.
重启 OpenClaw Gateway 服务以加载新配置。
3.
在你的聊天客户端(如 Telegram)中,向机器人发送 /new 命令,强制开启一个全新的会话。

版本要求#

强烈建议将 OpenClaw 升级至 2026.3.13 或更高版本。该版本修复了多个与第三方中转兼容性相关的底层问题(如 PR #44432 和 #44843),能显著提升中转 API 的稳定性。
上一页
IntelliJ IDEA接入
下一页
飞书 OpenClaw 配置 code0.ai 接口教程
Built with