Learn

Practical OpenClaw guides

No inflated jargon. No filler content. Just the pieces that actually help you understand, set up, secure, and troubleshoot OpenClaw.

Getting Started

New to OpenClaw? Start here for the fundamentals.

Setup & Deployment

Installation guides for different environments and use cases.

Docker Setup Deep Dive

Complete guide to setting up OpenClaw with Docker. From automated scripts to manual deployment, troubleshooting, and security hardening.

Read guide

Telegram Channel Setup

Transform Telegram into a powerful interface for your OpenClaw agent. Bot creation, configuration, pairing, and troubleshooting.

Read guide

Home Server & Raspberry Pi

Run OpenClaw on affordable hardware. Complete guide for Raspberry Pi, NAS, and home server deployments with power and space efficiency.

Read guide

Remote Access

Reach your OpenClaw gateway safely from anywhere. Covers SSH tunnels, Tailscale, WebChat, remote nodes, and the security rules that matter.

Read guide

Heartbeat Automation

Set up automated health checks and monitoring for your OpenClaw deployment. Keep your AI agent running smoothly with cron jobs and heartbeat patterns.

Read guide

Discord Setup

Connect OpenClaw to Discord. Create a bot, configure permissions, and chat with your AI agent in your Discord server.

Read guide

Cron Jobs & Scheduled Tasks

Automate your OpenClaw agent with scheduled tasks. Master cron syntax, heartbeat patterns, and build reliable automation workflows.

Read guide

WhatsApp Setup

Connect OpenClaw to WhatsApp. QR pairing, session management, multi-device support, and troubleshooting for the world's most popular messaging app.

Read guide

Signal Setup

Connect OpenClaw to Signal for a privacy-first messaging channel. Covers pairing, security context, media handling, and troubleshooting.

Read guide

iMessage with BlueBubbles

Bridge the blue bubble gap. Connect OpenClaw to iMessage through BlueBubbles and bring your AI agent into Apple's messaging ecosystem.

Read guide

Slack Integration

Connect OpenClaw to your Slack workspace. Create a Slack app, configure OAuth scopes, and chat with your AI agent in channels and threads.

Read guide

WebChat Setup

Access your OpenClaw agent from any browser. No apps, no installs, no platform lock-in. Just open a URL and start chatting.

Read guide

Webhooks

Master real-time event-driven automation. Learn to receive webhooks, verify security signatures, and build reactive workflows with OpenClaw.

Read guide

Standing Orders

Give your agent durable authority for routine work. Define scope, approval gates, escalation rules, and pair them cleanly with cron.

Read guide

Camera & Media

Connect cameras and process visual media with OpenClaw. Set up camera nodes, capture images, build visual workflows, and handle privacy considerations.

Read guide

Location Features

Use location-aware nodes for arrival triggers, movement signals, and context-aware automation without collecting more data than you need.

Read guide

Voice & Talk Mode

Set up spoken interaction in OpenClaw. Tune wake words, push to talk, silence detection, and fast voice replies that people will actually use.

Read guide

macOS App Guide

Set up the OpenClaw macOS app, install the CLI, manage permissions, and choose between local and remote mode without confusion.

Read guide

iOS App Setup

Set up the OpenClaw iPhone app, pair it to your gateway, and understand the current iOS limits before they waste your time.

Read guide

Android Setup

Pair the OpenClaw Android app with your gateway and avoid the usual mobile setup traps.

Read guide

Windows WSL2 for OpenClaw

Run OpenClaw on Windows the sane way. Install WSL2, keep files in Linux, and avoid the path and Docker traps that waste hours.

Read guide

Core Concepts

Understanding the fundamental building blocks of OpenClaw.

Advanced Topics

Deep dives into sophisticated features and workflows.

Multi-Agent Orchestration

Learn to coordinate multiple AI agents with proven patterns and real-world implementations.

Read guide

Working with Sub-Agents

Master subagent creation and orchestration. Spawn isolated agents, delegate tasks, and build powerful multi-agent workflows.

Read guide

Choosing & Routing Models

Optimize costs with intelligent model selection. Configure primary/thinking models, multi-tier routing, and automatic escalation.

Read guide

Local Models

Run OpenClaw with Ollama, LM Studio, or another local server. Honest tradeoffs, hybrid routing, and the setup choices that actually matter.

Read guide

OpenRouter

Use one provider layer to reach many model families. Covers setup, auto routing, pinned model refs, and when abstraction helps or hurts.

Read guide

Model Failover

