by 安全扫描
OpenClaw
安全
high confidence该技能的文件和运行指令与其声明的目的（从源代码更新 OpenClaw）一致，执行预期的仓库、构建、备份和重启操作，不请求无关的秘密或网络端点。
评估建议
["先运行 `DRY_RUN=true` 查看计划操作。","验证上游远程仓库（https://github.com/openclaw/openclaw.git）是否正确且可信。","备份 `~/.openclaw`（脚本已完成）并确保有提交或存储的本地更改。","注意 `npm i -g .` 可能需要 `sudo` 并将全局安装；考虑在受控环境中运行。","如果需要重置行为，检查/修改脚本。","如果不熟悉命令，请手动一步一步运行脚本，而不是允许自动运行。"]...详细分析 ▾
ℹ 用途与能力
技能的名称/描述与包含的脚本和 SKILL.md 一致：它从源代码更新 OpenClaw，备份配置，获取上游（GitHub），构建，全球安装，并重启网关。
ℹ 指令范围
指令和脚本在项目目录和用户配置（~/.openclaw）上操作，检查 Git 状态，使用 npm 构建，并重启 per-user systemd 服务 — 所有这些对于更新程序都是预期的。
✓ 安装机制
这是一个仅包含指令的技能，附带 shell 脚本；没有安装程序从不可信任的 URL 下载任意可执行文件。
✓ 凭证需求
不需要任何秘密或凭证环境变量。
✓ 持久化与权限
技能不请求持久特权或“始终”包含。
安全有层次，运行前请审查代码。
运行时依赖
无特殊依赖
版本
latestv1.0.62026/2/23
版本 1.0.6 - 文档：SKILL.md 现已完全翻译为英文以提高可访问性。 - 无功能或文件更改；工作流和使用方式保持不变。 - 所有技术指令、使用说明和故障排除步骤现在以英文呈现。
● 无害
安装命令
点击复制官方npx clawhub@latest install safe-update
镜像加速npx clawhub@latest install safe-update --registry https://cn.longxiaskill.com
技能文档
更新 OpenClaw 从源代码以获取最新版本，同时保留本地更改。
⚠️ 重要警告
- 执行 git rebase 和 git push --force - 可能丢失未提交的本地更改
- 使用 npm i -g . 进行全局安装 - 可能需要
sudo - 使用 systemctl --user restart - 将重启 OpenClaw 服务
- 在运行前备份配置！（见下）
要求
必须安装的二进制文件：gitnpm/nodesystemctl（用于重启网关）
配置
环境变量（可选）
# 设置自定义项目路径
export OPENCLAW_PROJECT_DIR="/path/to/openclaw"
# 设置自定义分支（默认：main）
export OPENCLAW_BRANCH="your-feature-branch"
# 启用干运行模式（无实际更改）
export DRY_RUN="true"
或通过参数传递
./update.sh --dir /path/to/openclaw --branch your-branch
工作流
步骤 1：分析当前状态（必须首先运行）
在执行更新之前，检查：- 当前分支是否有未提交的更改
- 当前分支是否有本地修改
- 上游是否有新提交
- 根据情况推荐最合适的更新策略
推荐策略：
| 场景 | 推荐方法 | 理由 |
|---|---|---|
| 未提交的本地更改 | 先提交/存储，然后 合并 | 安全，无丢失更改 |
| 只有干净的本地提交 | 合并 或 重置 | 合并更安全，重置保持历史清洁 |
| 准备 PR | 重置 推荐 | 保持历史整洁 |
| 常规开发更新 | 合并 推荐 | 简单，少错误 |
步骤 2：等待用户确认
在呈现推荐选项后，必须等待用户确认才执行。步骤 3：执行更新
# 1. 进入项目目录
cd "${OPENCLAW_PROJECT_DIR:-$HOME/projects/openclaw}"
# 2. 备份配置文件（更新前最佳实践！）
echo "=== Backing up config files ==="
...
快速脚本运行
运行scripts/update.sh 自动完成上述所有步骤。命令行选项
./update.sh [选项]
选项：
--dir PATH OpenClaw 项目目录（默认：$HOME/projects/openclaw）
--branch NAME Git 分支更新（默认：main）
--mode MODE 更新模式：合并或重置（如果不指定，将分析并推荐）
--dry-run 显示将执行的操作而不执行
cf. 原始文档...
注意
- 重置可能引起冲突 - 如果发生冲突，请手动解决然后继续
- 强制推送 - 重置后，如果推送到 fork，请使用
git push --force - 服务重新安装 - 将更新 systemd 单元文件中的版本
- 用户确认重启 - 网关将不会重启，直到您确认
- 先备份！ - 更新前始终备份！
故障排除
Git 冲突 durante 重置
# 手动解决冲突，然后：
git add .
git rebase --continue
# 继续构建步骤
构建失败
# 清理并重试：
rm -rf node_modules dist
npm install
npm run build
网关无法启动
# 检查状态：
systemctl --user status openclaw-gateway
# 查看日志：
journalctl --user -u openclaw-gateway -n 50