changelogs.info
OpenClaw Claude Code Codex Gemini Kilo Code Hermes Models Dispatches
OpenClaw Changelog Guide
OpenClaw

OpenClaw

OpenClaw is the orchestration layer that connects your AI agents to everything else. Think of it as the switching fabric — a local gateway process that routes messages between whatever channels you want (Telegram, Discord, Slack, Signal, iMessage, webhook) and whatever AI models you're running (Anthropic, OpenAI, OpenRouter, Google, local Ollama). It's the glue that makes your AI actually reachable, not just some API key you forget about.

The core idea is clean: you run one gateway, you attach channels to it, and you attach agents to those channels. Each agent gets its own workspace — a directory of plain markdown files that serve as its memory, skills, and context. No proprietary formats, no cloud sync required, no vendor lock-in. Just files you can read, edit, version control, and actually understand. That's kind of the whole philosophy — your agent's brain should be inspectable.

What I actually like about it is the model agnosticism. You're not locked to one provider. You can run Claude on your personal agent, GPT-4o on your work agent, Gemini for research tasks, and a local Ollama model for anything sensitive — all routing through the same gateway. Switching models is literally a config change, not a rewrite. When a new model drops and everyone's losing their minds on Twitter about it, you just swap the model string and you're running it.

The skills system is where it gets genuinely interesting. Skills are just directories with a SKILL.md file — no special build step, no packaging nonsense. You write instructions in plain English, drop in a script or two, and your agent knows how to use a new tool. There's a whole community hub at clawhub.ai where people share skills, or you can just write your own. It's basically giving your agent new abilities on demand.

Setup is a openclaw onboard wizard that walks you through creating your first agent, then a openclaw gateway start to bring the router online. From there you can validate everything in the browser dashboard before touching any external channels. That's the move — dashboard first, then Telegram, then Discord. Don't set up bots before you know the core stack is working. openclaw doctor is your best friend here — run it when anything's off and it'll tell you exactly what's broken.

The fleet model is what separates it from just running a bot. You can have multiple agents — one for coding, one for research, one for ops — each with its own personality, model, and skill set, all running through one gateway. They share memory through a semantic memory pool (Mem0 + Qdrant), so when your research agent learns something, your coding agent can access that knowledge too. It's not a single chatbot, it's an actual agent team.

What about reliability? The gateway runs locally on your machine — your Mac, a VPS, a Pi, whatever. No cloud dependency for the core routing. Your channels connect out to their APIs, but the brain stays local. That means no outages because some SaaS provider had a bad deploy. Your agents, your hardware, your rules.

The ACP runtime lets you wire in coding agents like Claude Code, Codex, Gemini CLI — they run as subprocesses under OpenClaw's management. So you can literally message your agent on Telegram and say "build me a landing page" and it spawns Claude Code to do the work, reports back when it's done. That's the kind of workflow that sounds like sci-fi but it's literally just a config file and a tmux session.

Mobile support is solid too — there's companion apps for iOS and Android that pair with your gateway via QR code. So you're walking around, idea hits you, you tell your agent, and it's already working on it by the time you sit down at your desk. Pair that with the voice-to-text pipeline and it basically becomes an always-available chief of staff.

Who's it for? People who want their AI available everywhere, not just in one app. Builders who are tired of one-off bot setups and want a proper agent infrastructure. Teams who need AI that's actually connected to their tools and workflows. If you've ever wished your AI assistant was in your phone, your terminal, and your team chat simultaneously — that's exactly what OpenClaw does. It's not a chatbot wrapper, it's the infrastructure layer for making AI agents real.

vv2026.8.1-beta.3 OpenClaw 2026.8.1-beta.3 Aug 24, 2026
## Highlights - GPT-5.6 Sol, Terra, Luna, and Ultra reasoning support across OpenClaw and the Codex runtime. - Control UI first-run setup now continues verified model setup into Custodian and optional channel setup. - Puppeteer-compatible CDP relay support for paired Chrome sessions. - Explicit external Gateway lifecycle supervision with verified restart handoff. - Compact, verified SQLite backup and fresh-target restore commands. - Shared durable ingress monitors for channel plugins. ## Publication evidence - npm: https://www.npmjs.com/package/openclaw/v/2026.8.1-beta.3 - Registry tarball: https://registry.npmjs.org/openclaw/-/openclaw-2026.8.1-beta.3.tgz - Integrity: `sha512-8v+2Knr+0i1qzWXgJmtcBg78VaoMENahLxcuThOqyCmVaCGPj++mI9yv0R440wMv9Siv4fysd5e0YmBVftDvuQ==` - Core npm preflight: https://github.com/openclaw/openclaw/actions/runs/32687267214 - Core npm publication: https://github.com/openclaw/openclaw/actions/runs/32689503061 - Official plugin publication and reconciliation: https://github.com/openclaw/openclaw/actions/runs/32680190375 - All 89 official npm plugins were read back at `2026.8.1-beta.3` with the `beta` selector and complete tarball integrity metadata. - `@openclaw/codex@2026.8.1-beta.3` ships the exact managed `@openai/codex@0.149.1` runtime. See [`CHANGELOG.md`](https://github.com/openclaw/openclaw/blob/v2026.8.1-beta.3/CHANGELOG.md) for the complete release notes.
View on GitHub ↗
02

Power Tips

Non-obvious leverage

Quick Wins

01
Doctor first, always

Before debugging anything, run this. It catches broken services, invalid config, bad auth, orphan sessions, and cron drift — before you waste 30 minutes guessing.

openclaw doctor
02
Dashboard before any messaging app

