openclaw/openclaw
OpenClaw
OpenClaw is a self-hosted, single-user AI gateway that bridges your messaging apps — WhatsApp, Telegram, Discord, Signal, iMessage, Slack, Matrix, Microsoft Teams, and 20+ more — to coding-capable AI agents running on your own hardware. You install one Gateway process (locally on macOS, Linux, Windows-WSL2, or in Docker), pair your devices and channels, and from that moment every DM you send on any connected platform routes to your private AI assistant. No hosted service sees your data; your workspace, your sessions, and your memory files live on your machine. OpenClaw is built for developers and power users who want agentic AI — full tool use, file access, sandbox execution, voice, and multi-agent orchestration — delivered through the messaging surfaces they already live in.
Showcase
Real-world skills and integrations built by the OpenClaw community, collected on the showcase gallery.
PR review skill running in Telegram
A coding-agent skill surfacing GitHub PR review comments directly inside a Telegram group.
Agents UI dashboard
The gateway's web Control UI showing active agent sessions, routing state, and connected nodes.
Oura health tracker integration
An Oura ring health-data skill queried directly through chat — sleep scores, readiness, and activity pulled on demand.
Codex monitor skill
A Codex monitor skill showing live coding-agent run status and approval prompts inside the chat UI.
Live examples
- Get started — install the Gateway in minutes
- Showcase gallery of real-world skills and integrations
- Step-by-step onboarding wizard (
openclaw onboard) - Channels index — every supported messaging platform
- Skills catalogue — bundled and community skills
- Gateway architecture and configuration reference
- Multi-agent routing concepts
- FAQ and troubleshooting
Features
- 25+ messaging channels — WhatsApp, Telegram, Discord, Signal, Slack, iMessage (via BlueBubbles), Matrix, Microsoft Teams, Google Chat, Feishu/Lark, LINE, Mattermost, Nextcloud Talk, Nostr, QQ Bot, Synology Chat, Tlon (Urbit), Twitch, WebChat, WeChat, Zalo, Zalo Personal, IRC, and more via plugins
- Multi-agent routing — route channels, groups, or individual senders to isolated agents each with their own workspace, session, model, and tool set
- Agent Sandbox — per-agent or per-session Docker containers provide a hard execution boundary for untrusted or multi-tenant tool runs
- ACP conversation bindings — pin a chat thread to a persistent ACP (Agent Client Protocol) workspace for durable coding-agent sessions
- Skills system — inject on-demand SKILL.md guides (apple-notes, gh-issues, 1password, camsnap, canvas, coding-agent, gifgrep, and hundreds more) into the agent's context without bloating the base prompt
- Voice support — STT/TTS pipeline on macOS, iOS, Android, and Discord voice channels; speech-to-text transcription and voice-note delivery
- Canvas UI — agent-controlled rendering surface pushed to mobile nodes for rich visual output
- Mobile nodes (iOS + Android) — pair native apps to the Gateway over WebSocket for camera, voice, and Canvas workflows
- Web Control UI — browser dashboard for chat, config management, session inspection, and device pairing
- Streaming previews — live-edit draft replies in Telegram, Discord, Matrix, and Feishu as the model generates tokens
- Persistent memory — per-agent MEMORY.md files with active memory surfacing, Dreaming (background consolidation), and QMD semantic search
- Exec approvals — interactive button-based approval flow for shell commands across Telegram, Discord, and Slack
- Session isolation — per-agent session keys, history, workspace, and context buffer kept fully separate even in broadcast-group setups
- Containerized Gateway — Docker and Podman support with Docker Compose, health-check endpoints, and VPS deployment guides
- Profile rotation and model failover — automatic provider failover across OpenAI, Anthropic, Gemini, and OpenRouter
- DM pairing — explicit owner-approval step for every new sender; allowlist, open, or disabled policies per channel
- Broadcast groups — fan out one inbound message to multiple agents running in parallel with isolated sessions
- CLI toolkit —
openclaw onboard,openclaw gateway,openclaw message send,openclaw agent,openclaw doctor,openclaw pairing approve
Documentation
- Getting started — install and first run
- Onboarding wizard — guided channel and agent setup
- Channels — per-channel setup guides
- Skills — writing and installing skills
- Gateway configuration reference
- Agent runtimes and sandboxing
- Multi-agent routing
- Memory and dreaming
Quick start
npm install -g openclaw@latest
openclaw onboard --install-daemon
openclaw gateway --port 18789 --verbose
openclaw message send --channel telegram --target @you --message "Hello from OpenClaw"
openclaw agent --message "Review the open PRs" --thinking high
openclaw doctor
Tags
- Use case
- Personal AI assistantPersonal AI assistantSelf-hosted single-user AI gateway that routes your messaging apps to a private AI agent running on your own hardware.View all repositories tagged→CLI toolCLI toolDistributed primarily as a command-line tool you install and run from your shell.View all repositories tagged→
- Ecosystem
- Node.jsNode.jsJavaScript runtime built on V8 for building server-side and CLI applications.View all repositories tagged→JavaScriptJavaScriptBuilt with JavaScript, runs in the browser or any JS runtime.View all repositories tagged→TypeScriptTypeScriptStatically typed superset of JavaScript compiled to JS, used for large-scale Node.js and frontend applications.View all repositories tagged→
- Stack
- Docker ComposeDocker ComposeLocal development and runtime are orchestrated with docker-compose.View all repositories tagged→
- Status
- ActiveActiveReceives recent commits and releases, issues are being addressed.View all repositories tagged→
- Features
- Feishu/Lark channelFeishu/Lark channelConnect to Feishu/Lark via WebSocket bot with streaming interactive cards.View all repositories tagged→Discord channelDiscord channelConnect a chatbot to Discord via the Bot Gateway API; servers, channels, threads, and voice rooms.View all repositories tagged→WhatsApp channelWhatsApp channelConnect a chatbot or AI gateway to WhatsApp via Baileys with QR-code pairing; supports DMs and groups.View all repositories tagged→Agent SandboxAgent SandboxRun agent tool execution inside isolated Docker containers for a hard security boundary around untrusted code.View all repositories tagged→GatewayGatewayCentral long-running process that owns all channel connections, agent routing, and session state.View all repositories tagged→Streaming previewsStreaming previewsSend a live-editable draft reply and update it token-by-token as the model generates, then finalize in place.View all repositories tagged→Matrix channelMatrix channelConnect to the Matrix protocol for decentralized, self-hostable encrypted messaging on any homeserver.View all repositories tagged→Broadcast groupsBroadcast groupsFan a single inbound message out to multiple agents simultaneously, each with isolated sessions.View all repositories tagged→Skills systemSkills systemInject on-demand SKILL.md capability guides into the agent's context without bloating the base prompt.View all repositories tagged→Nostr channelNostr channelConnect to the Nostr decentralized protocol via NIP-04 encrypted DMs.View all repositories tagged→DM pairingDM pairingExplicit owner-approval step that controls who is allowed to trigger the agent via direct message.View all repositories tagged→Multi-agent routingMulti-agent routingRoute channels, groups, or senders to different isolated agents each with their own workspace, model, and tools.View all repositories tagged→Exec approvalsExec approvalsInteractive button-based approval flow that pauses agent shell commands pending human sign-off in chat.View all repositories tagged→ACP conversation bindingACP conversation bindingPin a chat thread to a persistent Agent Client Protocol workspace so follow-up messages route to the same coding-agent session.View all repositories tagged→Web Control UIWeb Control UIBrowser dashboard for real-time chat, config editing, session inspection, and device management.View all repositories tagged→Telegram channelTelegram channelConnect a chatbot or AI gateway to Telegram via grammY; DMs, groups, forum topics, and inline buttons.View all repositories tagged→Signal channelSignal channelConnect to Signal via signal-cli for privacy-focused end-to-end encrypted messaging.View all repositories tagged→Voice pipelineVoice pipelineSTT/TTS pipeline for real-time voice interaction on macOS, iOS, Android, and Discord voice channels.View all repositories tagged→Slack channelSlack channelConnect to Slack via the Bolt SDK; workspace apps with DMs, channels, and approval buttons.View all repositories tagged→DreamingDreamingBackground memory consolidation pass that promotes high-quality short-term signals into long-term MEMORY.md.View all repositories tagged→Microsoft Teams channelMicrosoft Teams channelConnect to Microsoft Teams via the Bot Framework with enterprise Azure auth and adaptive cards.View all repositories tagged→Multi-channel inboxMulti-channel inboxReceive and reply to messages from many messaging platforms through a single unified gateway process.View all repositories tagged→iMessage channeliMessage channelConnect to Apple iMessage via BlueBubbles REST API with edits, tapbacks, and group support.View all repositories tagged→Google Chat channelGoogle Chat channelConnect to Google Chat via HTTP webhook app for spaces and direct messages.View all repositories tagged→
- License
- MITMITMIT License — permissive, allows commercial reuse with attribution.View all repositories tagged→