OpenClaw从入门到应用——安装：更新OpenClaw

通过OpenClaw实现副业收入《OpenClaw赚钱实录从“养龙虾“到可持续变现的实践指南》推荐方式重新运行网站安装程序原地升级首选的更新方式是重新运行官网提供的安装脚本。该脚本会自动检测现有安装执行原地升级并在需要时运行openclaw doctor。curl-fsSLhttps://openclaw.ai/install.sh|bash注意事项如果你不希望再次触发引导向导onboarding wizard请添加--no-onboard参数。对于源码安装source installs请使用curl-fsSLhttps://openclaw.ai/install.sh|bash-s-- --install-methodgit--no-onboard安装程序仅当代码仓库干净无未提交更改时才会执行git pull --rebase。对于全局安装global installs脚本内部实际调用的是npm install -g openclawlatest。兼容性说明旧名称clawdbot仍作为兼容层compatibility shim保留可用。更新前须知确认你的安装方式全局安装通过 npm/pnpm还是源码安装通过 git clone。确认你的 Gateway 是如何运行的是在前台终端中手动启动还是作为受监管的服务如 macOS 的 launchd 或 Linux 的 systemd运行。备份你的个性化配置配置文件~/.openclaw/openclaw.json凭据信息~/.openclaw/credentials/工作空间~/.openclaw/workspace更新全局安装全局安装请选择以下任一命令npmi-gopenclawlatestpnpmadd-gopenclawlatest我们不推荐在 Gateway 运行时使用 Bun因其存在 WhatsApp/Telegram 相关的已知问题。若要切换更新通道适用于 git npm 安装openclaw update--channelbeta openclaw update--channeldev openclaw update--channelstable如需一次性安装特定标签或版本请使用--tag 标签/版本。有关各通道的具体语义和发布说明请参阅 开发通道。注意对于 npm 安装Gateway 启动时会自动检查当前通道是否有新版本并提示更新。可通过设置update.checkOnStart: false来禁用此行为。核心自动更新器可选自动更新器默认关闭它是 Gateway 的核心功能而非插件。{update:{channel:stable,auto:{enabled:true,stableDelayHours:6,stableJitterHours:12,betaCheckIntervalHours:1}}}行为说明stable稳定通道检测到新版本后OpenClaw 会等待stableDelayHours小时然后在此基础上叠加一个确定性的、每个安装实例不同的随机延迟范围为stableJitterHours小时以实现滚动更新。beta测试通道按betaCheckIntervalHours的间隔默认每小时检查更新并在有新版本时立即应用。dev开发通道不会自动应用更新请使用手动命令openclaw update。在启用自动更新前建议先运行openclaw update --dry-run预览即将执行的操作。启用后请执行openclaw doctor openclaw gateway restart openclaw health注意事项如果你的 Gateway 以服务形式运行建议优先使用openclaw gateway restart而不是直接 kill 进程 ID。如果你希望锁定某个特定版本请参见下方“回滚 / 固定版本”部分。更新openclaw update命令对于源码安装git checkout推荐使用openclaw update该命令会执行一套相对安全的更新流程要求工作区干净无未提交更改切换到所选的更新通道标签或分支从配置的上游仓库拉取最新变更并执行 rebase适用于 dev 通道安装依赖、构建项目、构建 Control UI并运行openclaw doctor默认会重启 Gateway可通过--no-restart跳过。如果你是通过npm/pnpm安装的即没有 git 元数据openclaw update会尝试通过你的包管理器进行更新。如果无法检测到安装方式请改用上方“更新全局安装”中的方法。更新通过 Control UI / RPCControl UI 提供了“Update Restart”按钮对应的 RPC 方法为update.run。其工作流程如下执行与openclaw update相同的源码更新流程仅限 git checkout 安装写入一个重启标记文件sentinel其中包含结构化的更新报告含 stdout/stderr 的末尾日志重启 Gateway并将报告推送给上一个活跃会话。如果 rebase 失败Gateway 会中止更新并直接重启不会应用任何更改。更新从源码手动操作在仓库目录中操作推荐方式openclaw update手动方式效果大致等同gitpullpnpminstallpnpmbuildpnpmui:build# 首次运行时会自动安装 UI 依赖openclaw doctor openclaw health注意事项当你运行打包后的openclaw二进制文件即openclaw.mjs或通过 Node 直接运行dist/目录下的产物时pnpm build步骤至关重要。如果你是从源码仓库直接运行未进行全局安装请使用pnpm openclaw ...来执行 CLI 命令。如果你直接从 TypeScript 源码运行即pnpm openclaw ...通常无需重新构建但配置迁移仍然生效→ 务必运行openclaw doctor。在全局安装和源码安装之间切换非常简单只需安装另一种形式然后运行openclaw doctor它会自动将 Gateway 服务的入口点重写为当前安装的版本。务必运行openclaw doctordoctor是“安全更新”的核心命令。它的设计原则就是“平淡无奇”修复 迁移 警告。注意如果你使用的是源码安装git checkoutopenclaw doctor会主动建议你先运行openclaw update。它通常会执行以下操作迁移已弃用的配置项或旧版配置文件路径审计私信DM策略并对存在风险的“开放”设置发出警告检查 Gateway 健康状态并可提供重启建议检测并迁移旧版的 Gateway 服务如 launchd/systemd 或遗留的 schtasks至当前 OpenClaw 服务在 Linux 上确保启用了 systemd 用户 lingering 功能使 Gateway 在用户登出后仍能继续运行。更多细节请参阅Doctor启动 / 停止 / 重启 GatewayCLI 命令跨平台通用openclaw gateway status openclaw gateway stop openclaw gateway restart openclaw gateway--port18789openclaw logs--follow如果你的 Gateway 由系统服务监管macOS launchd应用捆绑的 LaunchAgentlaunchctl kickstart-kgui/$UID/ai.openclaw.gateway使用ai.openclaw.前缀旧版com.openclaw.*依然兼容Linux systemd 用户服务systemctl--userrestart openclaw-gateway[-].serviceWindows (WSL2)systemctl--userrestart openclaw-gateway[-].service注意launchctl/systemctl命令仅在服务已安装的情况下有效否则请先运行openclaw gateway install。具体操作手册及服务标签详情请参阅Gateway 操作手册回滚 / 固定版本当更新出错时固定版本全局安装安装一个已知正常的版本将版本号替换为你上次正常工作的版本号npmi-gopenclaw版本号pnpmadd-gopenclaw版本号小技巧要查看当前发布的最新版本可运行npm view openclaw version。然后重启并重新运行 doctoropenclaw doctor openclaw gateway restart按日期固定版本源码安装选择某个日期对应的提交例如“2026-01-01 当天 main 分支的状态”gitfetch origingitcheckout$(gitrev-list-n1--before\2026-01-01\ origin/main)然后重新安装依赖并重启pnpminstallpnpmbuild openclaw gateway restart如果你想之后再切回最新版gitcheckout maingitpull如果遇到问题无法解决再次运行openclaw doctor并仔细阅读输出内容它通常会直接告诉你修复方法。查阅故障排除指南在 Discord 上提问https://discord.gg/clawd