OpenClaw is an open-source autonomous AI agent by Peter Steinberger that transforms LLMs into always-on personal assistants. Unlike ChatGPT or Claude's web interface, OpenClaw runs on your machine, remembers everything, connects to your messaging apps, and takes real-world actions.
What Makes OpenClaw Different
Most AI interfaces are stateless. You open ChatGPT, chat, close the tab, and the AI forgets everything. OpenClaw is the opposite:
- Runs continuously as a background service
- Maintains persistent memory across sessions
- Communicates through Telegram, Discord, WhatsApp, Signal, Slack, iMessage
- Proactively checks your calendar, email, and projects
- Fully open-source — your data never leaves your machine
The key distinction is autonomy. OpenClaw doesn't just respond to messages. It can proactively check your calendar, monitor email, run scheduled tasks, and alert you when something needs attention.
Prerequisites
Before installing, you need three things:
| Requirement | Details |
|---|---|
| Machine | VPS, Raspberry Pi, home server, or laptop that stays on |
| Node.js | Version 20 or higher |
| AI API Key | Anthropic (Claude), OpenAI (GPT), or Google (Gemini) |
For best results, use Claude Sonnet 4.6 or Opus 4.6 as the default model. OpenClaw supports model routing — cheap models for routine tasks, expensive ones for complex work.
Installation (3 Steps)
Step 1: Install globally via npm:
npm install -g openclaw
Step 2: Run the setup wizard:
openclaw setup
The wizard walks through provider selection, API key configuration, and basic settings.
Step 3: Start the gateway:
openclaw start
The gateway manages channel connections, session state, the agent loop, model calls, and tool execution. It runs as a background daemon and auto-restarts.
Connecting Messaging Channels
| Channel | Setup Difficulty | Method |
|---|---|---|
| Telegram | Easy | Create bot via BotFather → paste token |
| Discord | Easy | Create app in Developer Portal → paste token |
| Medium | QR code pairing flow | |
| Signal | Medium | Signal CLI setup |
| Slack | Easy | Slack app + bot token |
| iMessage | Mac only | Native macOS integration |
Configure any channel with:
openclaw configure --section telegram
You can connect multiple channels simultaneously. The AI maintains context across all of them.
The Workspace Files
OpenClaw uses plain Markdown files for all configuration and memory:
| File | Purpose |
|---|---|
| SOUL.md | AI's personality, tone, behavior rules |
| USER.md | Your name, timezone, preferences |
| MEMORY.md | Long-term curated memory |
| HEARTBEAT.md | Checklist of things to monitor periodically |
| memory/*.md | Daily session logs |
SOUL.md is the most important — it defines how your AI acts. Example: "Be direct, use casual language, check my calendar every morning, never send emails without asking."
MEMORY.md is the AI's brain. It writes important decisions, preferences, and context here. This persists across sessions and the AI curates it over time.
The Skills System
Skills give OpenClaw capabilities beyond conversation. Each skill is a directory with a SKILL.md instruction file.
- Built-in: web browsing, file management, shell commands, code editing
- Community skills on ClawhHub: weather, security audit, SSH, camera control
- Install with: `openclaw skill install weather`
- Create custom skills by writing instructions in plain English
Skills make OpenClaw extensible without traditional code — you write instructions in plain English and the AI follows them.
Heartbeats: Proactive Behavior
The heartbeat system transforms OpenClaw from a reactive chatbot into a proactive assistant.
openclaw configure --section heartbeat
Set the interval (every 30 minutes is common), active hours (avoid 3 AM notifications), and what to check. The AI can also create its own HEARTBEAT.md checklist.
Example heartbeat tasks:
- Check for unread emails
- Alert on upcoming calendar events
- Monitor project git status
- Check weather before you go out
- Review and organize memory files
Cron Jobs
For precise timing, OpenClaw supports cron scheduling. Each job can use a different model.
| Example | Schedule | Model |
|---|---|---|
| Daily briefing | 8:00 AM | Sonnet (cheap) |
| Weekly security audit | Monday 9 AM | Opus (thorough) |
| Stock price check | Market open | Haiku (fast) |
| News digest | 6:00 PM | Sonnet |
Multi-Agent Architecture
Advanced setups run multiple AI agents, each with its own personality and schedule:
Each agent gets its own SOUL.md and operates independently. Agents can communicate through OpenClaw's session messaging.
Security
| Feature | Description |
|---|---|
| Tool policies | Control what the AI can/cannot do |
| File restrictions | Limit access to specific directories |
| Approval prompts | Require confirmation for destructive actions |
| Local storage | All data stays on your machine |
| No telemetry | Zero tracking or data collection |
Getting Started Today
The fastest path: install with npm, run setup, connect Telegram, start chatting. 15 minutes total.
For those tired of AI interfaces that forget everything and require constant context-setting, OpenClaw represents a fundamentally different approach — an AI assistant that actually assists, continuously and autonomously.
