📖 All Guides
11 comprehensive guides covering everything from installation to advanced automation. Start with Getting Started, then explore whatever you need next.
🚀 Getting Started
Mac Setup
Install OpenClaw on macOS — Homebrew, Node.js, onboarding wizard, LaunchAgent daemon, Apple Silicon & Intel.
Linux Setup
Install on Ubuntu, Debian, or Fedora — Node.js 22+, npm install, systemd daemon, permissions.
Docker Setup
Run in Docker containers — docker-compose, persistent volumes, environment variables, tool sandboxing.
Windows Setup (WSL2)
Install on Windows 10/11 via WSL2 — Ubuntu setup, systemd, Node.js, gateway daemon, browser access.
VPS Deploy
Deploy to Hostinger, Hetzner, or DigitalOcean — always-on 24/7 with Docker, SSH tunnels, and Tailscale.
Your First 24 Hours
Hour-by-hour: write SOUL.md, fill USER.md, connect a channel, set up cron, configure security & failover.
🔐 Security
Security & DM Policies
DM policies, pairing, allowlists, sandboxing, exec controls, credential hygiene, network hardening, 20-point checklist.
DM Policies Deep Dive
Pairing, allowlists, open mode risks, per-channel overrides, group policies, requireMention, and openclaw doctor audit.
Sandboxing Deep Dive
Docker sandbox modes, network isolation, bind mounts, browser sandboxing, setupCommand, and per-agent overrides.
📱 Channels
Channels Overview
Compare & connect all channels: Telegram, WhatsApp, Discord, iMessage, Slack, Signal, WebChat, Teams & more.
Telegram Setup
BotFather token, config, pairing, groups, voice notes, forum topics, stickers & troubleshooting.
WhatsApp Setup
QR code pairing, selfChat mode, phone allowlists, groups, Baileys protocol & troubleshooting.
Discord Setup
Bot token, intents, thread sessions, focus/unfocus, slash commands & multi-server routing.
iMessage Setup
Native macOS channel, BlueBubbles for remote access, Apple Notes/Reminders integration.
Slack Setup
Slack app creation, Socket Mode, bot scopes, threads, channel routing & enterprise teams.
🧠 Core Concepts
SOUL.md & Identity
All workspace files: SOUL.md, IDENTITY.md, USER.md, AGENTS.md. Three templates, common mistakes, iteration workflow.
Memory System
MEMORY.md, daily logs, semantic search, auto-compaction, FSRS-6 decay, and how to curate long-term memory.
Automation & Cron
Heartbeat vs cron, scheduling patterns (at/every/cron), delivery modes, webhooks, HEARTBEAT.md, cost tips.
Models & Providers
Claude, GPT, Gemini, DeepSeek, Ollama, OpenRouter — pricing, fallback chains, multi-model routing, cost optimization.
🚀 Advanced & Niche
Sub-Agents & Multi-Agent
Define agents, route with bindings, spawn sub-agents, orchestrator patterns, thread-bound sessions.
Voice & Talk Mode
ElevenLabs TTS, Whisper STT, wake word, Talk Mode on macOS/iOS/Android, voice notes.
Cost Optimization
Model tiering, cheap heartbeat, cron optimization, local Ollama fallback, budget profiles.
Signal Setup
signal-cli installation, device linking, UUID allowlists, maximum privacy AI assistant.
WebChat & Control UI
Browser-based chat at localhost:18789, remote access via Tailscale, dashboard features.
Windows Setup (WSL2)
Install WSL2, Node.js 22, systemd auto-start, port forwarding, and Windows-specific troubleshooting.
DM Policies Deep Dive
Pairing flow, allowlist config, group policies, per-channel overrides, session isolation.
Sandboxing Deep Dive
Docker sandbox modes, tool allow/deny lists, exec approvals, network isolation, hardened deployment.
⚔️ Comparisons
OpenClaw vs Claude Code
Swiss Army knife vs surgical scalpel. Capabilities, security, pricing, and when to use each (or both).
OpenClaw vs n8n
Assistant-first vs workflow-first automation. When to use each, how they complement, and cost comparison.
OpenClaw vs Zapier
Personal assistant vs SaaS automation. Privacy, control, customization depth, and cost models.
OpenClaw vs ChatGPT
Action vs advice. Self-hosted assistant vs polished conversational AI. Persistence, privacy, when to use both.
OpenClaw vs Perplexity Computer
Self-hosted 24/7 assistant vs cloud multi-agent orchestrator. Pricing, privacy, channels, and when to use each.
OpenClaw vs Factory
General-purpose assistant vs agent-native software development. When to use each and how they complement.
OpenClaw vs Reclaim / Motion
Calendar optimization vs full assistant. Scheduling tools vs conversational automation. Use together.
OpenClaw vs Mem0 / MemGPT
Built-in memory vs dedicated memory layers. Mem0 plugin, Letta, and when to upgrade.
OpenClaw vs LangGraph / CrewAI
Product vs framework. Ready-to-use agent vs multi-agent building blocks. When to build vs deploy.
📋 Playbooks