将 OpenClaw 接入 XiuRouter

首次配置和替换已有都在 ~/.openclaw/openclaw.json 合并 XiuRouter provider。provider、默认模型和 agents.defaults.models 白名单必须一起配置。

选择配置方式

• 首次配置：设置启动进程的 API Key，再合并 provider、默认模型和白名单。
• 替换已有：保留原 provider，只更新 xiurouter 和默认模型。
• 对话协助：让有配置文件权限的 Agent 合并不含密钥的 JSON；环境变量、重启和新任务仍需手动完成。

前置条件

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

设置 API Key

在启动 OpenClaw 的环境中设置：

export XIUROUTER_API_KEY="YOUR_XIUROUTER_API_KEY"

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

合并 OpenClaw 配置

把 YOUR_MODEL_ID 换成精确模型 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"
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "xiurouter/YOUR_MODEL_ID"
      },
      "models": {
        "xiurouter/YOUR_MODEL_ID": {
          "alias": "XiuRouter"
        }
      }
    }
  }
}

把这段合并进现有文件，不要覆盖其他 provider 或 Agent 设置。api 必须是 openai-completions。只添加 provider 而不加白名单时，OpenClaw 会拒绝模型。

当前 Agent 有配置文件权限时，可以帮你合并这段不含密钥的 JSON。API Key 必须由启动 OpenClaw 的环境提供；修改后仍要重启并新建任务。

对话协助

先让启动 OpenClaw 的环境读取 XIUROUTER_API_KEY，再把下面消息发给有配置文件权限的 Agent：

保留 ~/.openclaw/openclaw.json 现有的所有 provider 和 Agent 设置，只添加 models.providers.xiurouter，Base URL 使用 https://router-api.xiu.ai/v1，协议使用 openai-completions，API Key 引用 ${XIUROUTER_API_KEY}，模型使用 YOUR_MODEL_ID。把 xiurouter/YOUR_MODEL_ID 同时设为默认模型并加入 agents.defaults.models 白名单。不要读取或写入真实 API Key。修改后展示 diff。

验证

重启 OpenClaw，再发起一个只读小任务，确认它使用 xiurouter/YOUR_MODEL_ID。最后在 XiuRouter 控制台“检查实际请求”核对模型、接口和成功状态。

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

常见失败

回滚

先把 agents.defaults.model.primary 改回原模型。确认新任务恢复原路由后，再删除 models.providers.xiurouter 并撤销测试 Key。

来源与核对日期

内容核对于 2026-08-31。OpenClaw 收到完整回复，并在 XiuRouter“检查实际请求”中出现对应模型、接口和成功状态后，基础接入才算完成。