> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.
# OpenClaw
# OpenClaw 🦞
> *"EXFOLIATE! EXFOLIATE!"* — A space lobster, probably
Any OS gateway for AI agents across Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more.
Send a message, get an agent response from your pocket. Run one Gateway across channel plugins, WebChat, and mobile nodes.
Install OpenClaw and bring up the Gateway in minutes.
Guided setup with `openclaw onboard` and pairing flows.
Link Discord, Signal, Telegram, WhatsApp, and more to chat from anywhere.
Launch the browser dashboard for chat, config, and sessions.
## Browse docs
Mobile browsers may show the section menu without the full desktop tab bar. Use
these hub links to reach the same top-level docs areas from the page body.
Overview, showcase, first steps, and setup guides.
Install paths, updates, containers, hosting, and advanced setup.
Messaging channels, pairing, routing, access groups, and channel QA.
Architecture, sessions, context, memory, and multi-agent routing.
Tools, skills, cron, webhooks, and automation capabilities.
Plugin marketplace, publishing, curation, and trust guidance.
Providers, model configuration, failover, and local model services.
macOS, Windows, iOS, Android, nodes, and web surfaces.
Gateway configuration, security, diagnostics, and operations.
CLI reference, schemas, RPC, release notes, and templates.
Troubleshooting, FAQs, testing, diagnostics, and environment checks.
## What is OpenClaw?
OpenClaw is a **self-hosted gateway** that connects your favorite chat apps — Discord, Google Chat, iMessage, Matrix, Microsoft Teams, Signal, Slack, Telegram, WhatsApp, Zalo, and more via channel plugins — to AI coding agents. You run a single Gateway process on your own machine (or a server), and it becomes the bridge between your messaging apps and an always-available AI assistant.
**Who is it for?** Developers and power users who want a personal AI assistant they can message from anywhere — without giving up control of their data or relying on a hosted service.
**What makes it different?**
* **Self-hosted**: runs on your hardware, your rules
* **Multi-channel**: one Gateway serves every configured channel plugin simultaneously
* **Agent-native**: built for coding agents with tool use, sessions, memory, and multi-agent routing
* **Open source**: MIT licensed, community-driven
**What do you need?** Node 24.15+ (recommended), Node 22 LTS (`22.22.3+`) for compatibility, or Node 25.9+, an API key from your chosen provider, and 5 minutes. For best quality and security, use the strongest latest-generation model available.
## How it works
```mermaid theme={"theme":{"light":"min-light","dark":"min-dark"}}
flowchart LR
A["Chat apps + plugins"] --> B["Gateway"]
B --> C["OpenClaw agent"]
B --> D["CLI"]
B --> E["Web Control UI"]
B --> F["macOS app"]
B --> G["iOS and Android nodes"]
```
The Gateway is the single source of truth for sessions, routing, and channel connections.
## Key capabilities
Discord, iMessage, Signal, Slack, Telegram, WhatsApp, WebChat, and more with a single Gateway process.
Channel plugins add Matrix, Nostr, Twitch, Zalo, and more; official plugins install on demand.
Isolated sessions per agent, workspace, or sender.
Send and receive images, audio, and documents.
Browser dashboard for chat, config, sessions, and nodes.
Pair iOS and Android nodes for Canvas, camera, and voice-enabled workflows.
## Quick start
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
npm install -g openclaw@latest
```
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw onboard --install-daemon
```
Open the Control UI in your browser and send a message:
```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
openclaw dashboard
```
Or connect a channel ([Telegram](/channels/telegram) is fastest) and chat from your phone.
Need the full install and dev setup? See [Getting Started](/start/getting-started).
## Dashboard
Open the browser Control UI after the Gateway starts.
* Local default: [http://127.0.0.1:18789/](http://127.0.0.1:18789/)
* Remote access: [Web surfaces](/web) and [Tailscale](/gateway/tailscale)
## Configuration (optional)
Config lives at `~/.openclaw/openclaw.json`.
* If you **do nothing**, OpenClaw uses the bundled OpenClaw agent runtime; DMs share the agent's main session, and each group chat gets its own session.
* If you want to lock it down, start with `channels.whatsapp.allowFrom` and (for groups) mention rules.
Example:
```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}}
{
channels: {
whatsapp: {
allowFrom: ["+15555550123"],
groups: { "*": { requireMention: true } },
},
},
messages: { groupChat: { mentionPatterns: ["@openclaw"] } },
}
```
## Start here
All docs and guides, organized by use case.
Core Gateway settings, tokens, and provider config.
SSH and tailnet access patterns.
Channel-specific setup for Discord, Feishu, Microsoft Teams, Telegram, WhatsApp, and more.
iOS and Android nodes with pairing, Canvas, camera, and device actions.
Common fixes and troubleshooting entry point.
## Learn more
Complete channel, routing, and media capabilities.
Workspace isolation and per-agent sessions.
Tokens, allowlists, and safety controls.
Gateway diagnostics and common errors.
Project origins, contributors, and license.