cn-api-router（CN API router 文档）

CN API Router — 国内 AI 模型 API 配置向导

一键配置国内大模型 API 到 OpenClaw。不用翻文档，不用猜配置格式。

支持的模型

Quick Start

查看支持的厂商

python <skill-dir>/scripts/setup_model.py --list

生成配置

python <skill-dir>/scripts/setup_model.py --provider deepseek --api-key sk-xxx

交互式向导

python <skill-dir>/scripts/setup_model.py --interactive

Agent 配置写入流程

脚本只生成配置，实际写入由 Agent 通过 OpenClaw 内置工具完成，这是最安全的方式。

步骤

1. 运行脚本获取 JSON 配置片段
2. 使用 gateway config.patch 将 provider 合并到现有配置
3. 重启生效

配置写入示例

Agent 拿到脚本输出后，执行：

gateway config.patch:
{
  "models": {
    "providers": {
      "deepseek": {
        "baseUrl": "https://api.deepseek.com/v1",
        "apiKey": "sk-xxx",
        "api": "openai-completions",
        "models": [
          {
            "id": "deepseek-chat",
            "name": "DeepSeek Chat",
            "reasoning": false,
            "input": ["text"],
            "contextWindow": 65536,
            "maxTokens": 8192
          }
        ]
      }
    }
  }
}

如果需要将某个 agent 切换到新模型：

gateway config.patch:
{
  "agents": {
    "defaults": {
      "model": {
        "primary": "deepseek/deepseek-chat"
      }
    }
  }
}

注意事项

• config.patch 是安全的深度合并，不会覆盖其他 provider
• API key 等敏感信息由 OpenClaw 加密存储
• 写入后会自动重启 gateway

使用场景

场景 1：首次配置国内模型

1. 引导用户获取 API key（附注册链接）
2. 运行脚本生成配置（--provider xxx --api-key xxx）
3. 用 config.patch 写入
4. 用 /model provider/model 验证

场景 2：添加备选模型

已有模型，想加备用：用脚本生成新 provider 配置，patch 追加即可。

场景 3：成本优化

用户说"API 太贵"时：

1. 查看 references/providers.md 对比价格
2. 推荐性价比方案
3. 配置多模型，日常用便宜的，复杂任务切贵的

Provider 详情

见 references/providers.md 获取：

• 每个厂商的完整模型列表和价格
• OpenClaw JSON 配置格式（models.providers 结构）
• 推荐组合方案（零成本 / 性价比 / 多模型）
• API Key 注册地址和免费额度

故障排查