🐾 Open Source AI Agent Framework

Meet OpenClaw

Think of it as giving ChatGPT a permanent home on your computer β€” with memory, tools, and the freedom to use any AI model you want.

πŸ’¬ You 🐾 OPENCLAW GATEWAY Memory β€’ Skills β€’ Tools Runs on your machine Claude / GPT Gemini / Llama Any LLM

What Is OpenClaw?

If ChatGPT is like calling a smart friend every time you need help, OpenClaw is like having that friend move in β€” they know your name, remember yesterday's conversation, and can use your tools.

🧠

Persistent Memory

Unlike ChatGPT, OpenClaw remembers across sessions. It writes daily notes, keeps a long-term memory file, and reads them every time it wakes up.

πŸ”€

Any AI Model

Not locked to one provider. Use Claude, GPT-4, Gemini, Llama, or mix and match. Switch models mid-conversation or use different ones for different tasks.

πŸ› οΈ

Real Tools

Reads files, runs code, browses the web, sends messages, manages calendars β€” it actually does things on your computer, not just talks about them.

πŸ’¬

Multi-Channel

Talk to it via Telegram, Discord, Slack, WhatsApp, iMessage, or a web UI. Same agent, same memory, any surface.

πŸ€–

Skills & Plugins

Teach it new abilities by dropping skill files into a folder. Weather checks, GitHub workflows, email management β€” plug and play.

🏠

Runs Locally

The Gateway runs on your machine. Your data stays with you. No corporate cloud storing your conversations.

How Does It All Fit Together?

The Gateway is the brain. It sits on your machine, connects to your chat apps, and routes messages to AI models β€” while managing memory and tools.

CHAT CHANNELS πŸ’¬ Telegram πŸ’¬ Discord πŸ’¬ WhatsApp 🌐 Web UI 🐾 OPENCLAW GATEWAY (runs on your computer) 🧠 Memory Manager πŸ› οΈ Tool Runner πŸ“š Skills Engine ⏰ Cron / Scheduler πŸ” Session Manager & Auth AI MODELS 🟒 Claude 🟑 GPT-4o 🟣 Gemini πŸ”΄ Llama / Local MEMORY FILES πŸ“„ MEMORY.md Long-term memory πŸ“„ SOUL.md Personality πŸ“„ AGENTS.md Operating rules πŸ“„ USER.md About the human πŸ“‚ memory/ Daily notes SKILLS πŸ“¦ weather Check forecasts πŸ“¦ github PRs, issues, CI πŸ“¦ gog Gmail, Calendar πŸ“¦ summarize URLs, PDFs, video EXTERNAL πŸ”Œ MCP Servers 🌐 Web Search / Fetch πŸ“± Phone / Node Devices

The Files That Make It "You"

OpenClaw's personality and memory live in simple text files. You can read and edit them β€” no database or coding required.

πŸ‘»

SOUL.md

The agent's personality. Tone, boundaries, communication style. "Be helpful, have opinions, be concise." Change this to change who the agent is.

πŸ“‹

AGENTS.md

Operating instructions. Rules for every session: when to speak, when to stay quiet, how to handle group chats, safety rules, memory workflow.

πŸ‘€

USER.md

Who you are. Your name, timezone, preferences. The agent reads this every session so it knows who it's talking to.

πŸͺͺ

IDENTITY.md

Who the agent is. Name, emoji, avatar. Created during the first-run setup ritual. The agent's birth certificate.

🧠

MEMORY.md

Long-term memory. Curated knowledge the agent keeps across all sessions β€” projects, preferences, key decisions. Like a personal journal.

πŸ“

memory/YYYY-MM-DD.md

Daily notes. Raw logs of what happened each day. The agent reads today + yesterday on startup for recent context.

πŸ”§

TOOLS.md

Local tool notes. Camera names, SSH hosts, voice preferences β€” anything specific to your setup that helps the agent do its job.

πŸ’“

HEARTBEAT.md

Periodic checklist. Things the agent should check when it "wakes up" periodically β€” emails, calendar, weather, etc.

HOW MEMORY WORKS πŸ’¬ Conversation "Remember this" πŸ“ Daily Notes memory/2026-05-06.md πŸ”„ Review Agent reviews daily 🧠 MEMORY.md Curated wisdom ↩ Loaded into every new session

Connecting to the Outside World

AI agents become truly powerful when they can use external services. OpenClaw connects through a standard called MCP (Model Context Protocol).

πŸ”Œ

What is MCP?

MCP is like a universal adapter. Just as USB-C lets you plug any device into any port, MCP lets AI agents connect to any service β€” databases, APIs, file systems β€” through a standard interface.

🌐

What Can It Connect To?

Google services, Notion, Slack, databases, file storage, code repos, smart home devices β€” if there's an MCP server for it, OpenClaw can use it.

