$npx -y skills add EXboys/evotown --skill evotown-handoffQueue a cross-agent or cross-team handoff through the Evotown control plane.
| 1 | # Evotown handoff |
| 2 | |
| 3 | When a task should continue on another engine or team, **do not** message them in chat directly. Queue a handoff on Evotown. |
| 4 | |
| 5 | ## CLI (employee machine) |
| 6 | |
| 7 | ```bash |
| 8 | evotown-agent-setup.py handoff \ |
| 9 | --to-team finance \ |
| 10 | --title "Expense review" \ |
| 11 | --message "Please verify the summary and approve or reject." |
| 12 | ``` |
| 13 | |
| 14 | Or target a specific engine: |
| 15 | |
| 16 | ```bash |
| 17 | evotown-agent-setup.py handoff --to-engine hermes-bob --message "..." |
| 18 | ``` |
| 19 | |
| 20 | Requires `EVOTOWN_INGEST_TOKEN` and prior `register`. |
| 21 | |
| 22 | ## HTTP (from automation) |
| 23 | |
| 24 | ```http |
| 25 | POST {EVOTOWN_URL}/api/v1/jobs/from-engine |
| 26 | Authorization: Bearer {EVOTOWN_INGEST_TOKEN} |
| 27 | |
| 28 | { |
| 29 | "kind": "handoff", |
| 30 | "source_engine_id": "openclaw-alice", |
| 31 | "target_team_id": "finance", |
| 32 | "title": "Handoff", |
| 33 | "message": "..." |
| 34 | } |
| 35 | ``` |
| 36 | |
| 37 | The receiving machine's **Connector** will lease the job and trigger local OpenClaw/Hermes Gateway. |
| 38 | |
| 39 | Load the **evotown-dispatch-complete** skill when executing Evotown dispatch jobs. |
| 40 | |
| 41 | When **this** agent finishes the leased job, report completion (do not rely on hook HTTP alone): |
| 42 | |
| 43 | ```bash |
| 44 | evotown-agent-setup.py complete --job-id <job_id from task payload> --status succeeded --summary "..." |
| 45 | ``` |
| 46 | |
| 47 | Or POST `run.completed` to `/api/v1/events` with the same `run_id` as the dispatch job. |