Skip to content

deciding/handclaw

Repository files navigation

🤖 handclaw

handclaw

One Slack = Multiple AI Coding Agents

Code anywhere. From anything. Anytime.


✨ What is handclaw?

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

#l0-claude-myapp
  |
  +-- "build a todo app"         --> Claude Code
  |     "add dark mode"          --> Claude Code  
  |     "looks good"             --> Claude Code

#l1-codex-backend  (different channel = different CLI)
  |
  +-- "optimize the API"        --> Codex

#l0-opencode-utils  (another channel)
  |
  +-- "write unit tests"       --> OpenCode
  • One Slack workspace, multiple agents
  • Multi-round conversations
  • Switch agent by renaming channel

My Story

Me Previously — Stuck at Desk

Busy without handclaw

  • 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

With handclaw — AFK Now

HandClaw Slack Phone

#l0-claude-myapp (start new project)
  |
  +-- "build a react login page"
        |
        +-- Claude Code: writes code
        +-- "looks good, add google auth"
              |
              +-- Claude Code: adds OAuth

#l1-codex-prod (different channel = different CLI)
  |
  +-- "deploy to production"
        |
        +-- Codex: handles deployment
  • One Slack = Multiple agents (different channels)
  • Code from phone while lying in bed
  • Multi-round conversations
  • Walk away from desk, let agents work

🎯 Features

📱 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.

🧠 Self-Evolution Skills

Add skills to your coding agents (Codex/OpenCode/Claude Code) for enhanced capabilities:

  • skills/project_workflow — Project workflow automation (build, test, deploy)

⚠️ Important: You must add skills to your coding agents manually. Each agent has its own skill loading mechanism.

📂 One Channel = One Agent = One Project

Each Slack channel = one project with built-in autonomous level control:

#l0-claude-repo1    → Level 0 (lowest, 80% need user agreement)
#l1-opencode-repo2  → Level 1 (moderate autonomy)
#l2-codex-prod      → Level 2 (high autonomy)
  • l0: 80% of actions need your approval
  • l1: 50% autonomous
  • l2: Fully autonomous (trust the agent)

🔀 Migration & Status

Just rename the channel to switch agent and autonomous level!

Channel Naming
Channel Naming
l0-claude-repo1
Migration
Migration
Rename to switch
Status
Status
`@BotApp status` to check
#l1-opencode-repo1 → #l0-claude-repo1

📊 Status Commands

  • !rate — Check autonomous level and your acceptance rate
  • @OpenClawApp status — Summarize all channels' progress

🔄 Plan ↔ Build Mode

  • !plan — One-time plan request
  • !build — One-time build request

📸 Demo

HandClaw Desktop Demo

Live Demo: [Add your demo URL here]


🛠️ Quick Start

# 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

Slack Configuration

Set these in your Slack config:

{
  "requireMention": false,
  "groupPolicy": "open",
  "streaming": "block"
}
  • requireMention: false — Respond to any message in the channel
  • groupPolicy: open — Allow any channel to use handclaw
  • streaming: block — Wait for complete response before sending

Requirements

  • Node.js 22+
  • pnpm
  • Slack workspace
  • Install your own coding agents: Claude Code, Codex, and/or OpenCode

⚠️ Note: You must install Claude Code, Codex, or OpenCode separately. handclaw connects to them but doesn't include them.


📖 Documentation


🤝 Contributing

PRs welcome! This is a fork of OpenClaw — the amazing whale project that makes all this possible.


📜 License

MIT


🐋 Built on OpenClaw

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


Try it now →

About

🔥 One Slack = Multiple AI Coding Agents 🔥 Code anywhere from anything. Connect Claude Code, Codex, and OpenCode to Slack. Work from your phone. Monitor agent progress. Switch agents by renaming channels.

Topics

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors

Languages