Core Concepts
Architecture
GoClaw is built around a central in-process event bus and a single WebSocket gateway. All components communicate through the bus — no direct inter-component dependencies, no microservices.
architecture overview
text
Key design decisions
- ⚡ Goroutine-native: Each channel adapter runs in its own goroutine. The event bus dispatches to subscriber goroutines concurrently — no blocking, no head-of-line problems.
- 🔒 No shared mutable state: Components communicate only via the bus or explicit function calls. Never shared variables. Race-condition-free by design.
- 📁 Filesystem-first memory: Plain Markdown files. No database means no migration headaches, no extra process, and easy manual editing from any text editor.
- 🔌 Language-agnostic skills: The gRPC contract is the only interface. Any language that can speak Protocol Buffers can be a first-class GoClaw skill.