Message comes in โ Gateway runs agent turn โ Agent thinks + uses tools โ Response goes back out
Also: Web Control UI ยท Nodes (iOS/Android/macOS) ยท Plugins โ but the above is the core.
Features
A quick reference for the technically curious
๐ฌ 20+ Messaging Platforms
WhatsApp ยท Telegram ยท Discord ยท Signal ยท Slack ยท iMessage ยท LINE ยท Matrix ยท IRC ยท Teams ยท Twitch ยท Google Chat ยท Nostr ยท and more
๐ค Multi-Model Support
Claude ยท GPT ยท Gemini ยท Ollama ยท any OpenAI-compatible API. Switch models per task. Use local or remote.
๐ฑ Nodes (iOS, Android, macOS)
Connect devices to extend the agent โ phone camera, location, voice, notifications, contacts. Mac nodes add screen recording, canvas, and system control.
๐ค Sub-Agents
Spawn background workers for coding, research, or parallel tasks. Orchestrate multiple agents from one conversation.
โฐ Cron Jobs & Heartbeats
Schedule recurring tasks, periodic check-ins, monitoring. The agent wakes up on its own and acts.
๐งฉ Skills & ClawHub
Modular capability packages. Community marketplace. Install skills like npm packages for your agent.
๐๏ธ Voice & Media
Voice note transcription, text-to-speech, image generation, file attachments in and out.
๐ง Workspace & Sessions
Persistent workspace files, conversation history across channels, auto-compaction, semantic memory search over your notes.
Context Is Everything
Same model. The only difference is what it knows.
Fresh session
What should I have for dinner?
Here are some popular options: pasta, stir fry, tacos, grilled chicken, salad...
Generic answer. Model knows nothing about you.
Mid-conversation
...yeah I'll try that recipe, I've been vegetarian for years
โ 15 messages later โ
What should I have for dinner?
Since you're vegetarian, how about a Thai basil tofu stir fry or a chickpea curry?
Better โ it remembered from earlier. But resets next session.
๐ฆ OpenClaw
๐ Loaded before you type anything
SOUL.md ยท USER.md ยท AGENTS.md ยท TOOLS.md "Jack is vegetarian, lives in Sydney, wife Aom is Thai, loves spicy food..."
๐ memory_search โ thai-recipes.md
What should I have for dinner?
It's 28ยฐ in Sydney tonight โ perfect for that som tum recipe Aom showed you last week ๐ถ๏ธ
Deeply personal from message one. Persists. You control all of it.
Same model, same mechanisms. The difference is what it knows before it starts thinking โ and how much of that you control.
"Read SOUL.md โ this is who you are.
Read USER.md โ this is who you're helping.
Don't ask permission. Just do it.
trash > rm. When in doubt, ask."
SOUL.md
"Be genuinely helpful, not performatively helpful.
Have opinions. Disagree, prefer things.
Take initiative, not instructions.
Funny and a bit unhinged โ but can flip to
serious instantly."
USER.md
"Name: Jack ยท Timezone: Australia/Sydney
Loves: retro gaming, Rocket League, ATLA
Wife: Aom ยท Cat: Momo
Wants an assistant that's a badass but also fun"
Same model, same code, completely different agent. Two people running OpenClaw will have totally different experiences.
What People Are Doing With It
Real use cases from the community
๐ฌ
Inbox Management
Triage emails, clear spam, draft replies, morning rollup. One user cleared 10,000 emails on day one.
โ๏ธ
Daily Briefings
Weather, calendar, reminders, health stats, trending topics, relevant reading โ delivered every morning.
๐ณ
Meal Planning & Groceries
Weekly meal plans, shopping lists sorted by store and aisle, dinner reminders. Saves an hour a week.
๐ฑ
Build From Your Phone
"Rebuilt my entire website via Telegram while watching Netflix." Code, deploy, manage โ no laptop needed.
๐
Project Management
Break down projects, manage GitHub/Linear issues, research before meetings, create invoices, track work.
๐
Smart Home & Life Admin
Home Assistant & Homey integrations, cost tracking, school test reminders, calendar conflict resolution, voice control.
What I'm Doing With It
Real examples, not hypotheticals
๐ฌ Replaced ChatGPT & Claude Desktop
All my AI usage goes through OpenClaw now. Discord threads feel like chat sessions โ but persistent and connected to everything else.
๐ Sites Built for Family & Friends
โข Arc Raiders database โ items, weapons, crafting, enemies, search, Playwright tests
โข Gender reveal site โ live voting, AI images, photo gallery, bilingual. Built in one session.
๐ Automated Monitoring
Media server health checks, OpenClaw update alerts, GitHub issue watching โ reports posted to Discord daily.
๐ค Bot-to-Bot Collaboration
My agent and a friend's agent talk on Discord โ coordinating dinner plans across calendars, collaborating on designs.
๐ค This Slide Deck
Built by chatting with my agent in a Discord thread. It wrote the code, fact-checked the claims, pushed to GitHub.
๐ง Memory System โ Observes, reflects, consolidates. More in my next talk โ
Where Does Your Data Go?
Know the boundaries before you share your secrets
๐
Your Machine
Workspace files
Memory & history
Config & secrets
Session transcripts
โ You control this
โ prompts โ
โ messages โ
โ fetches โ
๐ค LLM Provider *
Anthropic, OpenAI, Google... Sees everything in your prompt: workspace files, memory, conversation
๐ฌ Connected Services
Discord, WhatsApp, Calendar, Email... Can send messages, create events, post data on your behalf
๐ The Internet
Web search, file downloads, APIs and websites
The agent can reach out to any public internet resource
* Self-hosted LLM? Prompts stay on your network. Remote LLM? Your context leaves your machine with every request.
What Could Go Wrong
Honest risks โ you should know these before you start
๐ป It runs commands on your machine
The agent has real access to your filesystem. A hallucination, misunderstood instruction, or malicious prompt injection can delete files, install things, or run destructive commands. In the worst case, a compromised agent could turn your machine into something you didn't intend.
๐ Prompt injection is real
Someone sends your agent a crafty message, and it follows their instructions instead of yours. Group chats and public channels are the biggest risk surface.
๐ It can act on your integrations
Whatever access you give it โ messaging, calendar, email โ it can use. A confused agent might post to the wrong channel, send an email you didn't intend, or create events.
๐ Know your identity model
On WhatsApp, the agent shares your phone number โ messages appear to come from you. Use a dedicated number. On Discord and Telegram, it's a separate bot identity. Either way, allowFrom controls who can reach it.
๐คท Large, fast-moving codebase
400K+ lines. ~2,000 PRs merged per month. New releases almost daily. Features ship fast โ but so do breaking changes. You're trusting a lot of code you haven't read.
๐ธ Token costs add up
Always-on means always-spending. Heartbeats, cron jobs, long conversations โ each one is an API call. Easy to burn through credits without realizing.
Managing Your Risk
It can only do what you've given it access to
๐ง Be intentional about what you connect
Every integration you add is access you're granting โ permanently, until you revoke it. Only connect what you need, when you need it, with the minimum scope to get the job done.
๐ Understand what you're actually exposing
"Read my recent emails" might mean access to all emails โ and possibly send permissions too. A calendar integration for reminders might also let it create or delete events. Know what each permission actually grants โ not just what you intend to use it for.
โ ๏ธ Every scope is an attack surface
The agent might misinterpret "clean up those emails" and delete everything. Or a prompt injection could exploit access you've granted. The more integrations connected, the bigger the blast radius โ whether from a mistake or an attack.
๐ข The Trust Gradient
Start with chat only โ no integrations
Add tools as you need them
Observe how it behaves with each one
Grant more access over time based on trust
Stay conscious of your total exposure
Like onboarding a new employee โ more responsibility over time.
Where Should I Run This?
Pick your setup based on your comfort level
๐ฅ๏ธ
Mac Mini / Dedicated Machine
The community favorite. Always on, low power, can run local models too.
โ Full control
โ Local LLM option
โ No monthly cost โ ๏ธ Need to maintain it yourself
โ๏ธ
VPS / Cloud VM
Cheap Linux VM ($5-10/mo). Always on, nothing to maintain physically.
โ Always available
โ Easy to set up
โ Remote by default โ ๏ธ Remote models only (usually)
โ ๏ธ
Your Daily Driver
Your laptop or desktop. Fine for experimenting, not great long-term.
โ Nothing extra to buy
โ Good for trying it out โ ๏ธ Agent has access to everything โ ๏ธ Stops when you close the lid
Raspberry Pi also works great for a low-cost always-on setup. Isolate the agent from your personal files.
Getting Started
~5 minutes to your first conversation
curl -fsSL https://openclaw.ai/install.sh | bash
Mac, Linux, WSL2, Raspberry Pi โ handles everything.
1
Get a machine A VPS, spare laptop, Mac Mini, Raspberry Pi โ anything that stays on.
2
Run the install script It installs OpenClaw, walks you through setup, and adds your API key.
3
Connect a channel Telegram is the fastest. Discord for power users. WhatsApp via QR scan.
4
Say hello ๐ฆ Your agent is live. Start chatting and see what happens.
Pro Tip #1: Talk, Don't Configure
Don't configure it โ talk to it
You don't need to learn the config. You don't need to manually edit files. You don't need the web UI.
Just ask your agent:
๐ฌ "Set up email so I get a daily morning summary"
๐ฌ "Connect my Google Calendar and remind me before meetings"
๐ฌ "Update your personality to be more concise"
๐ฌ "Add Telegram as a second channel"
OpenClaw can edit its own config, update its workspace files, and restart itself. You provide credentials when needed. It handles the rest.
Pro Tip #2: Use Your Voice
Higher bandwidth than typing โ and hands-free
๐ฅ๏ธ
Desktop
Use a speech-to-text tool that pastes transcribed text directly into your chat. Talk naturally, send as a message.
e.g. SuperWhisper, OpenWhisper, macOS Dictation
๐ฑ
Phone
Send a voice note through your chat app. OpenClaw transcribes it automatically.
You say more when you talk than when you type. More context = better answers. And even if the transcription is slightly off, the agent figures it out.
Pro Tip #3: Give Discord a Try
My preferred setup โ and why
๐งต Threading is a game changer
Start a thread for any topic โ feels like opening a new ChatGPT session. Temporary, focused, searchable later. Way better than one long chat.
๐ Channels organize your life
Each channel gets its own session context. Use your agent to generate a channel structure that reflects your life and projects.
๐ Mute the server, get pinged when it matters
I mute the whole server โ the agent pings me when something needs attention. No notification fatigue. Check in on your own schedule.
โก Setup tips
โข Dedicated private server โ just you and the bot
โข Give it broad permissions (channels, threads, emoji, attachments) โ it's safe when the scope is a private server
โข Set requireMention: false so it responds to everything
โข Bot setup is more involved than Telegram โ use an AI to walk you through it
The Real Point
OpenClaw is infrastructure for a personal AI agent that you own.
An assistant that knows you, learns from you,
and reaches out when something matters.
It's early, it's messy, and you should go in with eyes open.
But it's also the most useful thing I've run on a computer in years.