不墨 Router

发布于 2026 年 10 月 26 日 星期一

OpenClaw 国内怎么用:接 DeepSeek / Kimi / GLM,一段配置和 8 个问答

OpenClaw 2026.10.7 接不墨 Router 实测:一段 openclaw.json 配国产模型,Key 走环境变量,附 Node 版本、模型前缀等 8 个常见问题。

OpenClaw 国内怎么用:接 DeepSeek / Kimi / GLM,一段配置和 8 个问答

OpenClaw 可以用一段配置接国内模型:在 openclaw.json 的 models.providers 里加一个 bumo 供应商,baseUrl 填 https://router.bumo.cc/v1,api 选 openai-completions,模型写成 bumo/deepseek/deepseek-flash。 本次实测版本 OpenClaw 2026.10.7,对话、工具调用、流式输出全部正常,过程中没有出现阻断性报错。

核验日期:2026-10-26。测试环境为 Linux x64,Node 24.22.1,模型 deepseek/deepseek-flash。

先准备:Node 版本和 Router Key

OpenClaw 对 Node 版本卡得比较死,官方要求 >=24.22.1 <25 || >=26.12.1。本机系统 Node 24.15.0 安装时报 EBADENGINE,换成 24.22.1 的独立 Node 才装上。先确认:

node --version   # 必须是 24.22.1 以上,或者 26.12.1 以上

然后登录 不墨 Router,在 API Key 页面创建一个 Key,并给钱包充值。下面所有配置只认这个 Key,不再需要 DeepSeek、Kimi 或智谱的官方 Key。

安装 OpenClaw

mkdir -p ~/openclaw-test && cd ~/openclaw-test
npm install openclaw@2026.10.7
./node_modules/.bin/openclaw --version
# OpenClaw 2026.10.7

如果只是想试,也可以装在临时目录里。本文为了不污染本机已有配置,启动时单独指定 state 和 config 目录。

一段配置接 Router

新建 openclaw.json:

{
  "agents": {
    "defaults": { "model": { "primary": "bumo/deepseek/deepseek-flash" } }
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bumo": {
        "baseUrl": "https://router.bumo.cc/v1",
        "apiKey": "${BUMO_ROUTER_KEY}",
        "api": "openai-completions",
        "models": [
          { "id": "deepseek/deepseek-flash", "name": "DeepSeek Flash" }
        ]
      }
    }
  }
}

几个字段的含义:

字段 填什么 说明
baseUrl https://router.bumo.cc/v1 OpenAI 兼容端点,停在 /v1
apiKey ${BUMO_ROUTER_KEY} 从环境变量读,不把 Key 写进文件
api openai-completions 走 /v1/chat/completions
models[].id deepseek/deepseek-flash Router 的完整模型 ID
agents.defaults.model.primary bumo/模型ID 前面要加供应商名 bumo/

Key 放环境变量:

export BUMO_ROUTER_KEY=sk-...   # 换成你的 Router Key
export OPENCLAW_STATE_DIR=~/openclaw-test/state
export OPENCLAW_CONFIG_PATH=~/openclaw-test/openclaw.json

${BUMO_ROUTER_KEY} 的环境变量替换已实测通过。把这几行写进 ~/.zshrc 可以长期生效,但不要把 Key 提交进任何仓库。

验证三项:对话、工具、流式

先校验配置,再发一条最小消息:

openclaw config validate
openclaw agent --local -m "Reply with exactly: READY"

输出 READY 就说明地址、Key、模型都对上了。再让它读一个本地文件,确认工具调用:

echo TOOLTOKEN-Oc9xQ2 > /tmp/openclaw-probe.txt
openclaw agent --local -m "Use the read tool to read /tmp/openclaw-probe.txt and reply with its content"

本次实测返回了 TOOLTOKEN-Oc9xQ2,和文件内容一致。流式则不需要额外开关:主对话请求体里带 "stream":true,Router 返回 200 和 SSE 的 chat.completion.chunk;在终端里也能直接看到回复逐字出现。

换成 Kimi / GLM 怎么填

把 models 里的条目换成 Router 公开列表里的完整 ID 即可,例如:

"models": [
  { "id": "deepseek/deepseek-flash", "name": "DeepSeek Flash" },
  { "id": "kimi/kimi-k2.6", "name": "Kimi K2.6" },
  { "id": "glm/glm-5.3-flash", "name": "GLM 5.3 Flash" }
]

再把 agents.defaults.model.primary 改成 bumo/kimi/kimi-k2.6 这类带供应商前缀的写法。模型 ID 不要自己缩写,大小写也要一致。本次只对 deepseek/deepseek-flash 做了完整的对话、工具、流式实测;其他模型能不能用工具、支不支持长上下文,以 Router 公开模型列表 返回的 capabilities 为准。核验日列表共 28 个模型,带 tools 的才能稳定跑 Agent 工具循环。

8 个常见问题

1. 一定要 Node 24.22.1 吗? 是。24.15 会报 EBADENGINE,装不上。用 node --version 确认,或给 OpenClaw 单独准备一个符合要求的 Node。

2. 为什么模型前面要加 bumo/? bumo 是你在 models.providers 里起的供应商名。只写 deepseek/deepseek-flash 时,OpenClaw 会当成内置供应商去找,找不到对应 Key 就失败。完整写法是 bumo/deepseek/deepseek-flash。

3. Key 能直接写进 openclaw.json 吗? 能,但不建议。配置里写 ${BUMO_ROUTER_KEY}、Key 放环境变量,文件就可以安全地同步或备份。

4. 报 401 / Invalid API key 先查什么? 先确认 BUMO_ROUTER_KEY 在当前 shell 里真的存在:echo $BUMO_ROUTER_KEY。再检查 Key 有没有多余空格,以及用的确实是 Router 的 Key,不是 DeepSeek 官方 Key。

5. 报 404 / model not found 怎么办? 模型 ID 必须和 Router 列表完全一致,包括前缀和大小写。先用 curl https://router.bumo.cc/v1/models 确认模型存在,再改配置。

6. 工具调用不执行、一直停在确认? 交互模式下 OpenClaw 会请求确认,这是正常行为。非交互或自动化场景要让它能自动执行工具;本次实测的 --local 对话和文件读取流程没有额外配置,若你的版本弹确认,按提示放行即可。

7. 回复没有逐字出现,是流式坏了吗? 先用主对话确认请求体里有 "stream":true、响应是 SSE。某些终端会把流式内容缓冲后一次性显示,看起来像没流式,实际请求已经通了。

8. 会不会改坏本机已有的 OpenClaw 配置? 只要单独设 OPENCLAW_STATE_DIR 和 OPENCLAW_CONFIG_PATH 就不会。本文的测试就是用独立目录跑的,没有动本机原有配置。

边界

本次只验证了最小对话、一次文件读取工具和流式输出,没有覆盖长上下文、图片输入、并行工具调用、断流重连和长时间 Agent 循环。OpenClaw 的配置字段可能随版本变化,升级后以实际报错和官方文档为准。实际费用按 Router 的模型报价和用量计算,Agent 会反复调用模型,长任务建议先看用量。

前往不墨 Router 获取 Key。OpenClaw 这边记住三点:Node 版本达标、api 选 openai-completions、模型前面加 bumo/。

继续阅读