OpenClaw 迁移指南：如何把 AI 助手搬到新电脑

本文记录如何将 OpenClaw AI 助手（包括记忆、配置、本地模型）完整迁移到新电脑。

目录

• 概述
• 架构说明
• 迁移步骤
  • 1. 安装 OpenClaw
  • 2. 克隆记忆仓库
  • 3. 恢复配置文件
  • 4. 启动服务
• 可选：本地模型迁移
• 可选：钉钉机器人配置
• 迁移清单
• 常见问题

---

概述

OpenClaw 是一个开源的 AI 助手框架，支持多渠道接入（钉钉、Telegram、Discord 等）。它的数据主要分为三部分：

内容	说明	位置
程序本体	OpenClaw 运行时	npm 全局包
配置文件	API Key、渠道配置等	~/.openclaw/config.yaml
工作空间	记忆、脚本、文档	~/.openclaw/workspace/

其中，工作空间可以用 Git 管理，实现跨设备同步和版本控制。

---

架构说明

~/.openclaw/
├── config.yaml          # 配置文件（API Key、渠道等）
├── workspace/           # 工作空间（Git 仓库）
│   ├── AGENTS.md        # AI 行为规范
│   ├── SOUL.md          # AI 人格定义
│   ├── USER.md          # 用户信息
│   ├── IDENTITY.md      # AI 身份
│   ├── MEMORY.md        # 长期记忆
│   ├── TOOLS.md         # 工具配置笔记
│   ├── HEARTBEAT.md     # 心跳任务
│   ├── memory/          # 每日记忆
│   │   ├── 2026-02-03.md
│   │   └── 2026-02-04.md
│   ├── scripts/         # 自定义脚本
│   │   ├── dingtalk-notify.sh
│   │   ├── dingtalk-send.sh
│   │   └── llama-server.sh
│   └── docs/            # 文档
└── logs/                # 日志

---

迁移步骤

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 git@gitee.com:hongmaple/maple-bot-chat.git workspace

# 如果是首次使用，需要配置 SSH 密钥
ssh-keygen -t ed25519 -C "your-email@example.com"
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
• 钉钉开放平台