openclaw集成文档
如何在 OpenClaw 中接入 CCAPI
OpenClaw 是一款开源的个人 AI 助手，支持 WhatsApp、Telegram、Slack、Discord 等多平台消息接入，可以执行文件管理、代码编写、网页浏览等真实任务。
前提条件
第一步：获取 CCAPI 令牌
第二步：选择模型
| 供应商 | CCAPI 售价 | 说明 |
|---|---|---|
| OpenAI | 低至官方 1 折 | GPT-4o、GPT-5 系列等 |
| 低至官方 2 折 | Gemini 2.5 Flash/Pro 等 | |
| Anthropic | 低至官方 2 折 | Claude Sonnet/Opus 等 |
| DeepSeek | 官方 85 折 | DeepSeek V3.2 等 |
| MiniMax | 官方 85 折 | MiniMax M2.5 等 |
| 智谱 | 官方 85 折 | GLM-5 等 |
完整模型列表和实时价格请查看 模型广场，
经济型（最佳性价比）
| 模型 | 供应商 | 上下文 | 说明 |
|---|---|---|---|
gpt-5-nano | OpenAI | 1M | 超低成本，适合简单任务 |
gemini-2.5-flash | 1M | 速度快、上下文大 | |
gpt-4o-mini | OpenAI | 128K | 均衡之选 |
deepseek-v3.2 | DeepSeek | 128K | 编程和推理能力强 |
minimax-m2.5 | MiniMax | 1M | 1M 上下文、编程能力突出 |
中端型（质量与成本兼顾）
| 模型 | 供应商 | 上下文 | 说明 |
|---|---|---|---|
gpt-5-mini | OpenAI | 1M | GPT-5 家族，快速可靠 |
glm-5 | 智谱 | 32K | 中文能力卓越 |
gemini-2.5-pro | 1M | Google 最强模型，多模态 |
旗舰型（最高质量）
| 模型 | 供应商 | 上下文 | 说明 |
|---|---|---|---|
gpt-4o | OpenAI | 128K | 多模态、质量稳定 |
claude-sonnet-4-5 | Anthropic | 200K | Anthropic 旗舰 |
gpt-4.1 | OpenAI | 1M | 1M 上下文 |
支持视觉的模型（截图分析等场景）
| 模型 | 供应商 | 说明 |
|---|---|---|
gemini-2.5-flash | 最便宜的视觉选项 | |
gpt-5-mini | OpenAI | 最佳视觉性价比 |
gpt-4o | OpenAI | 最强视觉质量 |
gemini-2.5-pro | Google 最强视觉 |
第三步：配置 OpenClaw
方式 A：环境变量（最简单）
~/.bashrc、~/.zshrc 或 OpenClaw 的 .env 文件中添加：| 变量 | 必填 | 说明 |
|---|---|---|
OPENCLAW_BASE_URL | 是 | 必须设为 https://api.ccapi.ai/v1 |
OPENCLAW_API_KEY | 是 | 你的 CCAPI 令牌 |
OPENCLAW_MODEL | 是 | 默认模型，如 deepseek-v3.2 |
OPENCLAW_FALLBACK_MODEL | 否 | 备选模型，主模型失败时自动切换 |
方式 B：配置文件（最灵活）
~/.openclaw/openclaw.json，适合需要多模型的场景：{
models: {
mode: "merge",
providers: {
ccapi: {
baseUrl: "https://api.ccapi.ai/v1",
apiKey: "${CCAPI_API_KEY}",
api: "openai-completions",
models: [
{
id: "deepseek-v3.2",
name: "DeepSeek V3.2",
reasoning: false,
input: ["text"],
contextWindow: 128000,
maxTokens: 32000,
},
{
id: "gpt-4o",
name: "GPT-4o",
reasoning: false,
input: ["text", "image"],
contextWindow: 128000,
maxTokens: 16384,
},
{
id: "gpt-5-mini",
name: "GPT-5 Mini",
reasoning: false,
input: ["text", "image"],
contextWindow: 1000000,
maxTokens: 32000,
},
{
id: "gemini-2.5-flash",
name: "Gemini 2.5 Flash",
reasoning: false,
input: ["text", "image"],
contextWindow: 1000000,
maxTokens: 65536,
},
{
id: "minimax-m2.5",
name: "MiniMax M2.5",
reasoning: false,
input: ["text"],
contextWindow: 1000000,
maxTokens: 32000,
},
{
id: "glm-5",
name: "GLM-5",
reasoning: false,
input: ["text"],
contextWindow: 32000,
maxTokens: 4096,
},
{
id: "claude-sonnet-4-5",
name: "Claude Sonnet 4.5",
reasoning: true,
input: ["text", "image"],
contextWindow: 200000,
maxTokens: 64000,
},
],
},
},
},
agents: {
defaults: {
model: {
primary: "ccapi/deepseek-v3.2",
},
},
},
}| 字段 | 说明 |
|---|---|
models.providers.ccapi | 将 CCAPI 注册为名为 "ccapi" 的自定义供应商 |
baseUrl | CCAPI 端点，固定为 https://api.ccapi.ai/v1 |
apiKey | 使用 "${CCAPI_API_KEY}" 引用环境变量（更安全），或直接填入令牌 |
api | 必须为 "openai-completions"，告诉 OpenClaw 使用 OpenAI 协议 |
models | 通过此供应商可用的模型列表，只有列出的模型才会出现在选择器中 |
agents.defaults.model.primary | 默认模型，格式为 供应商名/模型ID，如 ccapi/deepseek-v3.2 |
提示： mode: "merge"会与内置模型目录合并；mode: "replace"则完全替换。
方式 C：CLI 命令（快速设置）
第四步：验证
4.1 直接测试 API Key
choices[0].message.content 的 JSON 响应。4.2 测试流式输出
4.3 在 OpenClaw 中测试
2 + 2 等于多少？4.4 测试工具调用
列出当前目录的文件ls 并返回结果。CCAPI 的所有文本模型都支持 function calling。第五步：按场景优化
推荐配置
费用对比
| 供应商 | 官方直连 | 通过 CCAPI | 节省 |
|---|---|---|---|
| OpenAI | 官方价 | 低至 1 折 | 最高省 90%+ |
| Google Gemini | 官方价 | 低至 2 折 | 最高省 78% |
| Anthropic Claude | 官方价 | 低至 2 折 | 最高省 78% |
| DeepSeek | 官方价 | 85 折 | 省 15% |
常见问题
| 问题 | 原因 | 解决方案 |
|---|---|---|
无效的令牌 | 令牌错误或过期 | 去 控制台 > 令牌 检查状态 |
该令牌额度已用尽 | 账号余额为 0 | 去 控制台 > 充值 充值 |
模型不存在 | 模型名拼写错误 | 检查模型名拼写，在 模型广场 查看可用模型 |
| OpenClaw 仍然用 OpenAI | OPENCLAW_BASE_URL 未设置 | 确认 echo $OPENCLAW_BASE_URL 输出 https://api.ccapi.ai/v1 |
| 工具调用失败 | 模型不支持 function calling | CCAPI 所有文本模型都支持，检查模型名是否正确 |
| 流式输出 不工作 | 网络代理或防火墙阻断 SSE | 用 curl -N 测试，检查代理设置 |
| 响应慢 | 模型过载或网络延迟 | 试试 gemini-2.5-flash（速度最快） |
快速参考
https://api.ccapi.ai/v1Authorization: Bearer 你的CCAPI令牌POST /v1/chat/completions修改于 2026-03-16 08:42:16