openclaw/claw-use-mihomo

claw-use-mihomo

Manage mihomo proxy: install, configure from subscriptions, monitor health, auto-switch nodes.

When to use

• User asks to set up a proxy/VPN on their machine
• User provides a subscription URL, vmess://, ss://, trojan://, or vless:// link
• Proxy stops working and needs diagnosis/fix
• User wants to switch proxy nodes or check status

Prerequisites

• Node.js >= 18
• Network access to download mihomo binary

Setup

npx mihomod install

Commands

Install mihomo

npx mihomod install

Configure from subscription

npx mihomod config "https://example.com/subscribe?token=xxx"

Add single node

npx mihomod add "vmess://eyJ..."
npx mihomod add "ss://..."
npx mihomod add "trojan://..."
npx mihomod add "vless://..."

Start/stop mihomo

npx mihomod start
npx mihomod stop

Check status

npx mihomod status --json

Returns: {"running":true,"node":"...","delay":150,"alive":42,"total":50}

List nodes

npx mihomod nodes --json

Switch node

npx mihomod switch              # auto-select best
npx mihomod switch "node-name"  # specific node

Start watchdog

npx mihomod watch

Monitors endpoints, auto-switches on failure. Outputs JSON events to stdout.

Config

Located at ~/.config/mihomod/config.json. Created automatically on first run. Edit to set mihomo API URL, watchdog endpoints, node priorities, etc.

All output is JSON

All commands output structured JSON (human-readable on TTY). Exit codes: 0=success, 1=error, 2=config error, 3=network error.