iven/openclaw

Fork 0

Files

root 25a637aa58 Add complete migration guide for 淇淇

2026-03-10 14:25:44 +08:00

7.3 KiB

Raw Permalink Blame History

淇淇完整迁移指南

迁移概述

本文档提供将淇淇完整克隆到新服务器的完整步骤。

迁移内容清单

✅ 已备份到Git的内容

配置文件:
- config/clawdbot.json - Clawdbot主配置
- config/openclaw.json - OpenClaw配置
- CONFIG_BACKUP.md - 配置备份说明
文档:
- CONFIG_SYNC.md - Git同步说明
- GIT_STATUS.md - Git状态记录

⚠️ 需要手动处理的内容

Clawdbot/Clawd程序安装
插件安装（qqbot等）
工作区完整克隆（.git已包含，但需要完整拉取）
系统服务配置
环境变量（如果有）
API Keys/认证凭据（如果有独立配置）

方法一：快速迁移（推荐，使用配置文档）

适用于：只迁移核心配置，重新安装程序

1. 在新服务器上安装Clawdbot

# 安装Clawdbot
npm install -g @clawdbot/cli

# 验证安装
clawdbot --version

2. 克隆配置仓库

# 克隆仓库到临时目录
cd /tmp
git clone https://szends@126.com:2Live@2026*@git.stableeasy.com/iven/openclaw.git
cd openclaw

3. 恢复配置文件

# 创建配置目录
mkdir -p ~/.clawdbot
mkdir -p ~/.openclaw

# 复制配置文件
cp config/clawdbot.json ~/.clawdbot/clawdbot.json
cp config/openclaw.json ~/.openclaw/openclaw.json

# 设置权限
chmod 600 ~/.clawdbot/clawdbot.json
chmod 600 ~/.openclaw/openclaw.json

4. 安装QQBot插件

# 安装插件
openclaw plugins install @sliverp/qqbot@latest

# 或使用clawdbot命令（如果支持）
clawdbot plugin install @sliverp/qqbot@latest

5. 设置工作区

# 创建工作区目录
mkdir -p ~/clawd
cd ~/clawd

# 克隆完整工作区（如果需要保留git历史）
# 或初始化新的工作区

6. 启动Gateway

# 配置并启动systemd服务
clawdbot gateway install-service
clawdbot gateway start

# 或直接运行（开发模式）
clawdbot gateway

方法二：完整迁移（使用rsync/SSH）

适用于：完全复制当前服务器，包括所有文件和环境

1. 在原服务器打包

# 进入工作区
cd ~/clawd

# 打包配置文件和重要数据
tar -czf /tmp/qiqi-migration.tar.gz \
  ~/.clawdbot \
  ~/.openclaw \
  ~/clawd \
  ~/.ssh

# 传输到新服务器（使用scp）
scp /tmp/qiqi-migration.tar.gz user@new-server:/tmp/

2. 在新服务器解压

# 解压文件
cd /
tar -xzf /tmp/qiqi-migration.tar.gz

# 安装Clawdbot（如果未安装）
npm install -g @clawdbot/cli

# 安装插件依赖（可能需要重新安装）
cd ~/.openclaw/extensions/qqbot
npm install

3. 调整配置（如有需要）

# 编辑配置文件，修改服务器特定的设置
vim ~/.clawdbot/clawdbot.json
vim ~/.openclaw/openclaw.json

4. 启动服务

# 启动systemd服务
systemctl --user start clawdbot-gateway

# 检查状态
systemctl --user status clawdbot-gateway

方法三：Git完整克隆工作区

适用于：工作区已有git历史，需要完整保留

1. 克隆完整仓库

# 克隆仓库到新位置
git clone https://szends@126.com:2Live@2026*@git.stableeasy.com/iven/openclaw.git ~/clawd
cd ~/clawd

# 检查所有分支和标签
git branch -a
git tag

2. 恢复配置文件

