{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/realmrouter-switch",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=realmrouter-switch",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "SKILL.md",
      "_meta.json",
      "scripts/install_rr.sh",
      "scripts/install_rr_win.py",
      "scripts/realm_manager.py",
      "scripts/rr.sh"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-05-07T17:22:31.273Z",
      "expiresAt": "2026-05-14T17:22:31.273Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=afrexai-annual-report",
        "contentDisposition": "attachment; filename=\"afrexai-annual-report-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/realmrouter-switch",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "RealmRouter Switch",
        "body": "Chat-first model switching for OpenClaw.\n面向 OpenClaw 的对话式模型切换工具。"
      },
      {
        "title": "1. 对话模式（推荐）",
        "body": "安装 skill 后，你只需要直接说：\n\n“切换模型” → 我会列出可用模型，你回复编号或模型名\n“把 key 设为 xxx” → 我会验证并更新\n“测试连通性” → 我会检查当前配置是否正常\n“回滚到上一个备份” → 我会恢复最近的备份\n\n重要：所有操作我都会自动帮你执行，包括重启 gateway。"
      },
      {
        "title": "2. 命令行模式",
        "body": "如果习惯命令行，可以用 rr 快捷命令：\n\nrr show - 查看当前状态\nrr pick - 列出编号模型列表\nrr switch <model> - 切换模型\nrr key <key> - 更新 API Key\nrr test - 测试连通性\nrr rollback - 回滚备份"
      },
      {
        "title": "macOS / Linux 安装",
        "body": "步骤 1: 安装 skill\n\nnpx clawhub install realmrouter-switch --force\n\n步骤 2: 安装 rr 快捷命令（可选但推荐）\n\n# 方式一：使用安装脚本\nbash ~/.openclaw/workspace/skills/realmrouter-switch/scripts/install_rr.sh\n\n# 方式二：手动添加到 PATH\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' >> ~/.zshrc  # 如果用 zsh\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' >> ~/.bashrc  # 如果用 bash\nsource ~/.zshrc  # 或 source ~/.bashrc\n\n步骤 3: 验证安装\n\nrr show\n# 或直接用 Python 脚本\npython3 ~/.openclaw/workspace/skills/realmrouter-switch/scripts/realm_manager.py show"
      },
      {
        "title": "Windows 安装",
        "body": "步骤 1: 安装 skill\n\nnpx clawhub install realmrouter-switch --force\n\n步骤 2: 安装 rr 快捷命令\n\n# 以管理员权限运行 PowerShell，然后执行：\npowershell -ExecutionPolicy Bypass -File \"$env:USERPROFILE\\.openclaw\\workspace\\skills\\realmrouter-switch\\scripts\\install_rr.ps1\"\n\n步骤 3: 重启终端\n\n关闭当前 PowerShell 窗口，重新打开一个新的。\n\n步骤 4: 验证安装\n\nrr show\n# 或直接调用脚本\npowershell -ExecutionPolicy Bypass -File \"$env:USERPROFILE\\.openclaw\\workspace\\skills\\realmrouter-switch\\scripts\\realm_manager.ps1\" show"
      },
      {
        "title": "rr show",
        "body": "显示当前配置状态：\n\nRealmRouter provider 是否存在\n当前默认模型\nAPI Key（已掩码）"
      },
      {
        "title": "rr pick",
        "body": "列出编号模型列表，方便选择：\n\n[1] claude-opus-4-6-thinking\n[2] claude-sonnet-4.6\n[3] gpt-5.3-codex\n[4] gpt-5.2-codex\n[5] qwen3-max\n..."
      },
      {
        "title": "rr switch <model>",
        "body": "切换默认模型。支持三种格式：\n\n编号: rr switch 3 （先用 rr pick 查看编号）\n别名: rr switch gpt53 （内置别名见下方）\n完整 ID: rr switch gpt-5.3-codex\n\n内置别名：\n\n别名实际模型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"
      },
      {
        "title": "rr key <api-key>",
        "body": "更新 RealmRouter API Key，会自动验证有效性。"
      },
      {
        "title": "rr test",
        "body": "测试当前配置的连通性，验证 Key 和模型是否可用。"
      },
      {
        "title": "rr rollback",
        "body": "恢复最近的备份文件。"
      },
      {
        "title": "rr menu (Windows)",
        "body": "进入交互菜单模式，适合不熟悉命令行的用户。"
      },
      {
        "title": "macOS / Linux",
        "body": "# 1. 安装\nnpx clawhub install realmrouter-switch --force\nbash ~/.openclaw/workspace/skills/realmrouter-switch/scripts/install_rr.sh\n\n# 2. 设置 Key\nrr key sk-xxxxxxxxxxxxx\n\n# 3. 查看可选模型\nrr pick\n\n# 4. 切换模型\nrr switch 3\n# 或\nrr switch gpt53\n\n# 5. 验证\nrr test\nrr show"
      },
      {
        "title": "Windows",
        "body": "# 1. 安装\nnpx clawhub install realmrouter-switch --force\npowershell -ExecutionPolicy Bypass -File \"$env:USERPROFILE\\.openclaw\\workspace\\skills\\realmrouter-switch\\scripts\\install_rr.ps1\"\n\n# 2. 重启终端\n\n# 3. 设置 Key\nrr key sk-xxxxxxxxxxxxx\n\n# 4. 查看可选模型\nrr pick\n\n# 5. 切换模型\nrr switch 3\n# 或\nrr switch gpt53\n\n# 6. 验证\nrr test\nrr show"
      },
      {
        "title": "特性总结",
        "body": "安全: 修改前自动备份到 ~/.openclaw/backups/\n验证: Key 和模型都会验证可用性\n便捷: 支持编号、别名、完整 ID 三种方式\n跨平台: macOS / Linux / Windows 统一体验\n对话优先: 直接告诉我你要做什么，我来执行"
      },
      {
        "title": "rr: command not found",
        "body": "macOS/Linux: 确保 ~/.local/bin 在 PATH 中\nWindows: 确保已重启终端，且 %USERPROFILE%\\bin 在 PATH 中"
      },
      {
        "title": "API key verification failed",
        "body": "检查 Key 是否正确\n检查网络是否能访问 https://realmrouter.cn/v1\n使用 -Force 参数强制跳过验证"
      },
      {
        "title": "切换后模型没生效",
        "body": "确保重启了 gateway: openclaw gateway restart\n或在命令中加 -RestartGateway 参数"
      }
    ],
    "body": "RealmRouter Switch\n\nChat-first model switching for OpenClaw.\n面向 OpenClaw 的对话式模型切换工具。\n\n操作逻辑\n1. 对话模式（推荐）\n\n安装 skill 后，你只需要直接说：\n\n“切换模型” → 我会列出可用模型，你回复编号或模型名\n“把 key 设为 xxx” → 我会验证并更新\n“测试连通性” → 我会检查当前配置是否正常\n“回滚到上一个备份” → 我会恢复最近的备份\n\n重要：所有操作我都会自动帮你执行，包括重启 gateway。\n\n2. 命令行模式\n\n如果习惯命令行，可以用 rr 快捷命令：\n\nrr show - 查看当前状态\nrr pick - 列出编号模型列表\nrr switch <model> - 切换模型\nrr key <key> - 更新 API Key\nrr test - 测试连通性\nrr rollback - 回滚备份\n安装指南\nmacOS / Linux 安装\n步骤 1: 安装 skill\nnpx clawhub install realmrouter-switch --force\n\n步骤 2: 安装 rr 快捷命令（可选但推荐）\n# 方式一：使用安装脚本\nbash ~/.openclaw/workspace/skills/realmrouter-switch/scripts/install_rr.sh\n\n# 方式二：手动添加到 PATH\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' >> ~/.zshrc  # 如果用 zsh\necho 'export PATH=\"$HOME/.local/bin:$PATH\"' >> ~/.bashrc  # 如果用 bash\nsource ~/.zshrc  # 或 source ~/.bashrc\n\n步骤 3: 验证安装\nrr show\n# 或直接用 Python 脚本\npython3 ~/.openclaw/workspace/skills/realmrouter-switch/scripts/realm_manager.py show\n\nWindows 安装\n步骤 1: 安装 skill\nnpx clawhub install realmrouter-switch --force\n\n步骤 2: 安装 rr 快捷命令\n# 以管理员权限运行 PowerShell，然后执行：\npowershell -ExecutionPolicy Bypass -File \"$env:USERPROFILE\\.openclaw\\workspace\\skills\\realmrouter-switch\\scripts\\install_rr.ps1\"\n\n步骤 3: 重启终端\n\n关闭当前 PowerShell 窗口，重新打开一个新的。\n\n步骤 4: 验证安装\nrr show\n# 或直接调用脚本\npowershell -ExecutionPolicy Bypass -File \"$env:USERPROFILE\\.openclaw\\workspace\\skills\\realmrouter-switch\\scripts\\realm_manager.ps1\" show\n\n命令详解\nrr show\n\n显示当前配置状态：\n\nRealmRouter provider 是否存在\n当前默认模型\nAPI Key（已掩码）\nrr pick\n\n列出编号模型列表，方便选择：\n\n[1] claude-opus-4-6-thinking\n[2] claude-sonnet-4.6\n[3] gpt-5.3-codex\n[4] gpt-5.2-codex\n[5] qwen3-max\n...\n\nrr switch <model>\n\n切换默认模型。支持三种格式：\n\n编号: rr switch 3 （先用 rr pick 查看编号）\n别名: rr switch gpt53 （内置别名见下方）\n完整 ID: rr switch gpt-5.3-codex\n\n内置别名：\n\n别名\t实际模型\nopus\tclaude-opus-4-6-thinking\nsonnet\tclaude-sonnet-4.6\ngpt53\tgpt-5.3-codex\ngpt52\tgpt-5.2-codex\nqwen\tqwen3-max\nr1\tdeepseek-ai/DeepSeek-R1\ngemini\tgemini-3.1-pro-high\nglm5\tzai-org/GLM-5\nrr key <api-key>\n\n更新 RealmRouter API Key，会自动验证有效性。\n\nrr test\n\n测试当前配置的连通性，验证 Key 和模型是否可用。\n\nrr rollback\n\n恢复最近的备份文件。\n\nrr menu (Windows)\n\n进入交互菜单模式，适合不熟悉命令行的用户。\n\n完整使用流程示例\nmacOS / Linux\n# 1. 安装\nnpx clawhub install realmrouter-switch --force\nbash ~/.openclaw/workspace/skills/realmrouter-switch/scripts/install_rr.sh\n\n# 2. 设置 Key\nrr key sk-xxxxxxxxxxxxx\n\n# 3. 查看可选模型\nrr pick\n\n# 4. 切换模型\nrr switch 3\n# 或\nrr switch gpt53\n\n# 5. 验证\nrr test\nrr show\n\nWindows\n# 1. 安装\nnpx clawhub install realmrouter-switch --force\npowershell -ExecutionPolicy Bypass -File \"$env:USERPROFILE\\.openclaw\\workspace\\skills\\realmrouter-switch\\scripts\\install_rr.ps1\"\n\n# 2. 重启终端\n\n# 3. 设置 Key\nrr key sk-xxxxxxxxxxxxx\n\n# 4. 查看可选模型\nrr pick\n\n# 5. 切换模型\nrr switch 3\n# 或\nrr switch gpt53\n\n# 6. 验证\nrr test\nrr show\n\n特性总结\n安全: 修改前自动备份到 ~/.openclaw/backups/\n验证: Key 和模型都会验证可用性\n便捷: 支持编号、别名、完整 ID 三种方式\n跨平台: macOS / Linux / Windows 统一体验\n对话优先: 直接告诉我你要做什么，我来执行\n故障排除\nrr: command not found\nmacOS/Linux: 确保 ~/.local/bin 在 PATH 中\nWindows: 确保已重启终端，且 %USERPROFILE%\\bin 在 PATH 中\nAPI key verification failed\n检查 Key 是否正确\n检查网络是否能访问 https://realmrouter.cn/v1\n使用 -Force 参数强制跳过验证\n切换后模型没生效\n确保重启了 gateway: openclaw gateway restart\n或在命令中加 -RestartGateway 参数"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/vegetable1bird/realmrouter-switch",
    "publisherUrl": "https://clawhub.ai/vegetable1bird/realmrouter-switch",
    "owner": "vegetable1bird",
    "version": "2.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}