文档
安装
Migrating

将 Moltbot 迁移到新机器

本指南将 Moltbot Gateway 从一台机器迁移到另一台机器，而无需重新进行入职。

迁移在概念上很简单：

  • 复制状态目录（$MOLTBOT_STATE_DIR，默认：~/.moltbot/）— 这包括配置、认证、会话和频道状态。
  • 复制您的工作区（默认为 ~/clawd/）— 这包括您的代理文件（内存、提示等）。

但在配置文件、权限和部分复制方面存在常见的陷阱。

开始之前（您正在迁移什么）

1) 识别您的状态目录

大多数安装使用默认值：

  • 状态目录： ~/.moltbot/

但如果您使用以下内容，可能会有所不同：

  • --profile <name>（通常变为 ~/.moltbot-<profile>/）
  • MOLTBOT_STATE_DIR=/some/path

如果不确定，请在旧机器上运行：

moltbot status

在输出中查找 MOLTBOT_STATE_DIR / 配置文件的提及。如果您运行多个 gateway，请为每个配置文件重复此操作。

2) 识别您的工作区

常见默认值：

  • ~/clawd/（推荐工作区）
  • 您创建的自定义文件夹

您的工作区是 MEMORY.md、USER.md 和 memory/*.md 等文件所在的位置。

3) 了解您将保留什么

如果您复制两个状态目录和工作区，您将保留：

  • Gateway 配置（moltbot.json）
  • 认证配置文件 / API 密钥 / OAuth 令牌
  • 会话历史 + 代理状态
  • 频道状态（例如 WhatsApp 登录/会话）
  • 您的工作区文件（内存、技能笔记等）

如果您仅复制工作区（例如，通过 Git），您将不保留：

  • 会话
  • 凭证
  • 频道登录

这些位于 $MOLTBOT_STATE_DIR 下。

迁移步骤（推荐）

步骤 0 — 进行备份（旧机器）

在旧机器上，首先停止 gateway，以便文件在复制过程中不会更改：

moltbot gateway stop

（可选但推荐）归档状态目录和工作区：

# 如果您使用配置文件或自定义位置，请调整路径
cd ~
tar -czf moltbot-state.tgz .moltbot

tar -czf clawd-workspace.tgz clawd

如果您有多个配置文件/状态目录（例如 ~/.moltbot-main、~/.moltbot-work），请分别归档每个目录。

步骤 1 — 在新机器上安装 Moltbot

在新机器上，安装 CLI（如果需要，还有 Node）：

在此阶段，如果入职创建了一个新的 ~/.moltbot/，那也没关系 — 您将在下一步中覆盖它。

步骤 2 — 将状态目录 + 工作区复制到新机器

复制两个：

  • $MOLTBOT_STATE_DIR（默认 ~/.moltbot/）
  • 您的工作区（默认 ~/clawd/）

常用方法：

  • 通过 scp 复制 tarball 并解压
  • 通过 SSH 使用 rsync -a
  • 外部驱动

复制后，确保：

  • 包括隐藏目录（例如 .moltbot/）
  • 文件所有权对于运行 gateway 的用户是正确的

步骤 3 — 运行 Doctor（迁移 + 服务修复）

在新机器上：

moltbot doctor

Doctor 是"安全无聊"的命令。它修复服务，应用配置迁移，并警告不匹配。

然后：

moltbot gateway restart
moltbot status

常见陷阱（以及如何避免它们）

陷阱：配置文件/状态目录不匹配

如果您使用配置文件（或 MOLTBOT_STATE_DIR）运行旧 gateway，而新 gateway 使用不同的配置文件/状态目录，您将看到如下症状：

  • 配置更改未生效
  • 频道缺失/已注销
  • 会话历史为空

修复：使用您迁移的相同配置文件/状态目录运行 gateway/服务，然后重新运行：

moltbot doctor

陷阱：仅复制 moltbot.json

moltbot.json 是不够的。许多提供商将状态存储在：

  • $MOLTBOT_STATE_DIR/credentials/
  • $MOLTBOT_STATE_DIR/agents/<agentId>/...

始终迁移整个 $MOLTBOT_STATE_DIR 文件夹。

陷阱：权限/所有权

如果您以 root 身份复制或更改用户，gateway 可能无法读取凭证/会话。

修复：确保状态目录 + 工作区由运行 gateway 的用户拥有。

陷阱：在远程/本地模式之间迁移

  • 如果您的 UI（WebUI/TUI）指向远程 gateway，则远程主机拥有会话存储 + 工作区。
  • 迁移您的笔记本电脑不会移动远程 gateway 的状态。

如果您处于远程模式，请迁移 gateway 主机。

陷阱：备份中的机密

$MOLTBOT_STATE_DIR 包含机密（API 密钥、OAuth 令牌、WhatsApp 凭证）。像生产机密一样对待备份：

  • 加密存储
  • 避免通过不安全渠道共享
  • 如果怀疑泄露则轮换密钥

验证清单

在新机器上，确认：

  • moltbot status 显示 gateway 正在运行
  • 您的频道仍然连接（例如，WhatsApp 不需要重新配对）
  • 仪表板打开并显示现有会话
  • 您的工作区文件（内存、配置）存在

相关

Ansible 安装