AutoClaw 接入

把 QCode.cc 配成智谱 AutoClaw 的自定义模型：模型与API 里的填写路径、OpenAI 协议的 Base URL、模型ID 示例与连通测试

更新于 2026-11-10

本页目录

接入速览
用哪条协议
安装
配置步骤
- Base URL 要不要带 /v1
- 连通测试与设为默认
验证是否接通
已知限制
相关文档

最后核实：2026-11-10 · 📄 依据官方文档（AutoClaw 国内版 v2.3.0，2026-10-29 发布）

AutoClaw 能不能用自己的 API key？能，走 OpenAI 协议。截至 2026-11-10，按官方文档与官方博客：设置 →「模型与API」→「添加自定义模型」，「服务商」选「自定义」，「API协议」选「OpenAI」，Base URL 填 QCode 的 OpenAI 地址，再「连通测试」、「设为默认」。

接入速览¶

项目	说明
可用模型	GPT ✅ · 国产 ✅（DeepSeek / GLM / Kimi / Qwen）· Claude ❌（官方文档写出的自定义协议是 OpenAI）· Gemini ❌（QCode 暂不提供）
协议与 Base URL	OpenAI：`https://api.qcode.cc/openai/v1`
配置位置	应用内：设置 →「模型与API」→「添加自定义模型」
官方资料	模型设置 · 本地模型配置指南 · 更新日志

官方文档中心对它的介绍是：AutoClaw 是智谱推出的桌面端 AI Agent 产品，首个一键安装的本地 OpenClaw 应用。国内站是 autoclaw.zhipuai.cn，国际站是 autoclaw.z.ai（英文页写作 Z.ai 开发的通用 Agent）。版本：截至 2026-11-10，国内站更新日志的最新版本是 v2.3.0（2026-10-29）；国际站更新日志同日最新是 v1.17.8（2026-08-27）。本文的菜单与字段取自国内站文档与博客，国际站暂无同一页面，界面文字请以你所装版本为准。

用哪条协议¶

AutoClaw 的自定义模型，官方博客写明「API协议」选「OpenAI」，并说明支持兼容 OpenAI Chat Completions 协议的模型服务。这条协议在 QCode 上可用 GPT 与国产型号（DeepSeek / GLM / Kimi / Qwen），Base URL 就是 https://api.qcode.cc/openai/v1。

Claude 型号走 Anthropic 端点，AutoClaw 的自定义模型不走该协议。需要 Claude 的读者，可看支持 Anthropic 端点的同类应用：有道龙虾 LobsterAI 接入、Qoder 接入、OpenClaw 接入；终端里用 Claude Code，见安装教程。协议与型号的完整对应见接入点与 API 格式。

安装¶

从国内站下载 macOS 或 Windows 安装包（官方博客写明支持 macOS 和 Windows 双系统），安装后按首次启动引导设置工作目录。另需一把 QCode 的 cr_ 密钥（控制台创建），不需要另外注册模型厂商的账号。

配置步骤¶

官方博客（2026-10-26）给出的路径：打开 AutoClaw，点击左下角设置图标，在左侧导航栏选「模型与API」；页面有「内置模型」和「自定义模型」两个区域；点击右侧「添加自定义模型」，在弹出的对话框里把「服务商」选为「自定义」。官方文档「模型设置」页的另一个入口：在对话框里点击当前模型，再点「+」添加自定义模型，会切换到设置 →「模型与API」。

在弹出的对话框里按下表填写：

字段	填写
服务商	`自定义`
模型ID	逐字等于 qcode.cc/models 在售的型号，例如 `gpt-6.1-sol`
API协议	`OpenAI`
Base URL	`https://api.qcode.cc/openai/v1`
API Key	你的 `cr_xxx`

可选型号示例：gpt-6.1-sol、gpt-6.1-terra、glm-5.3、deepseek-v4.1-flash、kimi-k3、qwen3.8-max。各模型单价见 https://qcode.cc/models。

Base URL 要不要带 `/v1`¶

要带，只到 /v1 为止。依据是官方博客的示例：Ollama 的 Base URL 填 http://localhost:11434/v1，博客称「这是Ollama提供的OpenAI兼容接口地址」，并说明 Ollama 的 /v1 路径提供 OpenAI 兼容接口。对应到 QCode 就是 https://api.qcode.cc/openai/v1，不要再加 /chat/completions。官方没有说明 AutoClaw 会在 Base URL 后拼接哪一段路径，所以最终以下一步「连通测试」的结果为准；亚洲网络不稳定时可把域名换成 asia.qcode.cc，路径不变。

连通测试与设为默认¶

填完后点「连通测试」。官方博客写明：系统会发起一次真实请求，状态显示「测试成功」说明配置正确。
点「添加」完成模型注册。
回到模型列表，找到刚添加的模型，点「设为默认」，AutoClaw 之后的任务就由它驱动。官方博客同时写明可以配置多个自定义模型，在不同任务间手动切换。

验证是否接通¶

「测试成功」之后，在对话框里选中这个模型发一句 ping。想在命令行先验证网络与密钥（空请求体返回 400 就是路径与密钥正常）：

KEY="cr_your_key"
curl -s -o /dev/null -w '%{http_code}\n' -X POST \
  https://api.qcode.cc/openai/v1/chat/completions \
  -H "Authorization: Bearer $KEY"
# 400 = 路径与密钥正常；401 = 密钥无效；404 = 路径前缀错

每次请求都会出现在 probe.qcode.cc，输入密钥即可看到实际请求的型号与返回码。

已知限制¶

模型需支持工具调用：官方博客写明 AutoClaw 的核心能力依赖工具调用（Tool Calling），所选模型必须支持 Function Calling，否则能对话但无法驱动 Skills，任务链会中断。
第三方模型独立运营：官方「模型设置」页提示，第三方自定义模型的可用性、稳定性与费用请关注该服务方的状态与账单；使用过程中可能持续触发模型调用，建议留意账户费用。QCode 的用量可在控制台与 probe.qcode.cc 查看。