News & Ecosystem Release Notes

OpenClaw Changelog: Version History & Every Major Release

Complete OpenClaw version history — major features, breaking changes, and migration notes from v0.1 through the current 1.5.x release series.

MK
M. Kim
Ecosystem Reporter
2025-03-10 12 min 5.5k views
Updated Mar 2025
Key Takeaways
OpenClaw 1.5.x (Feb 2025) introduced the ClaWHub Marketplace and Playwright skill.
Breaking change in 1.4.0: config file format changed from JSON to YAML — migration required.
OpenClaw 1.3.x added multi-model routing and Helm chart for Kubernetes.
Version 1.0 (Sep 2024) marked the first stable release with production-ready channel support.
All releases are published on GitHub; semantic versioning is used (MAJOR.MINOR.PATCH).

Version history matters when you're upgrading, debugging, or evaluating how actively a project is maintained. Here's every major OpenClaw release, what changed, and what to watch for when upgrading.

Version 1.5.x — Feb 2025

OpenClaw 1.5.0 introduced the ClaWHub Marketplace — a hosted registry of community and official skills installable with 'openclaw skill install'. The Playwright skill, ElevenLabs skill, and Supabase skill all launched with this release.

1.5.x also added the Skills API for third-party developers to publish their own skills to ClaWHub, and improved multi-channel message routing with priority queuing.

Version 1.4.x — Nov 2024

1.4.0 was a breaking change release. The config format migrated from JSON to YAML for better readability and comment support. Run 'openclaw config migrate' to auto-convert existing JSON configs.

New features: Helm chart for Kubernetes deployment, improved OAuth token refresh for LinkedIn and Twitter channels, and the web admin interface redesign.

Version 1.0 — Sep 2024

Version 1.0 marked the first stable, production-ready release of OpenClaw. Core channels (Telegram, Slack, Discord), the base skill system, and the gateway architecture all reached stability.

Prior 0.x releases were developer previews with frequent breaking changes. If you're on a 0.x version, full re-configuration is needed to migrate to 1.x.

💡
Check the changelog before upgrading
Every OpenClaw upgrade should start with reading the changelog for the versions you're crossing. Minor versions occasionally have config-level breaking changes. The migration guide in the changelog is always cleaner than debugging an unexpected config error.
Community forks may lag behind core
MoltBot, ClawdBot, PicoClaw, and NanoClaw all lag behind OpenClaw core by 1-3 minor versions. If a security fix lands in OpenClaw 1.5.2, the forks may take weeks to incorporate it. Check fork release dates before deploying community variants in production.
# Check your OpenClaw version
openclaw --version

# Update to latest
pip install --upgrade openclaw

# View changelog (if docs are installed)
openclaw docs changelog

Common Mistakes

  • Not reading the changelog before upgrading — minor versions occasionally have config-level changes. A 2-minute changelog read saves hours of debugging.
  • Treating community forks as equals to core — forks lag in security patches and may have diverged from the core API. Know what you're running.
  • Not bookmarking the official docs — docs.openclaw.dev is the authoritative reference. Community guides (including this one) may be outdated; official docs are updated with each release.
  • Missing Discord announcements — the #releases channel announces breaking changes before they ship, giving you time to prepare. Follow it.

Frequently Asked Questions

Where is the best place to get help with this topic?
The OpenClaw Discord server (#help channel) and r/openclaw on Reddit are the primary community support channels. GitHub Discussions is best for feature requests.

Is this officially supported by the OpenClaw team?
Core features are officially maintained. Community forks, third-party integrations, and ClaWHub skills vary in support level — check each project's README for maintainer status.

How often is this updated?
OpenClaw follows semantic versioning with minor releases every 4-6 weeks. Major releases are announced on GitHub, Discord, and the official blog.

Can I contribute to this?
Yes. OpenClaw is open-source and welcomes contributions. Check CONTRIBUTING.md in the GitHub repo for the process. Community skills can be submitted to ClaWHub via a pull request.

Where can I find the latest version information?
The GitHub releases page and the OpenClaw changelog at docs.openclaw.dev are the authoritative sources for version information.

Is there a community forum besides Reddit and Discord?
GitHub Discussions is the official forum for longer-form technical discussions. Some international communities also maintain Telegram and WeChat groups.

MK
M. Kim
Ecosystem Reporter · aiagentsguides.com

M. Kim covers the OpenClaw ecosystem, community news, and third-party integrations at aiagentsguides.com.

Get the OpenClaw Weekly

New guides, tips, and updates every week. Free forever.