开发通道

OpenClaw 提供三个更新通道（Channel），控制你接收的版本类型。

---

三个通道

通道	标签格式	更新频率	稳定性	适用场景
stable	v1.2.3	每 2–4 周	⭐⭐⭐	生产环境、日常使用
beta	v1.3.0-beta.1	每 1–2 周	⭐⭐	提前体验新功能
dev	v0.0.0-dev.abc1234	每次 commit	⭐	开发者调试

---

查看当前通道

openclaw config get channel
# 输出：stable

---

切换通道

# 切换到 beta
openclaw config set channel beta
openclaw update

# 切换到 dev
openclaw config set channel dev
openclaw update

# 切回 stable
openclaw config set channel stable
openclaw update

安装脚本指定通道

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --channel beta

Docker 镜像标签

docker pull ghcr.io/openclaw/gateway:latest   # stable
docker pull ghcr.io/openclaw/gateway:beta      # beta
docker pull ghcr.io/openclaw/gateway:dev       # dev

---

插件兼容性

• stable 通道的插件 API 保证向后兼容
• beta 通道可能包含实验性 API，插件需要适配
• dev 通道的 API 可能随时变化，插件可能无法加载

切换到 dev 通道前请注意

dev 通道的版本未经完整测试，可能包含破坏性变更。如果你的工作流依赖 OpenClaw 的稳定性，请留在 stable 通道。

---

版本标签规则

OpenClaw 遵循 语义化版本（Semantic Versioning）：

MAJOR.MINOR.PATCH[-prerelease][+build]

版本变化	含义
MAJOR（主版本）↑	包含破坏性 API 变更
MINOR（次版本）↑	新增功能，向后兼容
PATCH（补丁版本）↑	Bug 修复，向后兼容

Pre-release 标签示例：

• 1.3.0-beta.1 — Beta 通道第 1 个预览版
• 1.3.0-beta.2 — Beta 通道第 2 个预览版
• 1.3.0-rc.1 — Release Candidate（发布候选）
• 0.0.0-dev.abc1234 — Dev 通道，commit hash 标识

---

自动更新行为

通道	默认行为
stable	提示有新版本，手动确认更新
beta	自动下载，手动确认安装
dev	不自动更新（需手动 openclaw update）

关闭自动更新提示：

openclaw config set auto_update false

---

🇨🇳 中国用户须知

所有通道的版本均同步到国内镜像，使用体验一致。无需担心通道切换后下载速度变慢。