OpenClaw Expert Skill#

Complete OpenClaw reference compiled from 426+ official documentation pages. 12 reference files covering every aspect of the platform.

Reference File Index#

Load the relevant file based on the user's question. Read only what's needed.

#FileTopicsLines01references/01-core-concepts.mdArchitecture, agent runtime/loop, workspace, active memory, compaction, context engine, delegate architecture, dreaming, experimental features, markdown, memory (builtin/honcho/QMD/search), messages, model failover, model providers, models CLI, multi-agent routing, OAuth, presence, QA E2E automation, command queue, retry policy, sessions (management/pruning/tools), SOUL.md personality, streaming/chunking, system prompt, timezones, TypeBox schema, typing indicators, usage tracking, GPT-5.4/Codex agentic parity, Pi integration architecture, OpenProse264702references/02-gateway.mdGateway runbook, authentication, background process, Bonjour/mDNS discovery, CLI backends, config (agents/channels/tools), configuration reference/examples, diagnostics export, doctor, gateway lock, health checks, heartbeat, local models, logging, multiple gateways, network model, OpenAI Chat Completions HTTP API, OpenResponses HTTP API, OpenShell, gateway-owned pairing, gateway protocol, remote access/setup, sandboxing (Docker/SSH/OpenShell), secrets management, security audit checks153803references/03-cli.mdAll 50+ CLI subcommands: ACP, agent, agents, approvals/exec-policy, backup, browser, channels, completion, config, configure, cron, dashboard, devices, directory, DNS, docs, doctor, flows/tasks, gateway, health, hooks, infer/capability, logs, MCP, memory, message, models, node, nodes, onboard, pairing, plugins, proxy, QR, reset, sandbox, secrets, security, sessions, setup, skills, status, system, tasks, TUI/chat/terminal, uninstall, update, voicecall, webhooks, wiki + quick reference table329904references/04-channels.mdChannel overview/routing, groups, pairing, broadcast groups, location parsing, QA channel, BlueBubbles, Discord, Feishu/Lark, Google Chat, iMessage (legacy), IRC, LINE, Matrix (+ push rules), Mattermost, MS Teams, Nextcloud Talk, Nostr, QQ Bot, Signal, Slack, Synology Chat, Telegram, Tlon/Urbit, Twitch, WeChat, WhatsApp, Zalo (bot + personal), DM/group policy, multi-account, troubleshooting, feature comparison table276505references/05-providers.mdAnthropic, OpenAI, Gemini, OpenRouter, MiniMax, DeepSeek, Groq, Ollama, Together AI, Mistral, Fireworks, xAI, Perplexity, Amazon Bedrock, Cloudflare AI Gateway, Z.AI/GLM (Zhipu), 40+ additional providers (Arcee, Bedrock Mantle, Chutes, Claude Max Proxy, ComfyUI, GitHub Copilot, Gradium, Kilocode, LiteLLM, SGLang, Synthetic, Tencent, Vercel AI GW, vLLM, Volcengine, Vydra, Xiaomi, and more), model selection/failover config, env vars quick reference168906references/06-tools.mdTool architecture, exec, code_execution, browser, message (agent send), image_generate, video_generate, music_generate, tts, web_fetch, sessions_spawn (sub-agents), web_search, tool configuration, gateway tool, memory_search/memory_get, session_status, plugin-provided tools144807references/07-plugins.mdPlugin system (install/develop/lifecycle), bundled plugins, voice-call, music-2.6, channel plugins, SDK conventions, registerCliBackend, registerAgentToolResultMiddleware, createOptionalChannelSetupSurface119008references/08-automation.mdCron jobs (create/list/edit/delete/run/logs/doctor), background tasks (ledger), task flow, hooks (HTTP webhooks), standing orders, program examples (weekly status, content/social, financial, system monitoring), heartbeat, isolated sessions, failureDestination, model switch auth, Gmail PubSub, how they work together94809references/09-installation.mdGetting started, updating, Docker (SSH/OpenShell sandbox, HEALTHCHECK, shared-network, VM runtime), Nix, Raspberry Pi, uninstall, onboarding wizard, VPS/Linux server deployment, migration guide, platform notes, Control UI custom build101910references/10-security-and-misc.mdSecurity model, exec approvals, sandbox modes, autoApproveCidrs, trusted-proxy, audit checks, FAQ, troubleshooting (gateway probe, doctor, channels --probe), debugging (watcher, PI_RAW_STREAM), env vars, scripts reference, nodes (remote exec, token rotation, SecretRef), diagnostics (export/recorder/privacy/flags), CI pipeline, RPC adapters122611references/11-platforms.mdmacOS (app, discovery, --json), iOS (APNS relay, autoApproveCidrs, relay refresh), Android (autoApproveCidrs, foreground service, auto-reconnect, wide-area discover), Windows (companion, source dev loop, status), Linux (exe.dev, enable-linger), VPS hosting (shared agent, nodes, TimeoutStartSec), Web UI — Control UI (identity, auth gating, approval upgrade, base-hash guard, SecretRef preflight, abort, optimistic messages, compact button, Talk WebRTC, cron panel, schema.lookup, embedSandbox, chat.inject, config.apply) + WebChat (maxChars, abort metadata, tools panel)96512references/12-reference.mdConfiguration system overview, full config schema (gateway/agents/session/channels/cron/hooks/browser/UI/diagnostics/env), agent config reference, heartbeat reference (directPolicy/lightContext/isolatedSession/activeHours/ackMaxChars/multi-account/per-agent merge), workspace file map (BOOT.md hooks, bootstrap size limits, sandbox seed, Git backup), session management (threadBindings/maintenance/identityLinks), authentication (trusted-proxy fail-closed, HTTP API), gateway WS protocol (handshake/framing/roles/scopes/broadcast/RPC method families incl. diagnostics/secrets/sessions/approval/pairing), RPC adapters, CLI reference, onboarding wizard reference (providers table incl. MiniMax/StepFun/Synthetic/Moonshot/Kimi), file locations, env vars (OOM_SCORE_ADJ/PLUGIN_STAGE_DIR/ALLOW_INSECURE_PRIVATE_WS/PI_RAW_STREAM/DEBUG_TIMING/NODE_COMPILE_CACHE)1546

