Add complete migration guide for 淇淇

MIGRATION_GUIDE.md

@@ -0,0 +1,377 @@
+# 淇淇完整迁移指南
+
+## 迁移概述
+
+本文档提供将淇淇完整克隆到新服务器的完整步骤。
+
+## 迁移内容清单
+
+### ✅ 已备份到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
+
+```bash
+# 安装Clawdbot
+npm install -g @clawdbot/cli
+
+# 验证安装
+clawdbot --version
+```
+
+### 2. 克隆配置仓库
+
+```bash
+# 克隆仓库到临时目录
+cd /tmp
+git clone https://szends@126.com:2Live@2026*@git.stableeasy.com/iven/openclaw.git
+cd openclaw
+```
+
+### 3. 恢复配置文件
+
+```bash
+# 创建配置目录
+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插件
+
+```bash
+# 安装插件
+openclaw plugins install @sliverp/qqbot@latest
+
+# 或使用clawdbot命令（如果支持）
+clawdbot plugin install @sliverp/qqbot@latest
+```
+
+### 5. 设置工作区
+
+```bash
+# 创建工作区目录
+mkdir -p ~/clawd
+cd ~/clawd
+
+# 克隆完整工作区（如果需要保留git历史）
+# 或初始化新的工作区
+```
+
+### 6. 启动Gateway
+
+```bash
+# 配置并启动systemd服务
+clawdbot gateway install-service
+clawdbot gateway start
+
+# 或直接运行（开发模式）
+clawdbot gateway
+```
+
+---
+
+## 方法二：完整迁移（使用rsync/SSH）
+
+适用于：完全复制当前服务器，包括所有文件和环境
+
+### 1. 在原服务器打包
+
+```bash
+# 进入工作区
+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. 在新服务器解压
+
+```bash
+# 解压文件
+cd /
+tar -xzf /tmp/qiqi-migration.tar.gz
+
+# 安装Clawdbot（如果未安装）
+npm install -g @clawdbot/cli
+
+# 安装插件依赖（可能需要重新安装）
+cd ~/.openclaw/extensions/qqbot
+npm install
+```
+
+### 3. 调整配置（如有需要）
+
+```bash
+# 编辑配置文件，修改服务器特定的设置
+vim ~/.clawdbot/clawdbot.json
+vim ~/.openclaw/openclaw.json
+```
+
+### 4. 启动服务
+
+```bash
+# 启动systemd服务
+systemctl --user start clawdbot-gateway
+
+# 检查状态
+systemctl --user status clawdbot-gateway
+```
+
+---
+
+## 方法三：Git完整克隆工作区
+
+适用于：工作区已有git历史，需要完整保留
+
+### 1. 克隆完整仓库
+
+```bash
+# 克隆仓库到新位置
+git clone https://szends@126.com:2Live@2026*@git.stableeasy.com/iven/openclaw.git ~/clawd
+cd ~/clawd
+
+# 检查所有分支和标签
+git branch -a
+git tag
+```
+
+### 2. 恢复配置文件
+
+```bash
+# 复制配置到系统位置
+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和插件
+
+```bash
+# 安装Clawdbot
+npm install -g @clawdbot/cli
+
+# 安装QQBot插件
+openclaw plugins install @sliverp/qqbot@latest
+
+# 如果配置文件中配置了其他插件，也要安装
+# 查看配置：cat ~/.openclaw/openclaw.json | grep -A 20 plugins
+```
+
+### 4. 启动并验证
+
+```bash
+# 启动gateway
+clawdbot gateway start
+
+# 查看日志
+journalctl --user -u clawdbot-gateway -f
+# 或
+tail -f /tmp/clawdbot/clawdbot-$(date +%Y-%m-%d).log
+```
+
+---
+
+## 配置文件说明
+
+### clawdbot.json 关键配置
+```json
+{
+  "channels": {
+    "qqbot": {
+      "enabled": true,
+      "appId": "1903233329",
+      "clientSecret": "CNSQI2lUDwd9c3Oj"
+    }
+  },
+  "gateway": {
+    "port": 18789,
+    "token": "19a6f039c7d4ff4c09d0db52022c0ec111b6f1a3abb5cc18"
+  }
+}
+```
+
+### openclaw.json 关键配置
+```json
+{
+  "channels": {
+    "qqbot": {
+      "enabled": true,
+      "appId": "1903233329",
+      "clientSecret": "CNSQI2lUDwd9c3Oj"
+    }
+  }
+}
+```
+
+---
+
+## 验证步骤
+
+### 1. 检查配置文件
+
+```bash
+# 验证Clawdbot配置
+cat ~/.clawdbot/clawdbot.json | jq .
+
+# 验证OpenClaw配置
+cat ~/.openclaw/openclaw.json | jq .
+```
+
+### 2. 检查插件安装
+
+```bash
+# 检查插件目录
+ls -la ~/.openclaw/extensions/
+
+# 检查qqbot插件
+ls -la ~/.openclaw/extensions/qqbot/
+```
+
+### 3. 检查Gateway状态
+
+```bash
+# 检查服务状态
+clawdbot gateway status
+
+# 或systemd服务
+systemctl --user status clawdbot-gateway
+```
+
+### 4. 测试QQBot连接
+
+在QQ中发送测试消息给机器人，检查是否能收到回复。
+
+---
+
+## 常见问题
+
+### Q1: 配置文件中的token可以复制吗？
+A: Gateway token可以在相同环境复制使用，但建议在每台服务器上重新生成。
+
+### Q2: 插件需要重新安装吗？
+A: 是的，插件需要在新服务器上重新安装。配置文件中的插件配置仅用于启用/禁用。
+
+### Q3: 工作区中的文件会被迁移吗？
+A:
+- **方法一:** 不会，需要手动迁移或重新clone
+- **方法二:** 会，打包迁移
+- **方法三:** 会，通过git clone迁移
+
+### Q4: 环境变量需要配置吗？
+A: 检查原服务器的环境变量（`env | grep -i clawd`），在新服务器上设置相同的变量。
+
+### Q5: 需要重新配置QQBot吗？
+A: 配置文件中已包含AppID和AppSecret，直接复制即可使用。
+
+---
+
+## 推荐迁移方案
+
+**对于大多数情况，推荐使用方法一（快速迁移）：**
+
+1. 安装Clawdbot
+2. 克隆配置仓库
+3. 恢复配置文件
+4. 安装插件
+5. 克隆工作区（可选）
+6. 启动服务
+
+**优点:**
+- 简单快速
+- 避免复制不必要的文件
+- 确保新环境干净
+
+**适用场景:**
+- 新服务器需要干净的安装
+- 原服务器可能有很多临时文件
+- 需要保持两个服务器独立运行
+
+---
+
+## 迁移后的维护
+
+### 定期同步配置
+
+```bash
+cd ~/clawd
+# 拉取最新配置
+git pull origin master
+
+# 如有本地修改，合并或解决冲突
+```
+
+### Git配置同步
+
+原服务器修改配置后自动推送：
+```bash
+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
+```
+
+新服务器拉取配置：
+```bash
+cd ~/clawd
+git pull origin master
+cp config/clawdbot.json ~/.clawdbot/
+cp config/openclaw.json ~/.openclaw/
+clawdbot gateway restart
+```
+
+---
+
+## 总结
+
+| 方案 | 复杂度 | 完整性 | 推荐场景 |
+|-----|--------|--------|----------|
+| 方法一（快速） | ⭐ 简单 | ⭐⭐⭐ 配置完整 | 新服务器独立部署 |
+| 方法二（完整） | ⭐⭐⭐ 复杂 | ⭐⭐⭐⭐⭐ 完全复制 | 完全克隆现有服务器 |
+| 方法三（Git） | ⭐⭐ 中等 | ⭐⭐⭐⭐ 工作区完整 | 需要保留git历史 |
+
+**选择建议:**
+- 首次迁移 → 方法一
+- 需要完全一样 → 方法二
+- 需要保留git历史 → 方法三