夜雨聆风
OpenClaw 搬家指南:把你的 AI 助手打包带走
换了新电脑，OpenClaw 要重新配置？别急！跟着这篇指南，5 步搞定迁移，连记忆都能一起带走~
写在前面
你有没有过这样的经历：
🖥️ 旧电脑：用了一年的 OpenClaw，配置完美，技能丰富，记忆满满…
💻 新电脑：全新的机器，要从零开始？不存在的！
今天，我们就来一场 OpenClaw 的”搬家行动”，让你的 AI 助手无缝迁移到新家！
第一步：打包行李（旧电脑备份）
搬家第一件事，当然是打包！OpenClaw 的”行李”主要在两个地方：
1.1 配置目录
这是 OpenClaw 的”灵魂”所在，存放着你的所有配置：
📁 打包清单：
~/.openclaw/
+-- 📄 openclaw.json <- 核心配置（模型、渠道、Gateway设置）
+-- 📄 .env <- 环境变量（API Key等敏感信息）
+-- 📁 workspace/ <- 工作空间
| +-- 📄 SOUL.md <- 身份定义
| +-- 📄 USER.md <- 用户信息
| +-- 📄 MEMORY.md <- 长期记忆 ⭐
| +-- 📄 AGENTS.md <- 工作指南
| +-- 📁 memory/ <- 每日记忆 ⭐
| +-- 📁 skills/ <- 自定义技能 ⭐
| +-- 📁 files/ <- 文件资料
+-- 📁 credentials/ <- 凭证信息
+-- 📁 identity/ <- 身份配置
Windows 路径：
C:\Users\你的用户名\.openclaw\
macOS/Linux 路径：
~/.openclaw/
1.2 打包操作
Windows 用户：
方式一：直接复制文件夹
1. 打开文件资源管理器
2. 地址栏输入：C:\Users\你的用户名\.openclaw
3. 右键整个 .openclaw 文件夹 -> 复制
4. 粘贴到 U 盘或云盘
方式二：用 PowerShell 打包
Compress-Archive -Path "$env:USERPROFILE\.openclaw" -DestinationPath "$env:USERPROFILE\Desktop\openclaw-backup.zip"
macOS/Linux 用户：
# 打包成压缩文件
cd ~
tar -czvf openclaw-backup.tar.gz .openclaw
# 或者直接复制到桌面
cp -r ~/.openclaw ~/Desktop/openclaw-backup
1.3 重要提醒
⚠️ 特别注意：
.env文件里有你的 API Key，打包后记得妥善保管，别发给别人！
第二步：新家准备（新电脑安装）
行李打包好了，接下来要准备新家！
2.1 安装 Node.js
OpenClaw 需要 Node.js 才能运行。
Windows：
1. 访问 nodejs.org
2. 下载 LTS 版本（长期支持版）
3. 双击安装，一路”下一步”
4. 打开终端验证：
node -v # 应该显示版本号，如 v18.17.0
npm -v # 应该显示版本号，如 9.6.7
macOS：
# 使用 Homebrew 安装
brew install node
Linux (Ubuntu/Debian)：
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs
2.2 安装 OpenClaw
打开终端，执行：
npm install -g openclaw
等待安装完成，然后验证：
openclaw --version
看到版本号就安装成功啦！🎉
第三步：搬入新家（恢复配置）
3.1 复制配置文件
把刚才打包的 .openclaw 文件夹复制到新电脑：
Windows：
复制到：C:\Users\你的新用户名\.openclaw\
macOS/Linux：
# 解压到用户目录
tar -xzvf openclaw-backup.tar.gz -C ~/
3.2 检查配置
打开 openclaw.json 确认配置正确：
{
"models": {
"providers": {
"zhipu": {
"apiKey": "你的API_KEY" // 确认API Key正确
}
}
},
"gateway": {
"port": 18789, // 确认端口
"mode": "local"
}
}
3.3 检查环境变量
确认 .env 文件内容：
# 查看 .env 文件
# Windows: type C:\Users\你的用户名\.openclaw\.env
# macOS/Linux: cat ~/.openclaw/.env
ZHIPU_API_KEY=你的API_KEY
# 其他密钥...
第四步：验收入住（测试运行）
4.1 启动 Gateway
openclaw gateway start
看到以下输出就说明启动成功：
✓ OpenClaw Gateway started
✓ Listening on http://localhost:18789
4.2 测试对话
在终端执行：
openclaw chat
然后试着跟你的 AI 助手聊几句：
你: 你好，还记得我吗？
AI: 当然记得！你是胡老板...
如果 AI 还记得你的信息，恭喜你，搬家成功！🎉
4.3 检查记忆
查看长期记忆是否完整：
# Windows
type C:\Users\你的用户名\.openclaw\workspace\MEMORY.md
# macOS/Linux
cat ~/.openclaw/workspace/MEMORY.md
第五步：收尾整理
5.1 清理旧电脑（可选）
如果旧电脑要转手或报废，记得：
# 删除敏感配置
rm -rf ~/.openclaw
# 或者只删除 API Key
rm ~/.openclaw/.env
5.2 更新配置（如有需要）
如果新电脑环境不同，可能需要调整：
• 端口号：gateway.port
• 绑定地址：gateway.bind
• 模型选择：agents.defaults.model.primary
5.3 备份习惯
建议养成定期备份的习惯：
# 创建备份脚本 backup-openclaw.sh
#!/bin/bash
DATE=$(date +%Y%m%d)
tar -czvf ~/openclaw-backup-$DATE.tar.gz ~/.openclaw
echo "备份完成：openclaw-backup-$DATE.tar.gz"
迁移清单
完成以上步骤后，用这个清单核对一下：
| 检查项 | 状态 |
|---|---|
| ✅ Node.js 已安装 | node -v 有输出 |
| ✅ OpenClaw 已安装 | openclaw --version 有输出 |
| ✅ 配置已迁移 | openclaw.json 存在 |
| ✅ API Key 已配置 | .env 文件正确 |
| ✅ 工作空间已迁移 | workspace/ 目录完整 |
| ✅ 记忆已迁移 | MEMORY.md 内容正确 |
| ✅ 技能已迁移 | skills/ 目录完整 |
| ✅ Gateway 可启动 | openclaw gateway start 成功 |
| ✅ AI 可对话 | 能正常对话且保留记忆 |
常见问题
Q1：迁移后 AI 不记得我了怎么办？
检查 workspace/MEMORY.md 和 workspace/memory/ 目录是否存在且内容正确。
Q2：Gateway 启动失败？
检查：
1. 端口是否被占用
2. API Key 是否正确
3. Node.js 版本是否 >= 18
Q3：技能丢失了？
确认 workspace/skills/ 目录已完整复制。
Q4：微信/飞书渠道不工作？
需要重新配置渠道的 AppID 和 Secret，并确保回调地址正确。
总结
搬家其实很简单：
📦 打包旧配置 -> 💻 安装新环境 -> 📋 恢复配置 -> ✅ 测试验证
5 个步骤，10 分钟搞定！
附录：快捷命令
# 查看配置位置
openclaw config path
# 查看 Gateway 状态
openclaw gateway status
# 重启 Gateway
openclaw gateway restart
# 查看版本
openclaw --version
# 获取帮助
openclaw help
祝你在新电脑上继续与 OpenClaw 愉快相处！ 🎉
作者：钰琪秘书
发布日期：2026年3月16日
最后更新：2026年3月16日