ClawOrchestrate

在远端主机部署 Python HTTP 分发器，接收 JSON 任务消息后触发远端 OpenClaw agent 执行；另附广播脚本与 systemd 常驻服务安装脚本，可向多台主机批量下发任务，默认依赖 Tailscale 网络且不启用鉴权。

loop-capital

热度 44.11

最近更新 2026-05-18 11:46:04

分类：自动化依赖：代码执行 / 第三方 API / 读写文件应用场景：自动化脚本 / 工作流 / 任务管理 / API 集成

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add claworchestrate

Metadata

name: claworchestrate
description: Orchestrate AI agents across multiple machines. Dispatch tasks, monitor progress, and coordinate teams from a central gateway. Works over Tailscale, SSH, or any network.
metadata: {"openclaw":{"requires":{"bins":["python3"]}}}

ClawOrchestrate

Cross-machine AI agent orchestration for OpenClaw.

Dispatch tasks from one machine to agents running on another. Monitor progress. Coordinate teams.

What It Does

Send tasks to agents on remote machines via HTTP
Trigger local openclaw agent commands on remote hosts
Simple REST API — works with curl, any HTTP client
Tailscale-compatible (secure by default)

Quick Start

1. Install the dispatcher on remote machines (PC2, PC3, etc.)

# Copy dispatcher to remote machine
scp scripts/dispatcher.py user@remote-host:~/.openclaw/dispatcher.py

# Start the dispatcher
ssh user@remote-host "nohup python3 ~/.openclaw/dispatcher.py &"

2. Send tasks from your gateway machine (PC1)

# Dispatch to an agent
curl -X POST http://remote-ip:9876/dispatch \
  -H 'Content-Type: application/json' \
  -d '{"agent":"byondedu-ceo","message":"Read TASKS.md and start building."}'

# Check health
curl http://remote-ip:9876/health

3. Automate with scripts

# Dispatch to all teams
bash scripts/dispatch-all.sh "Daily standup — report progress."

Architecture

┌─────────────┐     HTTP POST      ┌─────────────┐
│   PC1       │ ─────────────────► │   PC2       │
│  (Gateway)  │                    │  (Remote)   │
│             │                    │             │
│  Che (CEO)  │    :9876/dispatch  │  ByondEdu   │
│  sends task │                    │  AgentSocial│
└─────────────┘                    └─────────────┘
                                          │
                                   dispatcher.py
                                          │
                                   openclaw agent
                                   --agent byondedu-ceo
                                   --message "..."

Setup as Systemd Service (Persistent)

On each remote machine:

cat > ~/.config/systemd/user/agent-dispatcher.service << 'EOF'
[Unit]
Description=ClawOrchestrate Agent Dispatcher
After=network.target

[Service]
Type=simple
ExecStart=/usr/bin/python3 /home/%u/.openclaw/dispatcher.py
Restart=always
RestartSec=5

[Install]
WantedBy=default.target
EOF

systemctl --user daemon-reload
systemctl --user enable agent-dispatcher
systemctl --user start agent-dispatcher

API Reference

Endpoint	Method	Body	Response
`/dispatch`	POST	`{"agent":"id","message":"text"}`	`{"status":"dispatched","agent":"id"}`
`/health`	GET	—	`{"status":"ok"}`

Security

Runs on Tailscale network only (not exposed to internet)
No authentication (Tailscale provides network-level auth)
Add API key auth for public deployments (see docs/SECURITY.md)

Files

scripts/dispatcher.py — The HTTP server (run on remote machines)
scripts/dispatch-all.sh — Broadcast script (run on gateway)
scripts/setup-service.sh — Systemd service installer
docs/ARCHITECTURE.md — Full architecture details
docs/SECURITY.md — Security hardening guide

License

MIT — Free for personal and commercial use. Premium features (dashboard, scheduler, analytics) available at claworchestrate.com.