Routing Guide#

Match the user's question to the best starting file(s). Many topics span multiple files — follow cross-references.

Question PatternStart WithThen CheckConfiguration / openclaw.json schema12-reference.md``02-gateway.mdHow do I set up X channel?04-channels.mdHow do I configure X provider?05-providers.mdCLI command help / "how do I run..."03-cli.mdDebugging / "not working" / errors10-security-and-misc.md``03-cli.md (doctor/probe)Heartbeat config / behavior12-reference.md (heartbeat ref)08-automation.md, 02-gateway.mdCron jobs / scheduled tasks08-automation.md``03-cli.md (cron CLI)Hooks / webhooks08-automation.md``03-cli.md (hooks CLI)Standing orders / task flow08-automation.mdInstallation / getting started09-installation.md``11-platforms.mdDocker setup09-installation.md``02-gateway.md (sandboxing)VPS / headless / PM2 / systemd09-installation.md``11-platforms.mdPlatform-specific apps (macOS/iOS/Android/Windows)11-platforms.mdControl UI / WebChat / Web UI11-platforms.mdSecurity / sandboxing / exec approvals10-security-and-misc.md``02-gateway.md, 03-cli.mdTools (exec/browser/image/video/TTS/music)06-tools.mdSub-agents / ACP / sessions_spawn06-tools.md``01-core-concepts.mdPlugins (install/develop/voice-call/music)07-plugins.mdArchitecture / how OpenClaw works01-core-concepts.mdMemory systems (builtin/honcho/QMD)01-core-concepts.md``03-cli.md (memory CLI)Agent workspace / bootstrap files01-core-concepts.md``12-reference.md (workspace ref)Sessions / multi-agent / routing01-core-concepts.md``12-reference.md (session ref)Model failover / retry / fallback chains01-core-concepts.md``05-providers.mdSystem prompt / SOUL.md / personality01-core-concepts.mdStreaming / typing indicators / presence01-core-concepts.mdUsage tracking / token costs01-core-concepts.mdGateway protocol / WebSocket RPC12-reference.md``02-gateway.mdNodes / remote exec / token rotation10-security-and-misc.md``12-reference.mdDiagnostics / export / recorder10-security-and-misc.mdEnvironment variables10-security-and-misc.md``12-reference.mdMigration / updating09-installation.mdBonjour / mDNS / discovery02-gateway.mdOpenAI-compatible API / OpenResponses02-gateway.mdGPT-5.4 / Codex parity / strict-agentic01-core-concepts.mdPi integration / createAgentSession01-core-concepts.mdOpenProse / .prose workflows01-core-concepts.md``07-plugins.mdFAQ10-security-and-misc.md

