将 Moltbot 迁移到新机器

本指南用于将 Moltbot 网关从一台机器迁到另一台，无需重新走入门向导。
迁移在概念上很简单：

复制状态目录（$CLAWDBOT_STATE_DIR，默认 ~/.clawdbot/）—— 包含配置、认证、会话与频道状态。
复制你的工作区（默认 ~/clawd/）—— 包含 agent 文件（memory、prompts 等）。

但围绕 profile、权限和 部分复制 常有常见坑。

开始前（你要迁移什么）

1）确认状态目录

多数安装使用默认：

状态目录：~/.clawdbot/

若使用了以下方式，可能不同：

--profile <name>（常对应 ~/.clawdbot-<profile>/）
CLAWDBOT_STATE_DIR=/some/path

若不确定，在旧机器上执行：


moltbot status

输出中会提到 CLAWDBOT_STATE_DIR / profile。若运行多个网关，请对每个 profile 分别处理。

2）确认工作区

常见默认：

~/clawd/（推荐工作区）
你自定义的目录

工作区即存放 MEMORY.md、USER.md、memory/*.md 等文件的位置。

3）理解会保留什么

若同时复制状态目录和工作区，将保留：

网关配置（moltbot.json）
认证配置 / API 密钥 / OAuth token
会话历史与 agent 状态
频道状态（如 WhatsApp 登录/会话）
工作区文件（memory、skills 笔记等）

若只复制工作区（例如通过 Git），不会保留：

会话
凭据
频道登录状态

这些都在 $CLAWDBOT_STATE_DIR 下。

迁移步骤（推荐）

步骤 0 — 备份（旧机器）

在旧机器上先停止网关，避免复制时文件被修改：


moltbot gateway stop

（可选但推荐）将状态目录和工作区打包：


# 若使用 profile 或自定义路径请相应调整
cd ~
tar -czf moltbot-state.tgz .clawdbot

tar -czf clawd-workspace.tgz clawd

若有多个 profile/状态目录（如 ~/.clawdbot-main、~/.clawdbot-work），分别打包。

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

在新机器上安装 CLI（如需可一并安装 Node）：

参见：安装

此阶段入门向导若创建新的 ~/.clawdbot/ 也没关系，下一步会覆盖。

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

同时复制：

$CLAWDBOT_STATE_DIR（默认 ~/.clawdbot/）
你的工作区（默认 ~/clawd/）

常用方式：

用 scp 传压缩包再解压
用 rsync -a 经 SSH 同步
外接存储

复制后请确认：

包含隐藏目录（如 .clawdbot/）
文件属主与运行网关的用户一致

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

在新机器上：


moltbot doctor

Doctor 是「安全、保守」的命令：修复服务、应用配置迁移并提示不匹配。然后：


moltbot gateway restart
moltbot status

常见坑（及避免方式）

坑：profile / 状态目录不一致

若旧网关使用了某个 profile（或 CLAWDBOT_STATE_DIR），而新网关用了另一个，可能出现：

配置修改不生效
频道丢失 / 已登出
会话历史为空

解决：用与迁移时相同的 profile/状态目录运行网关或服务，再执行：


moltbot doctor

坑：只复制了 `moltbot.json`

仅有 moltbot.json 不够。很多 provider 的状态在：

$CLAWDBOT_STATE_DIR/credentials/
$CLAWDBOT_STATE_DIR/agents/<agentId>/...

请迁移整个 $CLAWDBOT_STATE_DIR 目录。

坑：权限 / 属主

若以 root 复制或换了用户，网关可能无法读取凭据或会话。
解决：确保状态目录和工作区的属主为运行网关的用户。

坑：远程/本机模式迁移

若你的 UI（WebUI/TUI）指向远程网关，会话存储和工作区在远程主机上。
只迁移笔记本不会迁移远程网关的状态。

若处于远程模式，请迁移网关所在主机。

坑：备份中的敏感信息

$CLAWDBOT_STATE_DIR 含有敏感信息（API 密钥、OAuth token、WhatsApp 凭据等）。备份应视同生产敏感数据：

加密存储
避免经不安全渠道分享
若怀疑泄露请轮换密钥

验证清单

在新机器上确认：

moltbot status 显示网关在运行
频道仍连接（如 WhatsApp 无需重新配对）
控制台能打开并显示已有会话
工作区文件（memory、配置）存在