---
title: "将 OpenWork 接入 XiuRouter"
description: "在 OpenWork 工作区添加 OpenCode-compatible provider，并通过设置界面保存 Key。"
image: "https://docs.xiu.ai/og.png"
---

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

# 将 OpenWork 接入 XiuRouter

OpenWork 使用 OpenCode 引擎读取自定义 provider，但配置保存在当前工作区。先写工作区配置，再重载工作区并在设置界面保存 API Key。

## 选择配置方式

- 首次配置：在工作区创建 `provider.xiurouter`。
- 替换已有：只合并 `provider.xiurouter`，保留其他 provider 和模型。
- 对话协助：不提供。工作区重载和凭据连接仍需在 OpenWork 中完成。

## 前置条件

- 已在 OpenWork 打开或新建目标工作区。
- 已创建一把 OpenWork 专用 XiuRouter API Key。
- 已从 XiuRouter 当前目录复制精确模型 ID。

## 添加工作区 provider

在当前工作区创建 `.config/opencode/opencode.json`。目录不存在时一并创建。已有文件时只合并 `provider.xiurouter`：

```json
{
  "$schema": "https://opencode.ai/config.json",
  "provider": {
"xiurouter": {
  "npm": "@ai-sdk/openai-compatible",
  "name": "XiuRouter",
  "options": {
    "baseURL": "https://router-api.xiu.ai/v1"
  },
  "models": {
    "YOUR_MODEL_ID": {
      "name": "YOUR_MODEL_ID"
    }
  }
}
  }
}
```

配置必须放在工作区内，不是全局 OpenCode 配置。文件中不写真实 Key。

## 重载并保存 Key

1. 关闭当前工作区，再重新打开。
2. 打开 **Settings → Cloud Providers**。
3. 找到 **XiuRouter** 并选择连接。
4. 粘贴 XiuRouter API Key。
5. 在模型选择器中选择 `YOUR_MODEL_ID`。

OpenWork 不会热加载 provider。改完配置但没有重载时，设置页和模型选择器不会出现 XiuRouter。

## 验证

1. 新建任务，让 OpenWork 只读取一个文件并总结。
2. 确认任务使用 `YOUR_MODEL_ID`。
3. 在 XiuRouter 控制台“检查实际请求”核对 Key、模型、`/v1/chat/completions` 和成功状态。
4. 只读任务通过后，再测试可撤销的文件修改。

## 常见失败

| 现象 | 处理 |
| --- | --- |
| 模型选择器没有 XiuRouter | 确认文件位于当前工作区的 `.config/opencode/opencode.json`，再彻底重载工作区 |
| 连接 provider 失败 | 回到 **Settings → Cloud Providers**，确认 Key 保存到了 XiuRouter |
| 请求格式不兼容 | 确认 `npm` 使用 `@ai-sdk/openai-compatible` |
| 其他工作区没有 XiuRouter | 这是工作区级配置；需要在对应工作区单独添加 |

## 回滚

从工作区配置删除 `provider.xiurouter`，重载工作区并切回原模型。确认新任务恢复原路由后，再撤销 OpenWork 专用 XiuRouter API Key。

## 来源与核对日期

本文以 XiuRouter 产品集成页当前 OpenWork 工作区配置、凭据入口和验证路径为准，核对日期为 2026-08-22。本轮未使用真实 Key 运行 OpenWork 计费任务。

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