快速找到所需文档，高效完成接入与排障

2.1 安装

OpenClaw 当前支持 Node.js 22.22.3+、24.15+ 或 25.9+，推荐使用 Node.js 26；Node.js 23 不受支持。先检查版本：

node --version

macOS 或 Linux 建议使用官方安装脚本：

curl -fsSL https://openclaw.ai/install.sh | bash

也可以通过 npm 安装。npm 11.16+ 或 npm 12 使用：

npm install -g openclaw@latest --allow-scripts=openclawopenclaw onboard --install-daemon

npm 11.15 及更早版本可使用 npm install -g openclaw@latest，随后同样执行 onboarding。

Windows PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

验证安装：

openclaw --version

2.2 配置

配置文件位于 ~/.openclaw/openclaw.json。已有渠道、Skill 或网关配置时，只合并 models 和 agents.defaults，不要全量覆盖文件。

U-Router 的 OpenAI 兼容端点为 POST /api/llm/v1/chat/completions，Base URL 为 https://ai.umeng.com/api/llm/v1，鉴权方式 Authorization: Bearer。可使用以下模板：

{
  "models": {
    "mode": "merge",
    "providers": {
      "umeng-u-router": {
        "baseUrl": "https://ai.umeng.com/api/llm/v1",
        "apiKey": "<YOUR_U_ROUTER_API_KEY>",
        "api": "openai-completions",
        "models": [
          {
            "id": "auto",
            "name": "U-Router Auto",
            "reasoning": false,
            "input": ["text"]
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "umeng-u-router/auto"
      },
      "models": {
        "umeng-u-router/auto": {}
      }
    }
  },
  "gateway": {
    "mode": "local",
    "auth": {
      "mode": "none"
    }
  }
}

auth.mode: none 只适用于单机本地使用。共享或远程访问时，必须改为 token 或 password 鉴权；可先生成网关 token：

openclaw doctor --generate-gateway-token

具体鉴权配置以当前 OpenClaw 安全文档为准，openclaw doctor --fix 不等同于自动开启网关鉴权。

如需固定文本模型，必须先确认 U-Router 允许第三方客户端调用对应 <MODEL_ID>，再同时替换 models[].id、agents.defaults.model.primary 和 agents.defaults.models 中的 auto。

2.3 生效与验证

openclaw gateway restartopenclaw tui

进入终端界面后执行 /model，确认存在 umeng-u-router/auto，再发送一条测试消息。

如果 OpenClaw 调用仍返回 404，应核对 baseUrl 与客户端自动追加的路径，确保最终请求命中官网已公开的 /api/llm/v1/chat/completions；不要重复拼接 /v1 或 /chat/completions。