RealmRouter Switch

Chat-first model switching for OpenClaw.
面向 OpenClaw 的对话式模型切换工具。

操作逻辑

1. 对话模式（推荐）

安装 skill 后，你只需要直接说：

• - “切换模型” → 我会列出可用模型，你回复编号或模型名
• “把 key 设为 xxx” → 我会验证并更新
• “测试连通性” → 我会检查当前配置是否正常
• “回滚到上一个备份” → 我会恢复最近的备份

重要：所有操作我都会自动帮你执行，包括重启 gateway。

2. 命令行模式

如果习惯命令行，可以用 rr 快捷命令：

• - rr show - 查看当前状态
• INLINECODE2 - 列出编号模型列表
• INLINECODE3 - 切换模型
• INLINECODE4 - 更新 API Key
• INLINECODE5 - 测试连通性
• INLINECODE6 - 回滚备份

安装指南

macOS / Linux 安装

步骤 1: 安装 skill

步骤 2: 安装 rr 快捷命令（可选但推荐）

步骤 3: 验证安装

rr show
# 或直接用 Python 脚本
python3 ~/.openclaw/workspace/skills/realmrouter-switch/scripts/realm_manager.py show

Windows 安装

步骤 1: 安装 skill

步骤 2: 安装 rr 快捷命令

步骤 3: 重启终端

步骤 4: 验证安装

rr show
# 或直接调用脚本
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.openclaw\workspace\skills\realmrouter-switch\scripts\realm_manager.ps1" show

命令详解

rr show

• - RealmRouter provider 是否存在
• 当前默认模型
• API Key（已掩码）

rr pick

rr switch

• - 编号: rr switch 3 （先用 rr pick 查看编号）
• 别名: rr switch gpt53 （内置别名见下方）
• 完整 ID: INLINECODE10

内置别名：

rr key

rr test

rr rollback

rr menu (Windows)

完整使用流程示例

macOS / Linux

Windows

# 1. 安装
npx clawhub install realmrouter-switch --force
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\.openclaw\workspace\skills\realmrouter-switch\scripts\install_rr.ps1"

# 2. 重启终端

# 3. 设置 Key
rr key sk-xxxxxxxxxxxxx

# 4. 查看可选模型
rr pick

# 5. 切换模型
rr switch 3
# 或
rr switch gpt53

# 6. 验证
rr test
rr show

特性总结

• - 安全: 修改前自动备份到 INLINECODE19
• 验证: Key 和模型都会验证可用性
• 便捷: 支持编号、别名、完整 ID 三种方式
• 跨平台: macOS / Linux / Windows 统一体验
• 对话优先: 直接告诉我你要做什么，我来执行

故障排除

rr: command not found

• - macOS/Linux: 确保 ~/.local/bin 在 PATH 中
• Windows: 确保已重启终端，且 %USERPROFILE%\bin 在 PATH 中

API key verification failed

• - 检查 Key 是否正确
• 检查网络是否能访问 INLINECODE24
• 使用 -Force 参数强制跳过验证

切换后模型没生效

• - 确保重启了 gateway: INLINECODE26
• 或在命令中加 -RestartGateway 参数