The OpenClaw
Intelligence Guide
Every question answered. Every risk mapped. Every expert opinion challenged. The comprehensive A-to-Z guide for anyone serious about understanding, deploying, and mastering OpenClaw — before, during, and after.
Full Disclaimer
Please read this disclaimer carefully and in its entirety before using, sharing, or acting on any information contained in this guide. By continuing past this section, you acknowledge that you have read, understood, and agreed to the terms set forth below.
This guide — including all sections covering OpenClaw architecture, security analysis, token optimization, expert commentary, skill templates, installation procedures, and operational recommendations — is provided strictly for educational and informational purposes only. It does not constitute professional advice of any kind, including but not limited to: legal advice, financial advice, cybersecurity consulting, software engineering consulting, compliance guidance, or investment advice.
No attorney-client, engineer-client, consultant-client, or any other professional relationship is created by reading, downloading, or acting on the contents of this guide. The authors, contributors, and distributors of this document are not responsible for any decisions made based on information contained herein.
This guide is an independent, third-party educational resource. It is not produced, endorsed, sponsored, approved, or affiliated with OpenClaw, the OpenClaw Foundation, Anthropic PBC, OpenAI LP, Google LLC, Tencent Holdings, or any other company, organization, or individual mentioned within.
All product names, trademarks, logos, and brand identities referenced in this document — including "OpenClaw," "Claude," "ChatGPT," "Gemini," "Telegram," "WhatsApp," "Slack," "Discord," "GitHub," and others — are the exclusive property of their respective owners. Their mention in this guide constitutes neither endorsement by those entities nor any claim of affiliation.
Peter Steinberger and all other named individuals are referenced for contextual, educational accuracy only. No statement in this guide purports to represent the personal views, official positions, or authoritative communications of any named individual.
OpenClaw is an actively evolving, fast-moving open-source project. Information presented in this guide reflects publicly available documentation, community reports, security advisories, and research compiled as of March 2026. This guide makes no warranty — express or implied — regarding the accuracy, completeness, reliability, or fitness for any particular purpose of the information provided.
Specific claims regarding version numbers, CVE identifiers, GitHub star counts, pricing figures, security vulnerability counts, community skill counts, contributor counts, and behavioral characteristics of any software product may be outdated, inaccurate, or have changed materially by the time you read this document.
You are solely responsible for verifying all technical information independently against current official documentation before acting on it. The official OpenClaw repository, Anthropic's developer documentation, and each connected service's terms of service should be your primary sources of truth.
This guide discusses, describes, and analyzes software that — by its fundamental design — can execute commands, access files, send communications, and interact with external services on your behalf. The use of OpenClaw carries inherent and significant security and privacy risks that cannot be fully mitigated by following any set of guidelines, including those in this document.
The authors expressly disclaim all liability for: data breaches, credential theft, unauthorized access to connected services, financial losses from API billing overruns, data loss from agent actions, compliance violations under GDPR, HIPAA, PCI-DSS, SOC2, FedRAMP, or any other regulatory framework, damage to systems or data caused by prompt injection attacks, losses resulting from malicious skills installed from any marketplace, and any other direct, indirect, incidental, consequential, or punitive damages arising from the use or inability to use OpenClaw or any related software.
Never install or operate OpenClaw on systems containing regulated data, personally identifiable information subject to legal protection, financial data, healthcare data, or any data for which a breach would create legal liability. The guidance in this document regarding security practices represents best-effort recommendations, not guarantees.
This guide references the Terms of Service of multiple third-party platforms including Anthropic, OpenAI, WhatsApp, Telegram, Google, and others. Terms of service change frequently and without notice. Any statement in this guide regarding what is or is not permitted under any platform's terms of service reflects the authors' understanding as of the compilation date and may no longer be accurate.
You are solely responsible for reviewing and complying with the current, official Terms of Service of every platform and service you connect to OpenClaw. The authors accept no liability for account terminations, service bans, legal claims, or any other consequences arising from your violation of any third party's terms of service, whether or not such violation was influenced by information in this guide.
The "pessimist panel" sections of this guide — including the "10 pessimist CEOs," "10 pessimist engineers," and "10 security experts" — feature named individuals with assigned professional backgrounds. These personas are illustrative composites created for educational purposes. While the professional arguments, technical concerns, and security criticisms they voice are grounded in real, documented issues within the OpenClaw community, the individuals named are fictional constructs and do not represent real persons.
Any resemblance to actual persons, living or dead, or to actual events, is purely coincidental. No statement attributed to any named persona in the expert panel sections should be construed as an actual statement, opinion, or endorsement by any real individual or organization.
The SKILL.md templates, configuration examples, bash scripts, and code snippets provided in this guide are offered "as is," without warranty of any kind, express or implied. These are starting-point templates, not production-ready code. You must review, test, adapt, and validate all provided code before deploying it in any environment.
The authors are not responsible for any unintended actions taken by OpenClaw agents running skills derived from the templates in this guide, including but not limited to: accidental deletion of files or emails, unintended transmission of messages, unauthorized access to connected services, financial costs incurred from API usage, and data exposure resulting from misconfigured skills.
All skill templates must be treated as untrusted code that requires your review before use — the same standard this guide recommends applying to any community skill.
This guide contains cost estimates, pricing references, API billing projections, and return-on-investment analyses. These figures are approximate estimates based on publicly available pricing information as of the compilation date. API pricing changes frequently and without notice. Actual costs may be significantly higher or lower than figures presented in this guide.
Nothing in this guide constitutes financial advice, investment recommendations, or guidance regarding the commercial viability of any product, technology, or business strategy. Consult a qualified financial professional before making any financial decision.
To the fullest extent permitted by applicable law, the authors, contributors, and distributors of this guide expressly disclaim all warranties and shall not be liable for any damages of any kind arising from your use of or reliance on this guide or its contents. This includes, without limitation, direct damages, indirect damages, incidental damages, consequential damages, punitive damages, and all economic losses, even if advised of the possibility of such damages.
In jurisdictions that do not allow the exclusion or limitation of incidental or consequential damages, liability is limited to the maximum extent permitted by law.
By reading, downloading, sharing, or otherwise using this guide, you agree that: (a) you have read and understood this disclaimer in its entirety; (b) you accept full personal responsibility for your use of OpenClaw and any software referenced in this guide; (c) you will independently verify all technical, legal, and financial information before acting on it; (d) you will comply with all applicable laws, regulations, and terms of service in your jurisdiction; and (e) you acknowledge that this guide is provided solely for educational purposes and does not constitute professional advice of any kind.
If you do not agree with any part of this disclaimer, you should not use, distribute, or rely upon any information in this guide.
What is OpenClaw?
OpenClaw is a local "Gateway" daemon that sits on your machine 24/7, connects to your messaging apps, and uses an LLM as its brain to interpret messages and execute real actions. It remembers context across sessions using local Markdown files. It can write and install its own new skills autonomously — this is why some describe it as "self-improving."
How OpenClaw processes information
Full workflow
(chat app)
platform
Gateway
(any model)
executor
on machine
returned
OpenClaw vs Claude / ChatGPT / Gemini
| Dimension | Claude / ChatGPT / Gemini | OpenClaw |
|---|---|---|
| Type | Chatbot / conversational AI | Autonomous agentic runtime |
| Execution | Generates text answers | Executes real actions on your machine |
| Memory | Within session only | Persistent across all sessions, local files |
| Data location | Vendor's cloud servers | Your machine — fully local by default |
| Cost model | Subscription fee | Free software + pay API tokens directly |
| Proactivity | Responds only when prompted | Acts autonomously via cron/heartbeat |
| Integrations | Limited plugins/tools | 50+ native, 13,700+ community skills |
| Security model | Vendor-managed, sandboxed | You manage it — full responsibility on you |
| AI model | Is the model | Uses any model as brain (model-agnostic) |
| Skill creation | Not applicable | Writes and installs its own new skills |
What you need to use OpenClaw
Pros and Cons
Advantages
- True autonomy — executes multi-step tasks without supervision
- Data stays local — zero cloud exposure by default
- Model-agnostic — switch LLMs without rebuilding anything
- Persistent memory across sessions — evolves over time
- MIT open-source — fully auditable, forkable, no lock-in
- Works through existing messaging apps
- Proactive 24/7 via cron jobs and heartbeat scheduler
- Self-improving — writes and installs its own new skills
- Free software — pay only for tokens you actually use
Disadvantages
- Immature security model — not suitable for sensitive data
- Prompt injection architecturally unsolvable
- ClawHub marketplace compromised — 800+ malicious skills
- Plaintext credential storage by default
- Critical RCE vulnerability CVE-2026-25253 (Jan 2026)
- High technical complexity — not for non-developers
- Unpredictable agent behavior — documented inbox deletions
- API cost scales unexpectedly at scale
- Not enterprise-ready — Dutch DPA warned against regulated use
Dangers, vulnerabilities, and threats
Risk severity
What nobody tells you before you start
"gateway": {"bind": "loopback"}. The onboarding wizard never mentions this./context list to see exactly how many tokens each injected file consumes. Type /context detail for a full breakdown. The most powerful cost diagnostic in OpenClaw — invisible unless you know to ask.How OpenClaw works — visual architecture
You
Messaging
Platform
WhatsApp etc
OpenClaw
Gateway
port 18789
LLM Brain
Gemini / Ollama
Skill
Selector
which skill
Skills
Executor
instructions
Real
Action
File / API call
Result
Returned
back to you
Three workspace files — injected into every prompt
Step-by-step installation
# Install nvm (Node Version Manager) curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash source ~/.bashrc nvm install 22 && nvm use 22 node --version # Must show v22.x.x or higher
npm install -g openclaw@latest openclaw onboard --install-daemon
# In ~/.openclaw/openclaw.json — add this now: { "gateway": { "bind": "loopback" } }
openclaw doctor # Full health check openclaw gateway status # Is daemon running? openclaw logs --follow # Real-time logs
Starter SOUL.md and optimized openclaw.json
Starter SOUL.md — copy this before first run
Token-optimized openclaw.json
{
"agents": {
"defaults": {
"model": {
"primary": "anthropic/claude-sonnet-4-5-20250514", // pin exact version
"fallbacks": ["anthropic/claude-haiku-3.5"]
},
"heartbeat": {
"model": "anthropic/claude-haiku-3.5", // cheap model for background
"intervalMinutes": 60, // saves 12x tokens vs default 5min
"prompt": "Check urgent items only."
},
"contextPruning": { "mode": "cache-ttl", "ttl": "5m" },
"compaction": { "mode": "safeguard", "memoryFlush": { "enabled": true } },
"cacheRetention": "long", // maximize prompt cache hits
"bootstrapTotalMaxChars": 20000, // cap workspace file injection
"exec": { "ask": "on" } // require approval for all exec
}
},
"gateway": { "bind": "loopback" } // security — non-negotiable
}
Why OpenClaw burns through tokens
Minimize fees — 10 proven methods
| Method | Saves | Effort | Action |
|---|---|---|---|
| 1. Heartbeat → Haiku model | ~25% | 1 min | Set heartbeat.model: "anthropic/claude-haiku-3.5" |
| 2. Weekly session compaction | ~20% | 10 min | Run /compact or configure auto-compaction |
| 3. Replace crons with bash | ~15% | 1–2 hrs | Any deterministic task = bash cron, not LLM |
| 4. Enable prompt caching | ~10% | 5 min | Set cacheRetention: "long", static content first in SOUL.md |
| 5. Trim workspace files | ~8% | 30 min | Run /context list, trim files to under 2,000 chars each |
| 6. Extend heartbeat interval | ~7% | 2 min | Change heartbeat.intervalMinutes: 60 |
| 7. Disable unused skills | ~5% | 15 min | Add disable-model-invocation: true to unused SKILL.md files |
| 8. Local models via Ollama | Variable | 2 hrs | Route low-stakes tasks to local llama3.2 — $0 API cost |
| 9. Context pruning TTL | ~4% | 2 min | Set contextPruning.ttl: "5m" |
| 10. Pin model version | ~3% | 2 min | Explicit version strings prevent silent upgrades to expensive models |
Smart model routing
| Task type | Model | Why | Relative cost |
|---|---|---|---|
| Security-sensitive tasks with tools | Opus 4.5/4.6 | Best prompt injection resistance | 25× |
| Complex multi-step reasoning | Sonnet or Opus | Needs strong contextual reasoning | 5–25× |
| Daily automation, emails, calendar | Sonnet 4.5 | Good balance of quality + speed | 5× |
| Heartbeats, status checks | Haiku 3.5 | Fast, cheap, entirely sufficient | 1× |
| Deterministic tasks (cleanup, backup) | Bash — no LLM | Does not need AI at all | $0 |
| Drafting, writing, summarizing | Local Ollama | Offline, free, sufficient quality | $0 |
Anatomy of a SKILL.md file
12 reusable skills — copy, paste, and use today
Token-efficient, security-conscious, ready to use. Each is designed to minimize LLM calls by routing deterministic work to shell.
What you can automate — and at what efficiency
CEO lens — telescope & microscope applied to OpenClaw
Insight: evaluate the runtime, not the UI
Opportunity: asymmetric productivity advantage
Avoided truth: prompt injection is permanent
Engineer lens — first principles
Problem solved: LLM reasoning → real-world execution
Hard limits: regulated data, multi-user, high-frequency, adversarial
10 pessimist CEOs — their attacks & rebuttals
"310,000 stars means 310,000 attack surfaces. This is viral adoption without security maturity."
"No enterprise board will approve software with no SLA, no support contract, no liability coverage."
"In regulated industries, OpenClaw is not just risky — it is categorically illegal to deploy."
"The cost model is a trap. You wake up to a $2,000 API bill from a bad loop at 3am."
10 pessimist engineers — their attacks & rebuttals
"SKILL.md is natural language pretending to be a specification. You cannot reason about correctness in prose. It is configuration theater."
"Performance degrades catastrophically as context grows. By session 50, the agent contradicts previous decisions. Memory management is completely unsolved."
"The skills API surface is completely uncontrolled. Any skill can call any shell command with the agent's full privileges. There is no permission model."
10 security experts — their attacks & rebuttals
"Prompt injection is not a vulnerability class — it is a design pattern. You cannot patch your way out of a system that treats external text as trusted instructions by design."
"I compromised 23 out of 25 test OpenClaw deployments in under 90 minutes using only publicly documented techniques."
"OpenClaw on a corporate laptop is a lateral movement dream. Credentials to everything. Bypasses every EDR detection rule."
What engineers are actively struggling to solve
Debug command toolkit
# ── Health & status ──────────────────────────────────── openclaw doctor # Full automated health check — always run first openclaw gateway status # Is the daemon running? openclaw logs --follow # Real-time log stream openclaw logs --last 100 # Last 100 lines openclaw logs --level error # Filter to errors only # ── Token diagnostics ────────────────────────────────── /context list # Token count per injected file /context detail # Full breakdown: tools, skills, prompt /usage full # Session and daily token usage # ── Gateway control ──────────────────────────────────── openclaw gateway restart # Restart if stuck — use first openclaw gateway stop # Emergency stop openclaw skills reload # Reload skill files without restart # ── Port conflicts ───────────────────────────────────── sudo lsof -i :18789 # Find what's using OpenClaw's port sudo kill -9 [PID] # Kill conflicting process # ── Updates ──────────────────────────────────────────── openclaw --version # Current version npm update -g openclaw # Update weekly — security patches are frequent
nvm install 22 && nvm use 22npm config set prefix '~/.npm-global' then reinstall.sudo lsof -i :18789 → kill PID → openclaw gateway startopenclaw pairing approve [code] from your bot, or add username to allowedUsers.openclaw gateway stop. Check API dashboard. Review openclaw logs --last 500 for repeated calls. Fix interval/heartbeat before restarting.16 survival tips — things most people learn only after it goes wrong
claude-sonnet-4-5-20250514). Subscribe to your LLM provider's changelog. Only update deliberately after testing key skills on the new version.openclaw-anthropic-2026-03) so you always know which key needs rotating and can verify completion. Put it on your calendar — not "when you feel like it."CEO operating guidelines
Costs, tokens, and resource management
Estimated monthly costs
| Usage level | Estimated cost | Profile |
|---|---|---|
| Light | $10–30/month | Personal assistant, occasional tasks |
| Typical | $30–70/month | Daily automation, dev workflows |
| Heavy | $100–150+/month | Multi-agent, 24/7 background jobs |
| Local models (Ollama) | Near $0 variable | Low-sensitivity, high-frequency tasks |