---
title: "将 OpenClaw 接入 XiuRouter"
description: "在 OpenClaw 中添加 XiuRouter OpenAI Chat Completions provider 并选择精确模型。"
image: "https://docs.xiu.ai/og.png"
---

> XiuAI 文档索引
> 完整文档索引：https://docs.xiu.ai/llms.txt
> 阅读前先通过索引确认当前可用页面。

# 将 OpenClaw 接入 XiuRouter

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

## 前置条件

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

## 设置 API Key

在启动 OpenClaw 的环境中设置：

```bash
export XIUROUTER_API_KEY="YOUR_XIUROUTER_API_KEY"
```

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

## 添加 provider

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

```json
{
  "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 是否被读取：

```bash
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 计费任务。

源文件：https://docs.xiu.ai/router/integrations/openclaw/index.mdx