本文档帮助你将 Openclaw 更新到最新版本，并在遇到问题时进行排查。
大多数用户只需要这一个命令：
Linux / macOS：
Linux / macOS（淘宝镜像源，国内推荐）：
Windows（PowerShell）：
Windows（PowerShell，淘宝镜像源）：
WSL 用户注意：WSL 环境需要启用 systemd 才能使用 。如果遇到 "Failed to connect to bus" 错误，请参考 WSL 启用 systemd 指南 或使用前台模式运行：
这会：更新到最新版本 → 运行诊断修复 → 重启 Gateway。
方法 A：使用安装脚本（推荐）
添加 跳过引导向导（你已经配置过了）。
方法 B：使用 npm 直接更新
方法 C：使用淘宝镜像源更新（国内推荐）
如果 npm 官方源较慢，可以使用淘宝镜像：
或者永久设置淘宝源后再更新：
方法 D：安装测试版本
如果你想测试预发布版本：
更新后必须运行 doctor 命令：
Doctor 会自动：
- 迁移旧配置到新格式
- 检查并修复常见问题
- 验证 Gateway 健康状态
命令 用途 查看整体状态概览 完整诊断报告（可粘贴分享） 自动检测并修复问题 实时查看日志 查看消息通道状态 查看 AI 模型认证状态
症状：运行 后无响应
排查步骤：
症状：Telegram/微信/飞书等通道无法收发消息
排查步骤：
症状：提示"未找到提供者的 API 密钥"
排查步骤：
症状：提示需要运行 doctor 但 doctor 报错
排查步骤：
症状：更新后打开 Web 网关管理页面，显示错误
原因：浏览器缓存了旧版本的设备认证数据，与新版 Gateway 不兼容
快速解决：
- 清除浏览器本地存储（推荐）：
- Chrome：按 → Application → Local Storage → 右键删除 相关条目
- 或者： → 勾选「Cookie 和站点数据」→ 清除
- 使用无痕模式：在新的无痕/隐私窗口打开 Web UI
- 换一个浏览器：暂时使用另一个浏览器访问
详细说明见 故障排除指南
如果新版本有问题，可以回滚到之前的版本：
如果问题无法解决：
- 运行 获取完整诊断报告
- 查看 故障排除指南
- 在 Discord 社区提问：https://discord.gg/KFTVvJUu
Openclaw 有三个发布渠道：
渠道 说明 安装命令 stable 稳定版（默认） beta 预发布测试版 test 开发测试版
切换渠道：
如果你是从 Git 仓库安装的：
查看服务状态：
启动/停止/重启：
安装/卸载系统服务：
平台特定命令：
- macOS：
- Linux：
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容，请联系我们，一经查实，本站将立刻删除。
如需转载请保留出处：https://51itzy.com/kjqy/213149.html