Key Quick-Reference#

Config File Location#

~/.openclaw/openclaw.json (JSON5 with comments/trailing commas)

Essential CLI Commands#

bash

openclaw onboard          # Interactive setup
openclaw doctor           # Diagnose issues
openclaw doctor --fix     # Auto-repair
openclaw gateway start    # Start daemon
openclaw gateway status   # Check status
openclaw status --deep    # Full health probe
openclaw config get <path>    # Read config value
openclaw config set <path> <value>  # Write config value
openclaw cron list        # List cron jobs
openclaw models list      # List available models
openclaw models scan      # Probe all configured models

Model Format#

Always provider/model — e.g. anthropic/claude-sonnet-4-6, openai/gpt-5.4, minimax/MiniMax-M2.7

DM Policy Options#

pairing (default) → allowlist → open → disabled

Sandbox Modes#

off (default) | non-main | all — scope: session | agent | shared

Heartbeat Defaults#

• Interval: 30m (or 1h for Anthropic OAuth/token auth)
• Target: none (set last for delivery to last contact)
• Reply HEARTBEAT_OK when nothing needs attention

Session Scoping#

main | per-peer | per-channel-peer (recommended) | per-account-channel-peer

File Precedence (workspace context)#

Bootstrap files loaded every session: AGENTS.md, SOUL.md, USER.md, IDENTITY.md, TOOLS.md, HEARTBEAT.md Per-file limit: bootstrapMaxChars (default 12000), total: bootstrapTotalMaxChars (default 60000)

Grep Patterns for Efficient Lookup#

All reference files are large. Use targeted reads instead of loading entire files:

bash

# Find a specific topic's section
grep -n '^## \|^### ' references/01-core-concepts.md   # List all headings
grep -n 'heartbeat' references/12-reference.md          # Find heartbeat mentions
grep -n '^## Telegram' references/04-channels.md         # Jump to Telegram section
grep -n '^## Anthropic' references/05-providers.md       # Jump to Anthropic section

Strategy for large files:

1. Read the first 40 lines (TOC or section overview) to locate the heading
2. grep -n '^## TARGET' to find the line number
3. Read only that section with offset/limit

Common Multi-File Lookups#

Some topics are spread across files. Read in this order:

TopicPrimarySecondaryTertiaryHeartbeat12-reference.md §Heartbeat Reference08-automation.md §Heartbeat02-gateway.md §HeartbeatSandboxing02-gateway.md §Sandboxing10-security-and-misc.md §Security03-cli.md §SandboxMemory01-core-concepts.md §Memory03-cli.md §Memory07-plugins.md §Memory PluginsExec approvals10-security-and-misc.md §Security03-cli.md §Approvals11-platforms.md §Control UIDocker09-installation.md §Docker02-gateway.md §SandboxingWebSocket12-reference.md §Gateway Protocol02-gateway.md §Gateway Protocol01-core-concepts.md §TypeBox

Notes#

• All 12 reference files have a Table of Contents at the top — read that first to locate the relevant section.
• Cross-reference between files is common. The routing guide and multi-file lookup table above cover the main overlaps.
• All content verified against live docs at docs.openclaw.ai as of April 2026.