迁移指南

OpenClaw 支持三种迁移路径：从其他 agent 系统导入、将现有安装迁移到新机器、原地升级插件。

从其他 Agent 系统导入

通过内置迁移 provider 将指令、MCP servers、skills、模型配置和 API key 导入 OpenClaw。迁移前会预览计划，敏感信息在报告中脱敏，apply 前自动创建备份。

CLI 入口：openclaw migrate，onboarding 检测到已知来源时也会提示迁移：

openclaw onboard --flow import

支持的迁移来源：

Claude Code / Claude Desktop → 参见 install-migrating-claude
Hermes → openclaw migrate hermes

迁移到新机器

复制状态目录（默认 ~/.openclaw/）和 workspace 即可保留：

配置：openclaw.json 和所有 gateway 设置
认证：auth-profiles.json（API key + OAuth）、credentials/ 下的 channel/provider 状态
会话：对话历史和 agent 状态
Channel 状态：WhatsApp 登录、Telegram session 等
Workspace 文件：MEMORY.md、USER.md、skills、prompts

迁移步骤

# 1. 旧机器：停止 gateway 并备份
openclaw gateway stop
cd ~
tar -czf openclaw-state.tgz .openclaw
 
# 2. 新机器：安装 OpenClaw（onboarding 创建的 ~/.openclaw 会被覆盖）
 
# 3. 传输并解压
cd ~
tar -xzf openclaw-state.tgz
 
# 4. 运行 doctor 并验证
openclaw doctor
openclaw gateway restart
openclaw status

验证 Telegram/Discord token 是否存在（不打印值）：

awk -F= '/^(TELEGRAM_BOT_TOKEN|DISCORD_BOT_TOKEN)=/ { print $1 "=present" }' ~/.openclaw/.env

常见陷阱

profile/state-dir 不匹配：新机器必须使用与旧机器相同的 --profile 或 OPENCLAW_STATE_DIR
只复制 openclaw.json 不够：auth profiles 在 agents/<agentId>/agent/auth-profiles.json，channel 状态在 credentials/，必须迁移整个状态目录
权限问题：确保状态目录属主与运行 gateway 的用户一致
远程模式：状态在 gateway host 上，迁移 gateway host 本身，不是本地笔记本
备份安全：状态目录含 auth profiles 和 channel 凭证，备份需加密存储

验证清单

openclaw status 显示 gateway 运行中
Channels 仍已连接（无需重新配对）
Dashboard 打开并显示已有会话
Workspace 文件（memory、configs）存在

原地升级插件

插件原地升级保留相同的 plugin id 和配置 key，但可能调整磁盘状态布局。插件专属升级指南见各 channel 文档（如 Matrix migration）。

Wiki AI

目录