OpenClaw-Bub

A hook-first, local-first agent runtime inspired by OpenClaw.

Philosophy

• Minimal Core: The runtime is just an event loop and hook registry
• Plugin Everything: All behavior comes from plugins
• Local-First: Runs on your machine, uses your resources
• Observable: Everything is logged, traceable, replayable

Quick Start

pip install openclaw-bub
openclaw-bub run "hello world"

Architecture

┌─────────────────────────────────────┐
│           OpenClaw-Bub              │
│  ┌─────────┐    ┌──────────────┐   │
│  │  Hooks  │◄───│  Plugins     │   │
│  └────┬────┘    └──────────────┘   │
│       │                             │
│  ┌────▼────┐    ┌──────────────┐   │
│  │  Event  │───►│  Model       │   │
│  │  Loop   │    │  (Local/Cloud)│   │
│  └─────────┘    └──────────────┘   │
└─────────────────────────────────────┘

Hooks

• on_init: Setup phase
• on_message: Incoming message handler
• on_tool_call: Tool execution
• on_finish: Cleanup phase

License

MIT