OpenClaw AI 助手跨设备迁移指南

迁移步骤

1. 安装 OpenClaw

前置要求： Node.js 18+

# Ubuntu/Debian - 安装 Node.js
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

# 或使用 nvm（推荐）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.0/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22

# 安装 OpenClaw
npm install -g openclaw

# 验证安装
openclaw --version

2. 克隆记忆仓库

# 创建 OpenClaw 目录
mkdir -p ~/.openclaw
cd ~/.openclaw

# 克隆工作空间（替换为你的仓库地址）
git clone [email protected]:hongmaple/maple-bot-chat.git workspace

# 如果是首次使用，需要配置 SSH 密钥
ssh-keygen -t ed25519 -C "[email protected]"
cat ~/.ssh/id_ed25519.pub
# 将公钥添加到 Gitee 账号

3. 恢复配置文件

配置文件包含敏感信息（API Key），建议手动复制或使用加密备份。

方法 A：手动复制 从旧电脑复制 ~/.openclaw/config.yaml 到新电脑相同位置。

方法 B：从模板创建

# 初始化配置
openclaw init

# 编辑配置文件
nano ~/.openclaw/config.yaml

配置文件示例：

# ~/.openclaw/config.yaml
version: "1"
# AI 模型配置
models:
  default: anthropic/claude-sonnet-4-20250514
providers:
  anthropic:
    apiKey: "sk-ant-xxxxx" # 你的 API Key
# 渠道配置（可选）
channels:
  dingtalk:
    enabled: true
    appKey: "your-app-key"
    appSecret: "your-app-secret"
    replyMode: "markdown"
# 心跳配置
heartbeat:
  enabled: true
  intervalMinutes: 30

4. 启动服务

# 启动 OpenClaw Gateway
openclaw gateway start

# 查看状态
openclaw gateway status

# 查看日志
openclaw gateway logs

可选：本地模型迁移

如果你使用 llama.cpp 运行本地模型，也需要迁移。

安装 llama.cpp

# 安装依赖
sudo apt install -y build-essential cmake

# 克隆并编译
cd ~
git clone https://github.com/ggml-org/llama.cpp.git
cd llama.cpp
mkdir -p build && cd build
cmake ..
cmake --build . --config Release -j$(nproc)

下载模型

cd ~/llama.cpp/models
# 使用国内镜像下载（推荐）
wget https://hf-mirror.com/Qwen/Qwen2.5-3B-Instruct-GGUF/resolve/main/qwen2.5-3b-instruct-q4_k_m.gguf
# 或者从旧电脑复制模型文件（约 2GB）
# scp old-pc:~/llama.cpp/models/*.gguf .

使用启动脚本

工作空间中包含了 llama-server 启动脚本：

# 创建软链接
ln -sf ~/.openclaw/workspace/scripts/llama-server.sh ~/llama-server

# 启动服务
~/llama-server start

# 查看状态
~/llama-server status

# 测试 API
~/llama-server test

API 地址： http://127.0.0.1:11434/v1/chat/completions

可选：钉钉机器人配置

企业内部应用（双向通信）

1. 登录 钉钉开放平台
2. 创建企业内部应用 → 机器人
3. 获取 AppKey 和 AppSecret
4. 配置消息接收地址：https://your-domain/webhook/dingtalk
5. 在 config.yaml 中配置

Webhook 机器人（仅推送）

1. 在钉钉群 → 群设置 → 智能群助手 → 添加机器人
2. 选择"自定义 Webhook"
3. 记录 Webhook URL 和加签密钥
4. 使用 scripts/dingtalk-notify.sh 发送消息

# 使用示例
~/.openclaw/workspace/scripts/dingtalk-notify.sh "这是一条测试消息"

迁移清单

使用此清单确保迁移完整：

• 新电脑安装 Node.js 18+
• 安装 OpenClaw：npm install -g openclaw
• 克隆工作空间：git clone ... ~/.openclaw/workspace
• 复制/创建配置文件：~/.openclaw/config.yaml
• 配置 SSH 密钥（用于 Git 同步）
• 启动服务：openclaw gateway start
• （可选）安装 llama.cpp 和模型
• （可选）配置钉钉机器人
• 测试 AI 对话是否正常

常见问题

Q: 迁移后 AI 还记得之前的事吗？

A: 是的！记忆存储在 workspace/memory/ 和 MEMORY.md 中，通过 Git 同步后会完整保留。

Q: API Key 需要重新申请吗？

A: 不需要，直接复制旧的 config.yaml 即可。但建议定期轮换 Key 以保证安全。

Q: 本地模型文件很大，如何快速迁移？

A: 几个选项：

1. 局域网直接复制（最快）
2. 移动硬盘
3. 重新下载（使用 hf-mirror.com 国内镜像）

Q: 如何在多台电脑同时使用？

A: 可以，但注意：

1. 只能有一台电脑运行 OpenClaw Gateway（避免消息重复）
2. 工作空间通过 Git 同步，注意解决冲突
3. 或者使用云服务器部署，多设备访问

Q: Windows 可以用吗？

A: 推荐使用 WSL2（Windows Subsystem for Linux），体验与原生 Linux 一致。

相关链接

• OpenClaw 官方文档
• OpenClaw GitHub
• llama.cpp GitHub
• 钉钉开放平台