Keep your agent alive through rate limits, auth issues, and provider outages. Covers auth rotation, fallback chains, cooldowns, and strict overrides.

Read guide

Multiple Gateways

When one gateway is enough, when a rescue bot makes sense, and how to isolate profiles, ports, state, and workspaces cleanly.

Read guide

Using MCP Servers

Extend OpenClaw with Model Context Protocol servers. Connect to databases, file systems, and external APIs with standardized MCP integrations.

Read guide

Session Management

Master session lifecycle, pruning strategies, and context compaction. Keep your AI agent focused across long-running conversations.

Read guide

Dreaming: Background Processing

Enable your OpenClaw agent to work on tasks in the background. Learn how Dreaming works for long-running operations.

Read guide

Browser Automation

Control browsers programmatically with OpenClaw. Automate logins, extract data, fill forms, and handle complex web workflows.

Read guide

PDF & Document Analysis

Extract insights from PDFs and documents. Native PDF support, batch analysis, page selection, and practical extraction workflows.

Read guide

Media Generation

Create images, music, and videos with OpenClaw. Generate creative assets, social media content, and multimedia projects.

Read guide

Search Tools Comparison

Compare web_fetch, browser automation, and memory_search. Choose the right tool for each search task and optimize your research workflow.

Read guide

Code Execution & Sandboxing

Learn how OpenClaw runs shell commands safely. Covers exec, background processes, approval gates, and practical sandboxing limits.

Read guide

Anthropic Claude

When to use Claude in OpenClaw, which Claude model to pick, and how to route work for quality without wasting budget.

Read guide

Google Gemini

Use Gemini where long context, multimodal input, and cache-friendly document work actually matter. Covers 2.5 Flash, 2.5 Pro, and practical routing.

Read guide

OpenAI

Choose the right GPT-5 tier for OpenClaw, route work by cost and difficulty, and avoid paying flagship rates for routine tasks.

Read guide

Groq

Use Groq when low latency matters. Covers model lanes, transcription, rate limits, and practical routing inside OpenClaw.

Read guide

Plugin Development

Build OpenClaw plugins with clean manifests, safe tool registration, and a publishing path that stays maintainable.

Read guide

SOUL.md Personality

Shape an OpenClaw agent that sounds clear, consistent, and human. Covers tone, bluntness, boundaries, and how to avoid personality sludge.

Read guide

Templates Deep Dive

How the default OpenClaw workspace templates work together, what each file is really for, and how to customize them without creating instruction chaos.

Read guide

Backup & Migration

Back up OpenClaw properly, verify the archive, and move state to a new machine without losing sessions, credentials, or your workspace.

Read guide

TaskFlow Workflows

When multi-step automation needs durable state, waits, and clear orchestration instead of a pile of disconnected tasks.

Read guide

Hooks in OpenClaw

Event-driven reactions for commands, messages, startup, and restarts without jumping straight to a full plugin.

Read guide

Background Tasks & Durable Work

What persists, what stays in memory, and how to choose between exec, process, tasks, and TaskFlow for long-running OpenClaw work.

Read guide

Retry Policy & Failure Recovery

Learn what should retry, what should fail fast, and how to recover from flaky APIs without duplicating good steps.

Read guide

Channel Routing

How OpenClaw routes the right agent behavior to the right surface without mixing private chats, group rooms, and operational traffic.

Read guide

Access Groups & Broadcast Groups

Permission boundaries, controlled fan-out, and group design patterns that keep OpenClaw from oversharing.

Read guide

Ambient Room Events

Use quiet room awareness when the agent should listen first, keep signal over noise, and only speak when it has something worth saying.

Read guide

Channel Troubleshooting

Fix auth, transport, and reply-layer issues in OpenClaw channels without guessing or random config surgery.

Read guide

Gateway Architecture

Learn how the OpenClaw gateway coordinates channels, sessions, tools, models, and nodes without collapsing into one noisy chat surface.

Read guide

Context Engine & Compaction

How OpenClaw assembles context, compacts old history, and keeps long sessions useful instead of bloated.

Read guide

Active Memory vs Stored Memory

What gets surfaced before a reply, what stays on disk, and why memory recall sometimes fails.

Read guide

OpenClaw App SDK

When to use the external OpenClaw App SDK, how it differs from plugins, and which app ideas make sense first.

Read guide

Security & Safety

Protect your setup and use OpenClaw responsibly.

Optimization & Costs

Run OpenClaw efficiently and keep costs under control.

Video Tutorials

Prefer learning by watching? Check out our curated collection of video tutorials.

Browse video tutorials