# 复制配置到系统位置
mkdir -p ~/.clawdbot ~/.openclaw
cp config/clawdbot.json ~/.clawdbot/
cp config/openclaw.json ~/.openclaw/

# 设置权限
chmod 600 ~/.clawdbot/clawdbot.json
chmod 600 ~/.openclaw/openclaw.json

3. 安装Clawdbot和插件

# 安装Clawdbot
npm install -g @clawdbot/cli

# 安装QQBot插件
openclaw plugins install @sliverp/qqbot@latest

# 如果配置文件中配置了其他插件，也要安装
# 查看配置：cat ~/.openclaw/openclaw.json | grep -A 20 plugins

4. 启动并验证

# 启动gateway
clawdbot gateway start

# 查看日志
journalctl --user -u clawdbot-gateway -f
# 或
tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log

配置文件说明

clawdbot.json 关键配置

{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "1903233329",
      "clientSecret": "CNSQI2lUDwd9c3Oj"
    }
  },
  "gateway": {
    "port": 18789,
    "token": "19a6f039c7d4ff4c09d0db52022c0ec111b6f1a3abb5cc18"
  }
}

openclaw.json 关键配置

{
  "channels": {
    "qqbot": {
      "enabled": true,
      "appId": "1903233329",
      "clientSecret": "CNSQI2lUDwd9c3Oj"
    }
  }
}

验证步骤

1. 检查配置文件

# 验证Clawdbot配置
cat ~/.clawdbot/clawdbot.json | jq .

# 验证OpenClaw配置
cat ~/.openclaw/openclaw.json | jq .

2. 检查插件安装

# 检查插件目录
ls -la ~/.openclaw/extensions/

# 检查qqbot插件
ls -la ~/.openclaw/extensions/qqbot/

3. 检查Gateway状态

# 检查服务状态
clawdbot gateway status

# 或systemd服务
systemctl --user status clawdbot-gateway

4. 测试QQBot连接

在QQ中发送测试消息给机器人，检查是否能收到回复。

常见问题

Q1: 配置文件中的token可以复制吗？

A: Gateway token可以在相同环境复制使用，但建议在每台服务器上重新生成。

Q2: 插件需要重新安装吗？

A: 是的，插件需要在新服务器上重新安装。配置文件中的插件配置仅用于启用/禁用。

Q3: 工作区中的文件会被迁移吗？

方法一: 不会，需要手动迁移或重新clone
方法二: 会，打包迁移
方法三: 会，通过git clone迁移

Q4: 环境变量需要配置吗？

A: 检查原服务器的环境变量（env | grep -i clawd），在新服务器上设置相同的变量。

Q5: 需要重新配置QQBot吗？

A: 配置文件中已包含AppID和AppSecret，直接复制即可使用。

迁移后的维护

定期同步配置

cd ~/clawd
# 拉取最新配置
git pull origin master

# 如有本地修改，合并或解决冲突

Git配置同步

原服务器修改配置后自动推送：

cd ~/clawd
cp ~/.clawdbot/clawdbot.json config/
cp ~/.openclaw/openclaw.json config/
git add config/
git commit -m "Update config files"
git push origin master

新服务器拉取配置：

cd ~/clawd
git pull origin master
cp config/clawdbot.json ~/.clawdbot/
cp config/openclaw.json ~/.openclaw/
clawdbot gateway restart

总结

方案	复杂度	完整性	推荐场景
方法一（快速）	⭐ 简单	⭐⭐⭐ 配置完整	新服务器独立部署
方法二（完整）	⭐⭐⭐ 复杂	⭐⭐⭐⭐⭐ 完全复制	完全克隆现有服务器
方法三（Git）	⭐⭐ 中等	⭐⭐⭐⭐ 工作区完整	需要保留git历史

选择建议:

首次迁移 → 方法一
需要完全一样 → 方法二
需要保留git历史 → 方法三

7.3 KiB Raw Permalink Blame History Unescape Escape