# Send RealmRouter Switch to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "realmrouter-switch",
    "name": "RealmRouter Switch",
    "source": "tencent",
    "type": "skill",
    "category": "开发工具",
    "sourceUrl": "https://clawhub.ai/vegetable1bird/realmrouter-switch",
    "canonicalUrl": "https://clawhub.ai/vegetable1bird/realmrouter-switch",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/realmrouter-switch",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=realmrouter-switch",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "scripts/install_rr.sh",
      "scripts/install_rr_win.py",
      "scripts/realm_manager.py",
      "scripts/rr.sh"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "realmrouter-switch",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T23:20:07.950Z",
      "expiresAt": "2026-05-14T23:20:07.950Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=realmrouter-switch",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=realmrouter-switch",
        "contentDisposition": "attachment; filename=\"realmrouter-switch-2.1.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "realmrouter-switch"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/realmrouter-switch"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/realmrouter-switch",
    "downloadUrl": "https://openagent3.xyz/downloads/realmrouter-switch",
    "agentUrl": "https://openagent3.xyz/skills/realmrouter-switch/agent",
    "manifestUrl": "https://openagent3.xyz/skills/realmrouter-switch/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/realmrouter-switch/agent.md"
  }
}
```
## Documentation

### RealmRouter Switch

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

### 1. 对话模式（推荐）

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

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

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

### 2. 命令行模式

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

rr show - 查看当前状态
rr pick - 列出编号模型列表
rr switch <model> - 切换模型
rr key <key> - 更新 API Key
rr test - 测试连通性
rr rollback - 回滚备份

### macOS / Linux 安装

步骤 1: 安装 skill

npx clawhub install realmrouter-switch --force

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

# 方式一：使用安装脚本
bash ~/.openclaw/workspace/skills/realmrouter-switch/scripts/install_rr.sh

# 方式二：手动添加到 PATH
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.zshrc  # 如果用 zsh
echo 'export PATH="$HOME/.local/bin:$PATH"' >> ~/.bashrc  # 如果用 bash
source ~/.zshrc  # 或 source ~/.bashrc

步骤 3: 验证安装

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

### Windows 安装

步骤 1: 安装 skill

npx clawhub install realmrouter-switch --force

步骤 2: 安装 rr 快捷命令

# 以管理员权限运行 PowerShell，然后执行：
powershell -ExecutionPolicy Bypass -File "$env:USERPROFILE\\.openclaw\\workspace\\skills\\realmrouter-switch\\scripts\\install_rr.ps1"

步骤 3: 重启终端

关闭当前 PowerShell 窗口，重新打开一个新的。

步骤 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

列出编号模型列表，方便选择：

[1] claude-opus-4-6-thinking
[2] claude-sonnet-4.6
[3] gpt-5.3-codex
[4] gpt-5.2-codex
[5] qwen3-max
...

### rr switch <model>

切换默认模型。支持三种格式：

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

内置别名：

别名实际模型opusclaude-opus-4-6-thinkingsonnetclaude-sonnet-4.6gpt53gpt-5.3-codexgpt52gpt-5.2-codexqwenqwen3-maxr1deepseek-ai/DeepSeek-R1geminigemini-3.1-pro-highglm5zai-org/GLM-5

### rr key <api-key>

更新 RealmRouter API Key，会自动验证有效性。

### rr test

测试当前配置的连通性，验证 Key 和模型是否可用。

### rr rollback

恢复最近的备份文件。

### rr menu (Windows)

进入交互菜单模式，适合不熟悉命令行的用户。

### macOS / Linux

# 1. 安装
npx clawhub install realmrouter-switch --force
bash ~/.openclaw/workspace/skills/realmrouter-switch/scripts/install_rr.sh

# 2. 设置 Key
rr key sk-xxxxxxxxxxxxx

# 3. 查看可选模型
rr pick

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

# 5. 验证
rr test
rr show

### 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

### 特性总结

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

### rr: command not found

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

### API key verification failed

检查 Key 是否正确
检查网络是否能访问 https://realmrouter.cn/v1
使用 -Force 参数强制跳过验证

### 切换后模型没生效

确保重启了 gateway: openclaw gateway restart
或在命令中加 -RestartGateway 参数
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: vegetable1bird
- Version: 2.1.0
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-05-07T23:20:07.950Z
- Expires at: 2026-05-14T23:20:07.950Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/realmrouter-switch)
- [Send to Agent page](https://openagent3.xyz/skills/realmrouter-switch/agent)
- [JSON manifest](https://openagent3.xyz/skills/realmrouter-switch/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/realmrouter-switch/agent.md)
- [Download page](https://openagent3.xyz/downloads/realmrouter-switch)