clawbro 0.1.1

ClawBro AI runtime and CLI
Documentation

clawBro is a Rust-based system for making coding agent CLIs work together across local workflows, chat apps, and long-running team collaboration.

It stays close to the OpenClaw spirit, but pushes toward practical teamwork: Claude Code, Codex, Qwen, Qoder, Gemini, and related coding agents can be organized into solo, role-based, and lead-plus-specialist workflows, then connected to Lark, DingTalk, and WebSocket entrypoints.

📢 Project Status

  • [03-19] One clawbro surface now brings together multiple AI coding CLIs instead of forcing one tool per workflow.
  • [03-19] Team orchestration supports lead-driven workflows, specialist agents, milestone delivery, and named roles like planner, coder, reviewer, and researcher.
  • [03-19] Group and direct-message usage now fit the same routing model, with Lark, DingTalk, and WebSocket entrypoints.
  • [03-19] Operational controls include approvals, allowlists, memory-aware sessions, /health, /status, /doctor, and diagnostics surfaces.

clawBro is built for engineering, research, and workflow experimentation. It is meant for real agent collaboration, not just another chat wrapper.

Key Features of clawBro:

🏛️ Unified Control Plane: One clawbro entrypoint for setup, routing, session management, diagnostics, and runtime dispatch.

🤖 Unified Coding Agents: Bring Claude, Codex, Qwen, Qoder, Gemini, and other coding CLIs into one product surface instead of juggling separate entrypoints.

👥 Team Orchestration: Support solo, multi, and team interaction models with lead + specialists, scope-aware routing, and milestone-style collaboration.

💬 Group Chat Collaboration: Connect workflows to Lark and DingTalk, route group mentions to named agents, and turn chat rooms into AI workbenches.

🧠 Memory and Habits: Let agents accumulate working memory, repeated preferences, review standards, and recurring project context over time.

🛡️ Operationally Controllable: Built-in config validation, approval flow, allowlists, doctor/status commands, and health endpoints.

🏗️ Architecture

User / Group / WebSocket / Cron
              |
              v
           clawbro
              |
              +--> Routing / Session / Memory / Bindings / Team
              |
              +--> ClawBro Native ------> runtime-bridge ------> clawbro-agent-sdk
              |
              +--> Coding CLI Bridge ---> Claude / Codex / Qwen / Qoder / Gemini / custom coding CLIs
              |
              +--> OpenClaw Gateway ----> remote agent runtime
              |
              +--> Channels ------------> Lark / DingTalk / WebSocket delivery

Table of Contents

✨ Features

🌟 Use Cases

🚀 Full-Stack App Building

Turn one request into a coordinated build loop:

  • @planner breaks the product request into milestones
  • @coder implements API routes, UI flows, and data models
  • @reviewer checks quality, risks, and regressions
  • @tester fills in edge cases and missing validation

In Team mode, the lead can keep the user-facing conversation clean while specialists work in the background. In group chat, the same setup can feel like an AI project room instead of a single bot window.

📚 Deep Research and Report Writing

Use ClawBro as a research squad:

  • @researcher collects source material
  • @critic looks for gaps, counterexamples, and weak assumptions
  • @writer turns the findings into a structured report
  • the lead agent summarizes progress and final conclusions

This works especially well for technical reports, architecture comparisons, literature reviews, and long-form analysis that benefits from multiple perspectives before one final answer.

🧑‍💻 PR Review and Design Review

Drop a patch, PR, or design note into a chat and route it to the right mix of agents:

  • @coder focuses on implementation details
  • @reviewer checks correctness and maintainability
  • @researcher verifies outside dependencies or competing approaches
  • the lead returns a consolidated recommendation

This gives you something closer to an AI review room than a single one-shot answer.

💬 Group Chat With Multiple Named Agents

ClawBro is a natural fit for role-based group workflows:

  • @planner for decomposition
  • @coder for implementation
  • @reviewer for criticism
  • @researcher for evidence gathering

That pattern works for engineering teams, study groups, product discussions, and internal support rooms. Even when the strongest current Team path is still lead-driven, the group experience can already feel much more structured than a generic bot chat.

🧠 Memory-Driven Coding Habits

ClawBro is not just about one conversation at a time. Over repeated use, it can preserve working context such as:

  • architecture preferences
  • recurring review standards
  • naming conventions
  • project-specific workflows
  • things a user repeatedly asks the system to remember

That makes it useful for building a long-running coding habit, where your agents gradually become more aligned with how you actually work instead of resetting to zero every day.

🎭 Fun Team Play: Werewolf, RPG, and Role Rooms

The same role system also works for playful group scenarios:

  • a lead agent can act as the moderator in Werewolf
  • specialist agents can play judge, narrator, analyst, or character roles
  • role-based group chats can simulate product debates, mock trial rooms, or scripted multi-character conversations

This is one of the most distinctive parts of the project: the architecture is serious enough for engineering work, but flexible enough for entertainment and social experiments.

📦 Install

Install from crates.io

cargo install clawbro

Build from source

git clone https://github.com/fishers/clawbro.git
cd clawbro
cargo build -p clawbro --bin clawbro

🚀 Quick Start

[!TIP] The recommended first path is WebSocket + ClawBro Native. Add agent rosters, bindings, channels, and Team scopes after the base path is working.

1. Install

cargo install clawbro

2. Initialize

clawbro setup

This creates the default runtime layout under ~/.clawbro/, including:

  • config.toml
  • .env
  • sessions/
  • shared/
  • skills/
  • personas/