Radius

Radius 是 Earendil 为兼容 Pi 的客户端提供的模型网关。radius 插件将 OpenClaw 的代理循环连接到 Radius，包括流式响应、推理、受支持模型上的图像以及工具调用。Radius 负责上游路由、模型策略、重写和计费。

登录¶

在 Radius 网站 上创建 Radius 账户，然后从 OpenClaw 登录：

openclaw models auth login --provider radius --method oauth --set-default

OpenClaw 会显示配对码并打开 Radius 验证页面。输入该代码，选择你的组织，并授权访问。此设备流程也适用于远程 Gateway：在本地浏览器中打开显示的 URL。OpenClaw 会将 OAuth 凭据存储在其身份验证配置中，并自动刷新它们。单独登录 Pi 不会使 OpenClaw 登录。

你也可以在引导设置期间选择 Radius：

openclaw onboard --auth-choice radius

组织 API 密钥¶

在 Radius 中从你所在组织的 API keys 页面创建 API 密钥，然后使用交互式提示：

openclaw models auth login --provider radius --method api-key --set-default

对于无人值守设置，通过环境变量或密钥管理器提供 RADIUS_API_KEY，然后运行：

openclaw onboard --auth-choice radius-api-key

两种身份验证方法都使用所选组织的积分、预算和模型访问权限。过期或被吊销的 API 密钥需要替换；OAuth 刷新不会延长 API 密钥的有效期。

选择模型¶

openclaw models list --provider radius --refresh
openclaw models set radius/balanced

OpenClaw 会使用你的凭据从 Radius 发现目录。这包括组织模型、推理能力、上下文限制和定价层级。登录时如果可用，会推荐 radius/balanced，否则推荐你所在组织目录中的第一个模型。使用 models list 显示的模型 ID；可用模型和虚拟路由可能会变化。

Radius 在 https://radius.pi.dev/v1 使用其原生 Pi 消息协议。插件会自动选择该传输方式。不要将 Radius 配置为 OpenAI 兼容的 /chat/completions 端点。

范围和故障排查¶

此插件提供模型访问。Radius 的可选 Pi 扩展包，包括其 /radius 命令、网络搜索、artifacts 和 Google Workspace 工具，是独立的集成，不会由此插件安装。组织端的路由和重写策略仍然适用于模型请求。

如果登录过期，请重新开始并输入新的配对码。如果模型发现拒绝身份验证，请重新登录或替换组织 API 密钥。如果没有可用模型，请在 Radius 中检查组织的模型访问权限和预算。损坏或截断的响应会作为错误报告，而不是作为成功的空回复。

参见 Radius 文档、Radius 模型 和 模型身份验证。