microclaw/microclaw
🦀An agentic AI assistant that lives in your chats, inspired by nanoclaw and incorporating some of its design ideas. Built with Rust 🦀
📚 What is MicroClaw?
MicroClaw is a self‑hosted, Rust‑based AI‑agent platform that can run either as a long‑living server, as a native desktop “Work” app, or be embedded in any Rust program via its microclaw-sdk. All three entry points share the same core Agent Engine – the part that talks to LLM providers, runs tools, keeps memory, and enforces safety policies.
🎯 Who is it for?
| Use‑case | Recommended surface |
|---|---|
| Always‑on chat bots, web/API endpoints, scheduled automation | MicroClaw Server (macOS, Linux, Windows) |
| Local, workspace‑centric “co‑worker” that lives on your desktop | MicroClaw Work – a native GPUI app (Apple Silicon macOS 13+, Linux/Windows previews) |
| Adding an AI‑agent to an existing Rust codebase | microclaw‑sdk – embed the engine directly |
⚙️ Core capabilities
| Area | What you get |
|---|---|
| Agent execution | Multi‑step tool use, parallel read‑only waves, planning, sub‑agents, completion contracts |
| Continuity | Resumable sessions, checkpoints, durable outbound delivery, scheduling, cancellation |
| Memory & learning | File‑based + SQLite memory, semantic recall, temporal knowledge graph, governed skill evolution |
| Extensibility | Skills, plugins, hooks, MCP, ClawHub, A2A, ACP – all plug into the same runtime |
| Interfaces | Rust SDK, native Work UI, local Web UI, HTTP/SSE/WebSocket APIs, dozens of chat adapters (Telegram, Discord, Slack, Matrix, etc.) |
| Safety & ops | Tool‑approval gates, scoped capability grants, Docker sandboxing, egress policy, secret redaction, audit trails |
🛠️ How to get started
- Work (desktop) –
brew tap microclaw/tap && brew install --cask microclaw-work(Apple Silicon macOS) or download the Linux/Windows preview from the v0.9.0 release. - Server – one‑liner installer:
curl -fsSL https://microclaw.org/install.sh | bash(macOS/Linux) or the PowerShell equivalent for Windows. Then runmicroclaw doctor && microclaw setup && microclaw startand openhttp://127.0.0.1:10961. - SDK – add to
Cargo.toml:
and follow the quick‑start code snippet to spin up an agent programmatically.microclaw-sdk = { version = "0.9.0", features = ["full"] }
📖 Documentation & community
- Docs hub –
docs/README.mdlinks to getting‑started guides, SDK concepts, tool catalog, security model, and operations runbooks. - Support – Discord, Reddit, and a public issue tracker. Security disclosures go through
SECURITY.md. - Release cadence – stable branch for production,
mainfor rapid development. Latest stable is v0.9.0.
🤔 Why choose MicroClaw?
- Single engine, multiple front‑ends – you can start with the desktop app, later switch to a server, or embed the same engine without rewriting logic.
- Rust‑first – high performance, low‑footprint, and easy to ship as a single binary; SQLite persistence keeps dependencies minimal.
- Durable, resumable work – the runtime checkpoints after each tool call, so long‑running or interrupted tasks can be recovered safely.
- Provider‑agnostic – native Anthropic support plus any OpenAI‑compatible or local model via a unified message format.
- Safety baked in – built‑in guardrails, sandboxed tool execution, and audit trails make it suitable for production workloads.
📦 Quick tech snapshot
- Language: Rust (requires 1.93+, built on 1.96 toolchain for v0.9.0)
- License: MIT
- Packaging: Homebrew, Docker (
ghcr.io/microclaw/microclaw:latest), source (cargo build --release) - Platform support: macOS (Apple Silicon), Linux (x86_64/arm64), Windows (portable preview)
MicroClaw lets you run sophisticated, stateful AI agents locally or as a service, with a focus on reliability, extensibility, and safety—all from a single Rust codebase.
Related
- Project
- Project
- Project
- Project
- Project