将 OpenClaw 接入 XiuRouter | XiuAI 文档中心

在 OpenClaw 中添加 XiuRouter OpenAI Chat Completions provider 并选择精确模型。

OpenClaw 应把 XiuRouter 配成自定义 openai-completions provider。密钥从环境变量读取，模型 ID 在 provider 中显式列出。

前置条件

OpenClaw 已能读取当前配置。
已创建一把 OpenClaw 专用 XiuRouter API Key。
已从 XiuRouter 当前目录复制模型 ID。

设置 API Key

在启动 OpenClaw 的环境中设置：

export XIUROUTER_API_KEY="YOUR_XIUROUTER_API_KEY"

不要把真实 Key 直接写进共享配置。OpenClaw 若由服务管理器启动，要把变量放在该进程实际读取的安全环境中，不要只在另一个终端导出。

添加 provider

把下面内容合并到 OpenClaw 当前配置。将 YOUR_MODEL_ID 换成精确模型 ID：

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "xiurouter/YOUR_MODEL_ID"
      }
    }
  },
  "models": {
    "providers": {
      "xiurouter": {
        "baseUrl": "https://router-api.xiu.ai/v1",
        "apiKey": "${XIUROUTER_API_KEY}",
        "api": "openai-completions",
        "models": [
          {
            "id": "YOUR_MODEL_ID",
            "name": "YOUR_MODEL_ID via XiuRouter"
          }
        ]
      }
    }
  }
}

api 保持 openai-completions。需要更多模型时，在 models 数组中逐项添加，不要写一个无法解析的通配符。

验证

先检查 provider 是否被读取：

openclaw models status

再发起一个只读小任务，确认它使用 xiurouter/YOUR_MODEL_ID。最后在 XiuRouter“使用记录”核对模型、状态和费用。

工具调用、图片输入、上下文和输出上限由具体模型决定。只有普通文本回复成功时，不要给模型补写未验证的能力元数据。

常见失败

现象	处理
provider 未出现	检查 JSON 合并位置和 OpenClaw 实际读取的配置文件
`401`	确认启动 OpenClaw 的进程能读取 `XIUROUTER_API_KEY`
模型找不到	保持 `provider/model` 格式，并在 provider 的 `models` 中加入同一 ID
普通回复成功但工具失败	换用已验证工具调用的模型，或回到原 provider

回滚

把 agents.defaults.model.primary 改回原模型，再删除 models.providers.xiurouter。确认 OpenClaw 重载配置后，撤销测试 Key。

来源与核对日期

本文按 OpenClaw 官方自定义 provider 配置和 XiuRouter 当前 Chat Completions 入口核对，日期为 2026-08-19。本轮未运行真实 OpenClaw 计费任务。