This guide covers all installation methods for MicroClaw, from quick one-line installers to building from source.
The easiest way to install MicroClaw using prebuilt binaries.
macOS/Linux:
curl -fsSL https://microclaw.ai/install.sh | bash
Windows PowerShell:
iwr https://microclaw.ai/install.ps1 -UseBasicParsing | iex
Note: The installer downloads prebuilt binaries from the latest GitHub release only (no Homebrew/Cargo fallback).
brew tap microclaw/tap
brew install microclaw
Prerequisites: Rust toolchain (cargo)
git clone https://github.com/microclaw/microclaw.git
cd microclaw
cargo build --release
cp target/release/microclaw /usr/local/bin/
Optional semantic-memory build:
cargo build --release --features sqlite-vec
See the dedicated Docker Setup Guide for detailed instructions.
Quick start:
docker run -d \
-v ~/.microclaw:/root/.microclaw \
-e TELEGRAM_BOT_TOKEN=your_token \
-e API_KEY=your_api_key \
-p 10961:10961 \
microclaw/microclaw:latest
MicroClaw includes an interactive setup wizard:
microclaw setup
The wizard provides:
Before starting, verify your installation:
microclaw doctor
For machine-readable output:
microclaw doctor --json
To check sandbox configuration:
microclaw doctor sandbox
microclaw start
The configuration file microclaw.config.yaml is stored at:
~/.microclaw/microclaw.config.yaml--config flag or MICROCLAW_CONFIG environment variable# LLM Configuration (Required)
llm_provider: "anthropic" # or: openai, openrouter, ollama, google, deepseek, etc.
api_key: "sk-ant-..." # Required (except ollama)
model: "claude-sonnet-4-20250514"
# llm_base_url: "https://..." # Optional custom provider URL
# Channel Configuration (At least one required)
channels:
telegram:
default_account: "main"
accounts:
main:
bot_token: "123456:ABC-DEF1234..."
bot_username: "my_bot"
# Optional Settings
data_dir: "~/.microclaw"
working_dir: "~/.microclaw/working_dir"
working_dir_isolation: "chat" # or "shared"
timezone: "UTC"
max_tokens: 8192
max_tool_iterations: 100
memory_token_budget: 1500
MicroClaw supports multiple accounts per platform:
channels:
telegram:
default_account: "main"
accounts:
main:
bot_token: "TOKEN_1"
bot_username: "bot_one"
secondary:
bot_token: "TOKEN_2"
bot_username: "bot_two"
discord:
default_account: "main"
accounts:
main:
bot_token: "DISCORD_TOKEN"
See the Configuration Guide for detailed options.
Install MicroClaw as a persistent system service:
microclaw gateway install
microclaw gateway start
microclaw gateway status
Service Management:
microclaw gateway stop
microclaw gateway restart
microclaw gateway logs 200
microclaw gateway uninstall
Notes:
launchd user agentssystemd --user<data_dir>/runtime/logs/MicroClaw includes a local web interface for managing sessions and viewing history.
Access: http://127.0.0.1:10961
Features:
Password Management:
microclaw web password <value> # Set password
microclaw web password-generate # Generate random password
microclaw web password-clear # Remove password
Once running, use these commands in your chat:
| Command | Description |
|---|---|
/stop |
Abort current active run |
/reset |
Clear chat context |
/skills |
List available skills |
/reload-skills |
Reload skills from disk |
/archive |
Archive session as markdown |
/usage |
Show token usage summary |
/status |
Show provider/model status |
/plugins list |
List installed plugins |
MicroClaw supports Model Context Protocol (MCP) for extending capabilities.
Config Location: <data_dir>/mcp.json
Minimal Setup:
cp mcp.minimal.example.json ~/.microclaw/mcp.json
Example Configuration:
{
"defaultProtocolVersion": "2025-11-05",
"mcpServers": {
"filesystem": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@modelcontextprotocol/server-filesystem", "."]
},
"playwright": {
"transport": "stdio",
"command": "npx",
"args": ["-y", "@playwright/mcp@latest", "--extension"],
"env": {
"PLAYWRIGHT_MCP_EXTENSION_TOKEN": "<token>"
}
}
}
}
Validate MCP:
RUST_LOG=info microclaw start
Look for: MCP server '...' connected (...)
macOS/Linux:
curl -fsSL https://microclaw.ai/uninstall.sh | bash
Windows PowerShell:
iwr https://microclaw.ai/uninstall.ps1 -UseBasicParsing | iex
Installation fails:
Bot doesn’t respond:
<data_dir>/runtime/logs/MCP servers not connecting:
microclaw doctorSandbox mode issues:
docker infodocker run --rm ubuntu:25.10 echo okAny questions?
Feel free to contact us. Find all contact information on our contact page.