Your AI agent. Every chat app. Your hardware.
openclawOS is a self-hosted gateway that connects Claude, GPT and Gemini to WhatsApp, Telegram, Discord, iMessage, Signal, Slack and 30+ more channels — running on your own machine. No cloud middleman. No data egress. Just one Gateway, every messenger.
Runs on macOS · Linux · Windows (WSL2) · iOS · Android
-
30+
Channels supported
-
534k
Lines of TypeScript
-
MIT
Licensed, forever
-
100+
Contributors
Channels
One Gateway. Thirty+ messengers.
Set up once. Talk to the same agent across WhatsApp, iMessage, Telegram and the rest. Hand the device to your spouse — they'll never know it's the same Pi.
Self-hosted
Runs on your Mac, your Linux box, your home server. Sessions, memory and credentials never leave your network.
Multi-channel
Send a message in Telegram. Get the reply on WhatsApp. Same identity, same context — Gateway routes it all.
Agent-native
Pi ships in the box: tool use, vector memory, vision, multi-turn sessions, branching, compaction.
Open source
MIT licensed. Fork it, audit it, run a private build. We push releases weekly.
Get started
From zero to messaging in 60 seconds.
Pick your installer. Run one command. Pair your favourite messenger. Talk to Pi.
npm install -g openclawos@latest
openclawos onboard --install-daemonRecommended for macOS & Linux. Requires Node 22+.
1. Install
Pick npm, curl, Docker or Homebrew.
2. Pair a channel
openclaw apps install telegram
3. Say hi
Message your bot. Pi responds with tools, memory, context.
Architecture
The Gateway is the kernel. Channels are processes.
openclawOS borrows the OS metaphor: one daemon coordinates routing, sessions and memory; channels and agents are isolated apps you compose. Crash one, the rest keep humming.
Channels
Routes messages, tracks sender identity, isolates sessions per user/group, persists context.
- ● Sessions & memory
- ● Bindings & routing
- ● Auth & secrets
- ● Hooks & cron
- ● Vector store (sqlite-vec)
Agents & providers
Use cases
Real things people run on openclawOS.
It's not just a chatbot. Pi has tools — shell, browser, file system, vector memory. Bindings turn any messenger into a control surface for the rest of your stack.
- Engineering
Code review from your bedroom
Pi reviews open PRs, summarises diffs, surfaces regressions — delivered to your Telegram while you're on the couch.
Read the walkthrough → - Home & IoT
Home automation, conversationally
Trigger Roborock, query Grafana, restart a Bambu print — all from a WhatsApp message. Tool use, not toy use.
Read the walkthrough → - Teams
Private group ops
Spin up an agent inside a Signal group chat. Standups, summaries, action items. End-to-end encrypted by Signal; self-hosted by you.
Read the walkthrough → - Research
Long-running research
Email-to-agent: forward a paper, get a structured summary. Sessions persist, citations linked, memory survives reboots.
Read the walkthrough → - Operations
Customer ops without SaaS
Route Slack DMs, escalate to a human, file a Linear issue, post back to the customer — all in one Pi binding.
Read the walkthrough → - Personal
Personal life-OS
Health stats from Oura, a Notion daily, weather, your calendar — Pi triages it into a single morning brief on iMessage.
Read the walkthrough →
Bring your own LLM
-
Claude (Anthropic)
Recommended: Opus 4.6+
-
GPT (OpenAI)
GPT-4, Codex, Responses
-
Gemini (Google)
Vision + long context
-
GLM
Self-hosted OK
-
MiniMax
Long context
-
Any OpenAI-compatible
Ollama, vLLM, Together…
Writing
Fresh from the lobster tank.
The complete guide to self-hosted AI gateways in 2026
What a self-hosted AI gateway is, why it matters, how openclawOS implements one, and a practical setup walkthrough — from zero to multi-channel agent in an afternoon.
How multi-channel AI agents actually work under the hood
A deep dive into the openclawOS kernel: routing, sessions, identity, memory and the tricky parts of making one agent feel coherent across WhatsApp, Telegram, Discord and the rest.
How to build a self-hosted WhatsApp AI bot in 2026
A practical walkthrough of pairing WhatsApp to a self-hosted AI agent powered by Claude or GPT — using openclawOS, no Meta Business API, no cloud SaaS in the middle.
Welcome to the lobster tank.
Star the repo, join Discord, ship your first agent before lunch.