claw-use-mihomo

Network proxy manager and health watchdog for mihomo. OpenClaw skill + npm CLI.

Features

• 📦 Install mihomo binary (auto-detect OS/arch)
• ⚙️ Configure from subscription URLs or protocol links (vmess/ss/trojan/vless)
• 🔍 Monitor proxy health with configurable endpoints
• 🔄 Auto-switch to best available node on failure
• 🛡️ Safe config writes — atomic write + YAML validation + backup
• 🖥️ Cross-platform Linux, macOS, Windows

Quick Start

# Install mihomo
npx mihomod install

# Configure from subscription
npx mihomod config "https://your-subscription-url"

# Or add individual nodes
npx mihomod add "vmess://..."

# Start mihomo
npx mihomod start

# Check status
npx mihomod status

# Start health watchdog
npx mihomod watch

Commands

| Command | Description | |---------|-------------| | install | Download and install mihomo binary | | config <url> | Generate config from subscription URL | | add <url> | Add a single proxy node | | start | Start mihomo service | | stop | Stop mihomo service | | status | Show proxy status | | nodes | List all proxy nodes | | switch [name] | Switch to specific or best node | | watch | Start health watchdog daemon |

Configuration

Auto-created at ~/.config/mihomod/config.json:

{
  "mihomo": {
    "api": "http://127.0.0.1:9090",
    "secret": "",
    "configPath": "~/.config/mihomo/config.yaml"
  },
  "watchdog": {
    "endpoints": [
      {"url": "https://www.gstatic.com/generate_204", "expect": 204}
    ],
    "checkInterval": 30,
    "failThreshold": 2,
    "cooldown": 60,
    "maxDelay": 3000,
    "nodePriority": ["US", "SG", "JP", "HK"]
  },
  "selector": "🚀节点选择"
}

Safety

• Atomic config writes: new config is written to a temp file, validated (YAML parse + structure check), then renamed into place. Old config is always backed up to .bak.
• All network calls have timeouts: API 5s, subscriptions 30s, binary downloads 120s.
• Subscription size capped at 10MB.
• Graceful shutdown: watchdog handles SIGTERM/SIGINT cleanly.

Agent-Friendly

All commands output JSON by default (human-readable when stdout is a TTY). Designed for AI agent automation.

As OpenClaw Skill

openclaw skills install claw-use/claw-use-mihomo

License

MIT