by deciding
:fire: One Slack = Multiple AI Coding Agents :fire: Code anywhere from anything. Connect Claude Code, Codex, and OpenCode to Slack. Work from your phone. Monitor agent progress. Switch agents by renaming channels.
# Add to your Claude Code skills
git clone https://github.com/deciding/handclaw💡 HandClaw connects directly to OpenCode, which offers generous free quota with high-performance free models (Minimax M2.5 or GLM 5).
npm install -g handclaw@latest
# or: pnpm add -g handclaw@latest
handclaw onboard --install-daemon
💡 Choose "Extra Quick Start" for a no-pain HandClaw installation. Note: You must install Claude Code / Codex / OpenCode yourself separately.
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.
| 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) |
No comments yet. Be the first to share your thoughts!
HandClaw advantages:
!stopWork anywhere. From your phone, tablet, or any device with Slack. Your coding agents are always accessible.
The thinking process is streamed to the user.
Pattern: #l0-agent-repo_name (prefix l0/l1/l2 is optional)
l0/l1/l2 — Autonomous level prefix (optional)agent — Coding agent: claude, codex, opencoderepo_name — Your project repository name#l0-claude-myapp → Level 0 (80% need user agreement)
#l1-opencode-api → Level 1 (moderate autonomy)
#l2-codex-prod → Level 2 (fully autonomous)
#claude-myapp → (no prefix, default)
Important Commands:
!code <repo> — Set working repository (searches $WORKSPACE/repo_name, use if channel name doesn't follow pattern)!code switch plan — Persistently change to plan mode!code switch build — Persistently change to build mode!code model <model> — Persistently change the model!plan — One-time plan request!build — One-time build request!stop — Stop the running code CLI immediatelyJust rename the channel to switch agent and autonomous level!
#l1-opencode-repo1 → #l0-claude-repo1
!rate — Check autonomous level and your acceptance rate@OpenClawApp status — Summarize all channels' progress!plan — One-time plan request!build — One-time build requestLive Demo: [Add your demo URL here]
# Clone and install dependencies
git clone https://github.com/deciding/handclaw.git
cd handclaw
git submodule update --init --recursive
cd openclaw
# Install and build
pnpm install
pnpm ui:build
pnpm build
# Set up Slack connection and install daemon
pnpm handclaw onboard --install-daemon
See SLACK_INSTALL.md for setup instructions.
Set these in your Slack config:
{
"requireMention": false,
"groupPolicy": "open",
"streaming": "block"
}
requireMention: false — Respond to any message in the channelgroupPolicy: open — Allow any channel to use handclawstreaming: block — Wait for complete response before sending{
"groups": {
"120363407410666666@g.us": { // group ID (use handclaw logs --follow, send a message in group to get)
"requireMention": false
}
},
"groupPolicy": "allowlist",
"groupAllowFrom": ["phone-number"]
}
{
"enabled": true,
"dmPolicy": "pairing",
"botToken": "YOUR_BOT_TOKEN",
"groups": {
"-5128902136": { // group ID
"requireMention": false,
"enabled": true
}
},
"groupAllowFrom": [],
"groupPolicy": "allowlist",
"streaming": "block"
}
{
"enabled": true,
"token": "YOUR_DISCORD_TOKEN",
"groupPolicy": "open",
"streaming": "off",
"guilds": {
"1480825735710118119": { // guild ID
"channels": {
"*": { // channel ID
"requireMention": false
}
}
}
}
}
https://discord.com/channels/{guild_id}/{channel_id}⚠️ Note: You must install Claude Code, Codex, or OpenCode separately. handclaw connects to them but doesn't include them.
| Platform | Link | |----------|------| | Discord | Join Discord | | WeChat | |
PRs welcome! This is a fork of OpenClaw — the amazing whale project that makes all this possible.
MIT
handclaw is a personal fork of OpenClaw — the open-source personal AI assistant framework. OpenClaw connects to 15+ messaging channels and supports multiple AI providers.
Check out the main project: github.com/openclaw/openclaw