🤖 HandClaw

<p align="center"> <img src="assets/logo.png" alt="HandClaw" width="500" /> </p> <p align="center"> <strong>One HandClaw — Many Projects</strong> </p> <p align="center"> You don't need many openclaws. You just need one to control all.<br/> (Slack, WhatsApp, Discord, Telegram, Feishu) </p>

💡 HandClaw connects directly to OpenCode, which offers generous free quota with high-performance free models (Minimax M2.5 or GLM 5).</p>

---

Install (Node ≥22)

npm install -g handclaw@latest
# or: pnpm add -g handclaw@latest

handclaw onboard --install-daemon

<p align="center"> <img src="assets/ExtraQuickStart.png" alt="Extra Quick Start" width="600" /> </p>

💡 Choose "Extra Quick Start" for a no-pain HandClaw installation. Note: You must install Claude Code / Codex / OpenCode yourself separately.

---

✨ What is handclaw?

Connect AI coding agents (Claude Code, Codex, OpenCode) to Slack, WhatsApp, Discord, Telegram, or Feishu. Each channel uses one CLI, different channels can use different ones.

<p align="center"> <img src="assets/overview.png" alt="Overview" width="800" /> </p>

• One workspace, multiple agents
• Multi-round conversations
• Switch agent by renaming channel

---

HandClaw: Remind you when work finished!

<p align="center"> <img src="assets/HandSlackNarrowPhone.png" alt="HandClaw on Phone" width="400" /> <img src="assets/watch.jpg" alt="HandClaw on Watch" width="200" /> </p>

• One workspace = Multiple agents
• Code from phone, even from your watch
• Walk away, let agents work

---

⚖️ HandClaw vs OpenClaw ACP

| Feature | HandClaw | OpenClaw ACP | |---------|----------|--------------| | Notify when task complete | ✅ Yes | ❌ No | | Switch plan/build mode | ✅ Yes (!code switch plan/build) | ❌ No | | Early stop code CLI | ✅ Yes (!stop) | ❌ No | | Project management via channels | ✅ Just rename channel | ❌ Need install acpx + complex config | | Support ACP | ✅ Easy (rename channel) | ❌ Complex (install acpx, configure) |

HandClaw advantages:

1. Notifies users when coding tasks are completed
2. Supports persistent plan/build mode switching
3. Can stop running code CLI early with !stop
4. Manages projects via channel naming — just rename the channel to switch agents
5. No need to install acpx or complex configuration — it just works

---

My Story

Me Previously — Stuck at Desk

<p align="center"> <img src="assets/busy.png" alt="Busy without handclaw" width="800" /> </p>

• Multiple monitors (5+ windows)
• Claude Code, Codex, OpenCode — all open at once
• Tethered to laptop, can't leave desk
• Every task needs me sitting in front of the computer

---

📖 How to Use

📱 Mobile-First Development

Work anywhere. From your phone, tablet, or any device with Slack. Your coding agents are always accessible.

⚡ Thinking Process

The thinking process is streamed to the user.

📂 One Channel = One Agent = One P...