Windows/macOS/Linux 桌面版通常支持自动更新

自动更新（推荐）

桌面应用程序

帮助 > 检查更新
或
设置 > 更新 > 检查更新

包管理器更新

# macOS (Homebrew)
brew update
brew upgrade openclaw
# Ubuntu/Debian (APT)
sudo apt update
sudo apt upgrade openclaw
# Arch Linux (Pacman)
sudo pacman -Syu openclaw
# Windows (Scoop)
scoop update
scoop update openclaw
# Windows (Chocolatey)
choco upgrade openclaw

手动更新

下载最新版本

• 访问官方仓库：https://github.com/openclaw-project/openclaw/releases
• 下载对应系统的最新安装包

手动安装步骤

# Linux 示例
# 1. 备份配置文件（如有需要）
cp -r ~/.config/openclaw ~/.config/openclaw_backup
# 2. 停止正在运行的 OpenClaw 进程
killall openclaw
# 3. 安装新版本
# 方法A：使用包管理器
sudo dpkg -i openclaw-latest.deb  # Debian/Ubuntu
# 方法B：解压二进制
tar -xzf openclaw-linux-amd64.tar.gz
sudo cp openclaw /usr/local/bin/

容器化部署更新

Docker 更新

# 拉取最新镜像
docker pull openclaw/openclaw:latest
# 停止并删除旧容器
docker stop openclaw-container
docker rm openclaw-container
# 运行新容器
docker run -d --name openclaw-container \
  -v /path/to/config:/config \
  openclaw/openclaw:latest

Docker Compose 更新

# docker-compose.yml
version: '3'
services:
  openclaw:
    image: openclaw/openclaw:latest
    restart: unless-stopped

# 更新命令
docker-compose pull openclaw
docker-compose up -d openclaw

源码编译更新

Git 仓库更新

# 拉取最新代码
cd /path/to/openclaw
git pull origin main
# 更新依赖
npm install  # 如果使用 Node.js
pip install -r requirements.txt  # 如果使用 Python
go mod download  # 如果使用 Go
# 重新编译
npm run build  # 或 make build, cargo build 等

编译安装

# 通用编译步骤
./configure
make
sudo make install

更新注意事项

备份重要数据

# 备份配置
cp -r ~/.openclaw ~/.openclaw_backup_$(date +%Y%m%d)
# 备份数据库（如使用）
mysqldump -u username -p openclaw_db > backup.sql

检查兼容性

• 查看更新日志（CHANGELOG.md）
• 检查 API/配置文件格式变更
• 确认插件/扩展兼容性

更新后验证

# 检查版本
openclaw --version
# 测试功能
openclaw --help
# 查看日志
journalctl -u openclaw.service  # systemd
tail -f /var/log/openclaw.log   # 日志文件

故障排除

常见问题：

1. 更新失败：检查网络连接和权限
2. 配置文件不兼容：参考新版配置文件示例
3. 插件不工作：更新插件或暂时禁用

回滚方法：

# 如果使用包管理器
sudo apt install openclaw=1.2.3  # 指定旧版本
# 如果从源码编译
git checkout v1.2.3
make && sudo make install

保持更新通知

1. 关注官方渠道：

   

   • GitHub Releases
   • 官方文档
   • 邮件列表/社交媒体

2. 设置自动更新检查：

   • 启用软件内自动更新
   • 设置系统定时任务检查更新

---

注意：具体更新步骤可能因 OpenClaw 的具体版本和部署方式而异，建议参考官方文档的最新说明。

标签： 桌面操作系统 自动更新