local-openclaw-router_skill

This skill installs, updates, repairs, and verifies the OpenClaw Router plugin locally, ensuring health, CLI access, and accurate stats.

Python

2.5k

GitHub Stars

2

Bundled Files

2 months ago

Catalog Refreshed

3 months ago

First Indexed

Readme & install

Copy the install command, review bundled files from the catalogue, and read any extended description pulled from the listing source.

Installation

Preview and clipboard use veilstrat where the catalogue uses aiagentskills.

npx veilstrat add skill openclaw/skills --skill local-openclaw-router

_meta.json289 B
SKILL.md2.2 KB

Overview

This skill installs, updates, repairs, and verifies the openclaw-router plugin from its public GitHub repository into a local OpenClaw home (~/.openclaw). It automates syncing the plugin code, running tests, refreshing runtime state, restarting the gateway, and validating routing and stats outputs. Use it to ensure the router plugin is correctly installed and operational on your local OpenClaw instance.

How this skill works

The skill clones or updates https://github.com/xucheng/openclaw-router.git into ~/.openclaw/local-plugins/openclaw-router and synchronizes that code into ~/.openclaw/extensions/openclaw-router. It adjusts the OpenClaw configuration so the plugin is enabled and points installs to the local paths, runs the plugin test suite, refreshes runtime state, and restarts the local gateway. Finally it verifies health, CLI command availability, and the router stats script to confirm proper operation.

When to use it

Installing openclaw-router for the first time on a local OpenClaw setup
Updating the plugin to the latest public GitHub revision
Repairing a broken or partially-installed openclaw-router plugin
Validating routing functionality, CLI commands, and stats after changes
Migrating from legacy openclaw-main-router to openclaw-router

Best practices

Clone or update the repo directly into ~/.openclaw/local-plugins/openclaw-router rather than using embedded helper scripts
Remove legacy ~/.openclaw/extensions/openclaw-main-router and any stale openclaw-main-router entries in openclaw.json before syncing
Ensure openclaw.json has plugins.allow including openclaw-router and that installs/entries point to the local extension paths
Run the plugin test suite (node --test) inside the repo before restarting the gateway
If the gateway reports a brief 1006 close after restart, wait a few seconds and retry once

Example use cases

Set up a development machine to test custom routing changes locally
Recover a CI runner environment where the router plugin failed to load
Migrate and validate a host from openclaw-main-router to openclaw-router
Confirm openclaw router CLI commands and MEDIUM tier chain are present after an update
Automate a maintenance script that refreshes runtime state and verifies health

FAQ

Run curl -sS http://127.0.0.1:43111/health, openclaw router show medium, and ~/.openclaw/scripts/openclaw-router-stats.sh. Expect provider openclaw-router, the MEDIUM chain printed, and no errors from the stats script.

Does this publish code to any registry?

No. This skill installs the plugin from the public GitHub repository into your local OpenClaw directory; it does not publish code.