CommanderClaw

Multi-device Agent Coordination Framework - CLI and OpenClaw/QClaw Plugin.

Installation

npm install -g commanderclaw

Usage

CLI Commands

# Start gateway (server + web console)
commanderclaw gateway start

# Check gateway status
commanderclaw gateway status

# Stop gateway
commanderclaw gateway stop

# Install plugin to QClaw
commanderclaw plugin install qclaw

# Install plugin to OpenClaw
commanderclaw plugin install openclaw

# Check plugin status
commanderclaw plugin status

# Configure server URL and token
commanderclaw config

Gateway Ports

| Service | Port | |---------|------| | Server | 19739 | | WebSocket | ws://127.0.0.1:19739/ws | | Web Console | 19730 |

Supported Platforms

| Platform | Architecture | |----------|--------------| | macOS | x64 (Intel) | | macOS | arm64 (Apple Silicon) | | Linux | x64 | | Windows | x64 |

Development

Build

npm install
npm run build

Pre-Release Verification

Before publishing, verify the package works correctly:

# 1. Create tarball
npm pack

# 2. Test in clean environment
mkdir /tmp/test-release && cd /tmp/test-release
npm init -y
npm install /path/to/commanderclaw-*.tgz

# 3. Verify gateway works
npx commanderclaw gateway start

# 4. Open http://127.0.0.1:19730 and verify:
#    - WebSocket connection succeeds (check browser console)
#    - API calls work (check Network tab)

# 5. If all tests pass, publish
npm publish --access public

Release Checklist

• [ ] Update version in package.json and src/cli/index.ts
• [ ] Run npm run build
• [ ] Run npm pack and test in clean environment
• [ ] Verify WebSocket and API proxy work
• [ ] Commit and push version bump
• [ ] Run npm publish --access public

License

MIT