# AutoClaw 接入

> **最后核实**：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」→「添加自定义模型」 |
| 官方资料 | [模型设置](https://autoclaw.zhipuai.cn/docs/advanced/models/) · [本地模型配置指南](https://autoclaw.zhipuai.cn/blog/news/autoclaw-local-model-setup-guide/) · [更新日志](https://autoclaw.zhipuai.cn/changelog/) |

官方文档中心对它的介绍是：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 接入](/docs/ide/lobsterai)、[Qoder 接入](/docs/ide/qoder)、[OpenClaw 接入](/docs/ide/openclaw)；终端里用 Claude Code，见 [安装教程](/docs/getting-started/installation)。协议与型号的完整对应见 [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths)。

## 安装

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

## 配置步骤

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

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

| 字段 | 填写 |
|---|---|
| 服务商 | `自定义` |
| 模型ID | 逐字等于 [qcode.cc/models](https://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`，路径不变。

### 连通测试与设为默认

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

## 验证是否接通

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

```bash
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](https://probe.qcode.cc)，输入密钥即可看到实际请求的型号与返回码。

## 已知限制

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

## 相关文档

- [接入点与 API 格式](/docs/getting-started/endpoints-and-api-paths) —— 协议对照与 Base URL 填法
- [工具兼容总览](/docs/ide/tool-compatibility) —— 各工具协议支持一览
- [有道龙虾 LobsterAI 接入](/docs/ide/lobsterai) —— 同样基于 OpenClaw，自定义模型支持 Anthropic 兼容
- [OpenClaw 接入](/docs/ide/openclaw) —— OpenClaw 框架本身的配置
- [国产模型接入](/docs/usage/cn-models) —— GLM / Kimi / DeepSeek / Qwen 的在售 ID
- [故障排查指南](/docs/reference/troubleshooting)