The dashboard proves gateway + auth + model + workspace all work without setting up Telegram/Discord first. Always validate here first.

openclaw dashboard
03
Memory is just Markdown

Long-term memory lives in plain .md files in your workspace. You can read, edit, and grep them directly. No magic black box.

ls ~/.openclaw/agents/*/workspace/memory/
04
Check which skills actually run

Installed ≠ runnable. Skills can be blocked by missing binaries or env vars. This shows you what's actually ready.

openclaw skills check
05
Tail the gateway log live

When a channel isn't responding, this shows you exactly what's happening at the routing layer.

tail -f ~/.openclaw/logs/gateway.log
06
Deep status for channel issues

Regular status is shallow. Add --deep when you suspect a channel auth or connectivity problem.

openclaw status --deep
🔍

Hidden Features

🔗
Share skills across agents by symlinking

You don't need to duplicate skill directories for each agent. Symlink a skill dir from one agent's workspace into another. Changes propagate everywhere.

ln -s ~/.openclaw/agents/main/skills/obsidian ~/.openclaw/agents/researcher/skills/obsidian
🤖
Run multiple agents on one gateway

One gateway process can serve multiple agents simultaneously — each with a different model, persona, and set of channels. Create them with openclaw agents add and they share the same gateway but stay isolated.

📋
HEARTBEAT.md drives automated health checks

Put a HEARTBEAT.md in your agent workspace. OpenClaw will execute it on a schedule and alert you if anything's broken. Keep it updated as your setup evolves.

🌐
No messaging app? Use the dashboard as your interface

The dashboard isn't just for setup — it's a fully functional chat interface. Some users run OpenClaw exclusively via dashboard with no external channels at all.

openclaw dashboard
💀

Common Mistakes

☠️
Setting up Discord before proving the gateway

You'll spend an hour debugging Discord bot permissions when the real problem is the gateway isn't running.

Always openclaw dashboard first. If that works, Discord will work.
☠️
Secrets in workspace files

API keys and tokens in MEMORY.md or workspace .md files can end up in git, logs, or synced to the cloud.

Secrets go in ~/.openclaw/secrets/ only. Never in workspace files.
☠️
Using rm on workspace files

MEMORY.md and agent workspace files are not trivial. rm is permanent — you lose your agent's memory and context.

Use trash instead. Recoverable if you realise the mistake.
☠️
Skipping openclaw doctor when things break

Doctor catches most issues in seconds and tells you exactly what to fix. Run it first, then go manual.

Run doctor first, always.
03 📋

Command Reference

Commands, flags, workflows
CLI Commands
--install-daemon Install and start the managed gateway service during onboarding.
--flow Choose onboarding depth: quickstart for sensible defaults, advanced/manual for full control.
--mode Select local or remote onboarding mode.
--non-interactive Run setup commands without prompts. Useful for scripts, CI, or reproducible bootstrap flows.
--channel Target a specific chat channel in channel-management commands.
--account Name a specific account instance for a channel that supports multiple accounts.
--bind Bind a new agent to a channel or account during agent creation.
--deep Do extra health/probe work instead of a lightweight status check.
--json Emit machine-readable output instead of terminal formatting.
--profile Use an isolated OpenClaw profile with its own state directory.
--dev Use dev-isolated state and shifted default ports.
--at Create a one-shot cron job at a specific timestamp or relative time.
--cron Create a recurring cron schedule using cron expression syntax.
--session Choose whether a cron job runs in the main session or an isolated cron session.
--announce Have an isolated cron run deliver its result to a chat target instead of staying internal.
--tag main Install from the main git branch instead of latest npm release.
--allow-exec Permit exec-based secret providers during secrets audit/configure/apply flows.
--dry-run Preview what secrets apply would do without writing anything.
--fix Automatically apply safe security fixes: tighten defaults, fix state/config permissions.
Daily Workflows
Fastest first chat without any messaging app openclaw dashboard
Set up a new agent openclaw agents add <name>
Check whether everything is healthy openclaw doctor
See live runtime and channel health openclaw status --deep
Add Telegram fast openclaw channels add --channel telegram --token $TELEGRAM_BOT_TOKEN
Add Discord for workspace-style use openclaw channels add --channel discord --token $DISCORD_BOT_TOKEN
Connect Signal privately openclaw pairing approve signal <CODE>
Inspect which skills are actually ready openclaw skills check
Search long-term memory openclaw memory search "<query>"
Schedule a real recurring job openclaw cron add --name "Morning brief" --cron "0 7 * * *" --session isolated --message "Summarize overnight updates" --announce
⚡ Power Moves
Agent army by channel/account binding openclaw agents add coding && openclaw agents add alerts && openclaw agents list --bindings
Use dashboard first, channels second openclaw gateway status && openclaw dashboard
Secure multi-user inboxes with per-sender DM isolation openclaw config set session.dmScope "per-channel-peer"
Heartbeat for awareness, cron for precision openclaw cron add --name "Reminder" --at "20m" --session main --system-event "Reminder text" --wake now
Thread-bind subagents in Discord/Telegram /focus <target>
Direct config surgery instead of manual JSON editing openclaw config validate && openclaw config set channels.telegram.linkPreview false
Treat doctor as the safe update command openclaw update && openclaw doctor
Install and manage ClawHub skills from CLI openclaw skills search <query> && openclaw skills install <name> && openclaw skills list
Attach browser tools to your real signed-in browser openclaw config set browser.profiles.user.userDataDir "~/Library/Application Support/Google/Chrome"
Use /btw for quick side questions without polluting session context /btw how is my heartbeat.md being used right now?
Security audit your config before going live openclaw security audit --deep --fix