← Back to Skills Marketplace
vegetable1bird

RealmRouter Switch

by Imba · GitHub ↗ · v2.1.0
darwinlinuxwin32 ⚠ suspicious
425
Downloads
0
Stars
0
Active Installs
9
Versions
Install in OpenClaw
/install realmrouter-switch
Description
Zero-friction RealmRouter model manager for OpenClaw. Chat-first workflow for setting API key, guided model picking, switching with availability check, rollb...
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install realmrouter-switch
  3. After installation, invoke the skill by name or use /realmrouter-switch
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Slug realmrouter-switch
Version 2.1.0
License
All-time Installs 0
Active Installs 0
Total Versions 9
Frequently Asked Questions

What is RealmRouter Switch?

Zero-friction RealmRouter model manager for OpenClaw. Chat-first workflow for setting API key, guided model picking, switching with availability check, rollb... It is an AI Agent Skill for Claude Code / OpenClaw, with 425 downloads so far.

How do I install RealmRouter Switch?

Run "/install realmrouter-switch" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is RealmRouter Switch free?

Yes, RealmRouter Switch is completely free (open-source). You can download, install and use it at no cost.

Which platforms does RealmRouter Switch support?

RealmRouter Switch is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux, win32).

Who created RealmRouter Switch?

It is built and maintained by Imba (@vegetable1bird); the current version is v2.1.0.

💬 Comments