跳到主要内容

更新

Moltbot 发展迅速（预 "1.0"）。像处理运输基础设施一样处理更新：更新 → 运行检查 → 重启（或使用 moltbot update，它会重启）→ 验证。

推荐：重新运行网站安装程序（就地升级）​

首选更新路径是重新运行来自网站的安装程序。它 检测现有安装，在原地升级，并在需要时运行 moltbot doctor。

curl -fsSL https://molt.bot/install.sh | bash

说明：

  • 如果您不希望入门向导再次运行，请添加 --no-onboard。
  • 对于源码安装，使用： 
    curl -fsSL https://molt.bot/install.sh | bash -s -- --install-method git --no-onboard
    安装程序仅在仓库干净时执行 git pull --rebase。
  • 对于全局安装，脚本在后台使用 npm install -g moltbot@latest。
  • 旧版说明：moltbot 仍作为兼容性垫片可用。

更新前​

  • 了解您的安装方式：全局（npm/pnpm）vs 从源码（git clone）。
  • 了解您的网关运行方式：前台终端 vs 监督服务（launchd/systemd）。
  • 快照您的定制：
    • 配置：~/.clawdbot/moltbot.json
    • 凭據：~/.clawdbot/credentials/
    • 工作区：~/clawd

更新（全局安装）​

全局安装（选择一个）：

npm i -g moltbot@latest
pnpm add -g moltbot@latest

我们不推荐在网关运行时使用 Bun（WhatsApp/Telegram 错误）。

要切换更新通道（git + npm 安装）：

moltbot update --channel beta
moltbot update --channel dev
moltbot update --channel stable

使用 --tag <dist-tag|version> 一次性安装特定标签/版本。

参见 开发通道 了解通道语义和发布说明。

注意：在 npm 安装中，网关在启动时记录更新提示（检查当前通道标签）。通过 update.checkOnStart: false 禁用。

然后：

moltbot doctor
moltbot gateway restart
moltbot health

说明：

  • 如果您的网关作为服务运行，moltbot gateway restart 比杀死 PID 更受推荐。
  • 如果您固定到特定版本，请参见下面的"回滚/固定"。

更新（moltbot update）​

对于源码安装（git checkout），优先使用：

moltbot update

它运行一个相对安全的更新流程：

  • 需要干净的工作树。
  • 切换到选定的通道（标签或分支）。
  • 获取 + 变基到配置的上游（dev 通道）。
  • 安装依赖项，构建，构建控制 UI，并运行 moltbot doctor。
  • 默认重启网关（使用 --no-restart 跳过）。

如果您通过npm/pnpm（无 git 元数据）安装，moltbot update 将尝试通过您的包管理器更新。如果无法检测到安装，请改用"更新（全局安装）"。

更新（控制 UI / RPC）​

控制 UI 有更新和重启（RPC: update.run）。它：

  1. 运行与 moltbot update 相同的源码更新流程（仅 git checkout）。
  2. 使用结构化报告写入重启哨兵（stdout/stderr 尾部）。
  3. 重启网关并向最后活跃的会话发送报告。

如果变基失败，网关中止并在不应用更新的情况下重启。

更新（从源码）​

从仓库 checkout：

首选：

moltbot update

手动（大致等效）：

git pull
pnpm install
pnpm build
pnpm ui:build # 首次运行时自动安装 UI 依赖项
moltbot doctor
moltbot health

说明：

  • 当您运行打包的 moltbot 二进制文件（moltbot.mjs）或使用 Node 运行 dist/ 时，pnpm build 很重要。
  • 如果您在没有全局安装的情况下从仓库 checkout 运行，请对 CLI 命令使用 pnpm moltbot ...。
  • 如果您直接从 TypeScript 运行（pnpm moltbot ...），通常不需要重建，但配置迁移仍然适用 → 运行 doctor。
  • 在全局和 git 安装之间切换很容易：安装另一种方式，然后运行 moltbot doctor，这样网关服务入口点就会重写为当前安装。

始终运行：moltbot doctor​

Doctor 是"安全更新"命令。它有意保持无聊：修复 + 迁移 + 警告。

注意：如果您在源码安装（git checkout）上，moltbot doctor 会首先提供运行 moltbot update。

典型操作：

  • 迁移已弃用的配置键/旧配置文件位置。
  • 审核 DM 策略并警告风险的"开放"设置。
  • 检查网关健康状况并可能提供重启。
  • 检测并将较旧的网关服务（launchd/systemd；旧 schtasks）迁移到当前 Moltbot 服务。
  • 在 Linux 上，确保 systemd 用户持久化（这样网关会在登出后继续运行）。

详情：Doctor

启动/停止/重启网关​

CLI（适用于任何操作系统）：

moltbot gateway status
moltbot gateway stop
moltbot gateway restart
moltbot gateway --port 18789
moltbot logs --follow

如果您受到监督：

  • macOS launchd（应用程序捆绑的 LaunchAgent）：launchctl kickstart -k gui/$UID/bot.molt.gateway（使用 bot.molt.<profile>；旧 com.clawdbot.* 仍然有效）
  • Linux systemd 用户服务：systemctl --user restart moltbot-gateway[-<profile>].service
  • Windows（WSL2）：systemctl --user restart moltbot-gateway[-<profile>].service
    • launchctl/systemctl 仅在服务安装时有效；否则运行 moltbot gateway install。

运行手册 + 精确服务标签：网关运行手册

回滚/固定（出现问题时）​

固定（全局安装）​

安装已知良好的版本（将 <version> 替换为最后一个工作版本）：

npm i -g moltbot@<version>
pnpm add -g moltbot@<version>

提示：要查看当前发布的版本，请运行 npm view moltbot version。

然后重启 + 重新运行 doctor：

moltbot doctor
moltbot gateway restart

按日期固定（源码）​

从日期中选择提交（示例："2026-01-01 的主分支状态"）：

git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-01-01\" origin/main)"

然后重新安装依赖项 + 重启：

pnpm install
pnpm build
moltbot gateway restart

如果您想稍后返回最新版本：

git checkout main
git pull

如果您卡住了​