OpenClaw

1. 安装官方客户端

使用OpenClaw 官方客户端。本版 UniRoute 插件针对 OpenClaw 2026.9.8 验证；该客户端需要 Node.js 24.16.0 或更新的 24.x，或 26.1.0 及以上。

终端复制

1npm install -g openclaw@2026.9.8

2openclaw --version

如尚未完成客户端初始化，请按官方文档运行 openclaw onboard 并设置本地网关。UniRoute 插件负责模型认证，不替代 OpenClaw 的工作区、网关或聊天频道配置。

2. 安装 UniRoute 认证插件

下载本站发布的插件包并交给 OpenClaw 安装：

终端复制

1curl -fL https://uniroute.app/community/openclaw-uniroute-auth-0.1.2.tgz -o openclaw-uniroute-auth-0.1.2.tgz

2openclaw plugins install ./openclaw-uniroute-auth-0.1.2.tgz

Windows PowerShell 如使用系统 curl，请将第一条命令中的 curl 改成 curl.exe。安装完成后可删除下载的 .tgz 文件。

安装器会要求确认插件权限和供应商注册；预期为 uniroute 及下表中的四个 UniRoute 供应商。

插件源码见UniRoute 社区组件仓库。

3. 登录 UniRoute

先创建 API Key，执行：

终端复制

1openclaw models auth login --provider uniroute --method api-key

在终端的隐藏输入框填写 Key。插件查询您当前 API Key 可访问的模型目录，为相应协议保存认证和供应商配置。请勿将 Key 发到 AI 对话或放进命令参数。登录保留已有默认模型；目录查询失败时不会写入不完整的配置。

4. 选择模型

查看已经配置的 UniRoute 模型，例如 OpenAI Responses：

终端复制

1openclaw models list --all --refresh --provider uniroute-openai-responses

根据模型协议，供应商名称分别为：

将下例的 MODEL_ID 换为列表中的完整模型 ID；选择其他协议时同步更换供应商前缀：

终端复制

1openclaw models set uniroute-openai-responses/MODEL_ID

2openclaw models status

重启已运行的网关，使配置生效：

终端复制

1openclaw gateway restart

2openclaw tui

需要测试真实调用时，可自行发送简短消息并在控制台核对调用记录。模型请求会产生费用。OpenClaw 的心跳、定时任务和其他自动功能也可能发起模型调用，请按实际需要在官方客户端中设置。

使用配置 CLI

如只需要直接写入供应商配置，可以使用UniRoute 配置工具，不必安装认证插件：

终端复制

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup models

终端复制

1npx --yes --package=https://uniroute.app/community/uniroute-setup-0.1.2.tgz uniroute-setup configure openclaw --model MODEL_ID --dry-run

检查预览后去掉 --dry-run 执行。工具会保留其他设置，并在修改前备份文件。认证插件使用 OpenClaw 原生认证流程；直接配置工具适合由 Skill 协助配置或隔离测试。

接入消息渠道与控制界面

Telegram、飞书等频道，以及网页控制台，属于 OpenClaw 客户端功能。先完成 UniRoute 模型配置，再按Telegram 接入文档、飞书接入文档或网页控制界面文档单独配置。频道凭据与 UniRoute API Key 是不同的凭据。