MCP: THE UNIVERSAL ADAPTER 🐾 OpenClaw Agent "Check my calendar" MCP Protocol πŸ“… Google Cal πŸ“ Notion πŸ’Ύ Database πŸ’¬ Slack One standard protocol β†’ connects to anything

Setup in 5 Steps

From zero to a working AI agent in about 5 minutes.

Install OpenClaw

One command in your terminal. Works on Mac, Linux, and Windows. Downloads everything you need automatically.

Run the Setup Wizard

Pick your AI provider (Anthropic, OpenAI, Google, etc.), paste your API key, choose basic settings. Takes 2 minutes.

Meet Your Agent

On first run, the agent asks your name, timezone, and preferences. It writes SOUL.md, USER.md, and IDENTITY.md β€” its birth certificate.

Connect a Chat Channel

Link Telegram, Discord, Slack, or WhatsApp so you can talk to your agent from your phone. Or just use the built-in web chat.

Add Skills & Customize

Install skills for weather, email, GitHub, etc. Edit AGENTS.md to set your agent's rules. Edit SOUL.md to change its personality. It's all just text files.

⬇️ Install 1 command βš™οΈ Wizard API key + model πŸ€– Bootstrap Name + personality πŸ’¬ Connect Telegram / Discord πŸŽ‰ Ready!

Do's & Don'ts

Guidelines for getting the most out of OpenClaw without shooting yourself in the foot.

βœ… Do

  • Start with one chat channel (e.g. Telegram), expand later
  • Edit SOUL.md to shape the agent's personality to your taste
  • Use MEMORY.md to give the agent long-term context about your projects
  • Install skills one at a time β€” test before adding more
  • Keep API keys secure β€” use environment variables, not plain text in config
  • Use cron/heartbeats for periodic tasks (email checks, calendar reminders)
  • Back up your workspace folder regularly
  • Ask the agent to explain what it's doing if unsure
  • Use the web UI dashboard to monitor sessions and costs

❌ Don't

  • Don't share your workspace with untrusted people β€” it contains your data
  • Don't give the agent access to systems you're not comfortable with
  • Don't skip reading agent replies for destructive commands (file deletion, email sends)
  • Don't run the Gateway on a public IP without auth configured
  • Don't put secrets directly in .md files β€” use environment variables
  • Don't expect it to replace human judgment on critical decisions
  • Don't run multiple Gateways on the same machine
  • Don't panic if something breaks β€” check logs, restart the gateway
  • Don't compare it 1:1 with ChatGPT β€” they solve different problems

When to Use What

OpenClaw isn't trying to replace ChatGPT or Gemini. They're different tools for different jobs. Here's an honest breakdown.

Scenario ChatGPT / Gemini OpenClaw Why
Quick one-off question βœ… Better ⚑ Works ChatGPT is instant β€” no setup needed
Image generation (DALL-E, Imagen) βœ… Better ⚑ Supported Native integration in ChatGPT/Gemini is smoother
Voice conversation βœ… Better ⚑ Basic ChatGPT's voice mode is polished and real-time
Mobile-first, casual use βœ… Better πŸ”§ Needs setup ChatGPT app "just works" on your phone
Ongoing project with memory ❌ Forgets βœ… Better OpenClaw maintains memory across all sessions
Running code on your machine ❌ Can't βœ… Better OpenClaw has full local shell/file access
Switching between AI models ❌ Locked in βœ… Better Use Claude for writing, GPT for code, Gemini for research
Automated tasks (cron, monitoring) ❌ Can't βœ… Better OpenClaw runs scheduled tasks, checks email, etc.
Multi-channel (Telegram + Slack + web) ❌ App only βœ… Better Same agent, same memory, any messaging platform
Privacy / data stays local ❌ Cloud βœ… Better Your Gateway, your data, your rules
Team/enterprise use βœ… ChatGPT Team ⚑ Growing ChatGPT Team is mature; OpenClaw is more for power users

🟒 Use ChatGPT / Gemini When…

  • β€’ You need a quick answer and don't want to think about setup
  • β€’ You want polished voice conversations
  • β€’ You're working from a phone without a server
  • β€’ You want built-in image generation or web browsing
  • β€’ You're sharing with non-technical colleagues

πŸ”΅ Use OpenClaw When…

  • β€’ You want an agent that remembers your projects long-term
  • β€’ You need it to actually do things on your computer
  • β€’ You want to pick the best AI model for each task
  • β€’ You value privacy and want data to stay local
  • β€’ You want automation: scheduled tasks, monitoring, alerts

ChatGPT is a smart friend you call.
OpenClaw is a smart friend who lives with you.

It knows your projects, uses your tools, talks on your channels, and works while you sleep. You control it β€” not a company.

πŸ“– Read the Docs ⭐ GitHub