← 返回 Skills 市场
vegetable1bird

RealmRouter Switch

作者 Imba · GitHub ↗ · v2.1.0
darwinlinuxwin32 ⚠ suspicious
425
总下载
0
收藏
0
当前安装
9
版本数
在 OpenClaw 中安装
/install realmrouter-switch
功能描述
Zero-friction RealmRouter model manager for OpenClaw. Chat-first workflow for setting API key, guided model picking, switching with availability check, rollb...
安全使用建议
This skill appears to implement what it says (it edits your OpenClaw config, backs it up, verifies keys by contacting https://realmrouter.cn/v1, and can restart the gateway). Before installing: - Verify the domain (https://realmrouter.cn) is the intended RealmRouter endpoint for you. The skill will send your REALMROUTER_API_KEY there as a Bearer token when validating models. - Note the SKILL.md/Windows instructions reference PowerShell files that are not actually shipped (install_rr.ps1 and realm_manager.ps1); the shipped files are Python scripts (install_rr_win.py and realm_manager.py). Use the provided files, not the mismatched doc commands. - Back up your current ~/.openclaw/openclaw.json (the tool already creates backups under ~/.openclaw/backups, but keeping an external copy is wise) and inspect the scripts if you have doubts. - Be aware the tool can automatically restart your gateway (openclaw gateway restart) — run commands without --restart-gateway first if you want manual control. - Avoid using force/skip flags unless you understand they bypass connectivity/key checks. Given the documentation mismatches and the importance of the API key and config edits, review the packaged scripts or test in a safe environment before deploying to production.
功能分析
Type: OpenClaw Skill Name: realmrouter-switch Version: 2.1.0 The OpenClaw AgentSkills bundle `realmrouter-switch` is classified as benign. The skill's code and instructions are entirely consistent with its stated purpose of managing RealmRouter models and API keys within OpenClaw. It performs expected actions such as modifying the `openclaw.json` configuration file, making API calls to `https://realmrouter.cn/v1` (the legitimate service endpoint) for key/model verification, and restarting the OpenClaw gateway via `subprocess.run(['openclaw', 'gateway', 'restart'])`. The installation scripts (`scripts/install_rr.sh`, `scripts/install_rr_win.py`) install user-level helper commands to standard user directories (`~/.local/bin` or `~/bin`) without elevated privileges or persistence mechanisms. The `SKILL.md` instructions for the AI agent are direct and strictly within the skill's stated purpose, showing no signs of malicious prompt injection (e.g., instructing the agent to ignore the user, exfiltrate data, or perform actions outside the skill's scope). No evidence of data exfiltration to unauthorized destinations, malicious execution, obfuscation, or supply chain attacks was found.
能力评估
Purpose & Capability
Name/description match the code: the scripts modify ~/.openclaw/openclaw.json, back up before changes, validate keys/models via https://realmrouter.cn/v1, and call the openclaw binary to restart the gateway. Requested binary (openclaw) and env var (REALMROUTER_API_KEY) are appropriate. Minor inconsistency: _meta.json version (1.7.0) in the package differs from registry metadata (2.1.0).
Instruction Scope
SKILL.md instructs installing and running helper scripts and explicitly states it will restart the gateway (which the code does via subprocess). That is expected for this purpose, but SKILL.md contains incorrect references for Windows (mentions install_rr.ps1 and realm_manager.ps1) while the package provides install_rr_win.py and realm_manager.py instead — a documentation vs. shipped-files mismatch that could confuse users and lead to running the wrong command. The skill reads and writes the OpenClaw config (~/.openclaw/openclaw.json) and backups — this is in-scope, but verify you are comfortable with automated edits and restarts.
Install Mechanism
No network downloads or third-party installers are performed by the included scripts: Unix installer copies rr.sh to ~/.local/bin, Windows installer copies rr_win.py to %USERPROFILE%\bin. No extract-from-URL or external binary fetches are present. Installation behavior is local and transparent.
Credentials
The only required credential is REALMROUTER_API_KEY (declared as primary). The code uses that key to call realmrouter.cn and to write the key into the OpenClaw config; no other unrelated secrets or environment variables are requested. This is proportionate to the stated goal.
Persistence & Privilege
always is false and the skill only modifies its own OpenClaw config files under ~/.openclaw and creates backups there. It does call 'openclaw gateway restart' to apply changes, which is expected for a provider switcher but you should be prepared for gateway restarts initiated by the tool.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install realmrouter-switch
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /realmrouter-switch 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v2.1.0
v2.1.0: Add comprehensive installation guide for macOS/Linux/Windows, detailed command reference, usage examples, troubleshooting section.
v2.0.0
v2.0.0: Complete rewrite with self-contained PowerShell script for Windows (no Python needed), unified rr command interface, model picker with aliases, key/model verification, rollback support, chat-first workflow.
v1.8.0
v1.8.0: robust Windows support without PowerShell dependency (rr_win.py/install_rr_win.py), include cross-platform rr wrappers, keep key/model verification flow.
v1.7.1
v1.7.1: fix Windows package completeness by including rr.ps1 and install_rr.ps1, plus robust PowerShell installer checks.
v1.7.0
v1.7.0: add Windows support with rr.ps1 + install_rr.ps1, keep chat-first/key-model verification flow, docs updated.
v1.6.1
v1.6.1: key usability verification on set-key/install, model availability verification before switch by default, force/skip controls, docs updated.
v1.6.0
v1.6.0: guided model picker, aliases, precheck+force switch, rollback, shorter rr aliases, bilingual listing refresh.
v1.5.1
Bilingual listing update (EN+中文), clearer chat-first UX and model-switch guidance.
v1.5.0
- Added full Chinese usage guide and interaction protocol for conversational model switching. - Described recommended conversational flows when users do not specify a model, including prioritized model list and confirmation steps. - Updated documentation to list and explain all `rr` short commands and installation. - Included fallback to full Python script commands for advanced usage. - Listed key features such as auto-backup, gateway restart, model id flexibility, and environment variable support. - Version bumped to 1.5.0.
元数据
Slug realmrouter-switch
版本 2.1.0
许可证
累计安装 0
当前安装数 0
历史版本数 9
常见问题

RealmRouter Switch 是什么?

Zero-friction RealmRouter model manager for OpenClaw. Chat-first workflow for setting API key, guided model picking, switching with availability check, rollb... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 425 次。

如何安装 RealmRouter Switch?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install realmrouter-switch」即可一键安装,无需额外配置。

RealmRouter Switch 是免费的吗?

是的,RealmRouter Switch 完全免费(开源免费),可自由下载、安装和使用。

RealmRouter Switch 支持哪些平台?

RealmRouter Switch 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin, linux, win32)。

谁开发了 RealmRouter Switch?

由 Imba(@vegetable1bird)开发并维护,当前版本 v2.1.0。

💬 留言讨论