Cn Api Router

开发编程需配置 API Key

国内 AI 模型 API 配置向导。帮助 OpenClaw 用户快速配置 DeepSeek、通义千问、智谱GLM、 Moonshot（月之暗面）、百川、零一万物等国内大模型 API。自动生成 OpenClaw 配置并通过 config.patch 安全写入，支持模型切换和多模型并存。 Use when: 用户说...

脚本工具

560

下载量

安装量

收藏量

★ 5.0

综合评分ⓘ

概述

更多信息

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

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

支持的模型#

厂商模型价格参考（每百万 token）特点DeepSeekdeepseek-chat, deepseek-reasoner¥1-2 / ¥8-16性价比之王通义千问qwen-turbo, qwen-plus, qwen-max¥0.3-60中文理解好智谱 GLMglm-4-flash（免费）, glm-4-plus¥0-50有免费模型Moonshotmoonshot-v1-8k/32k/128k¥12-60长上下文百川Baichuan3-Turbo, Baichuan4¥0.5-100中文创作零一万物yi-medium, yi-large¥0.5-20性价比高

Quick Start#

查看支持的厂商#

bash

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

生成配置#

bash

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

交互式向导#

bash

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

Agent 配置写入流程#

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

步骤#

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

配置写入示例#

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

text

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 切换到新模型：

text

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

注意事项#

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

使用场景#

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

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

场景 2：添加备选模型#

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

场景 3：成本优化#

用户说"API 太贵"时：

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

Provider 详情#

见 references/providers.md 获取：

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

故障排查#

问题原因解决方案401 UnauthorizedAPI key 错误或过期检查 key，到平台重新生成429 Rate Limit请求频率过高或余额不足检查账户余额，降低频率Connection timeout网络问题检查网络，部分厂商需实名认证Model not found模型名错误对照 references/providers.md 检查配置后不生效需要重启config.patch 会自动重启，或手动 /restart输出质量差模型选择不当换更大的模型（如 qwen-max）费用超预期长对话 token 累积启用 compaction，或换便宜模型