📚 渡口文档库

n160 · /home/joehuang

🏠 首页
📄 ~/浩元渡口/成品库/SYSTEM_RECOVERY_MANUAL.md

🚨 浩元居系统恢复操作手册

文件位置: /home/joehuang/.openclaw/SYSTEM_RECOVERY_MANUAL.md

最后更新: 2026-04-29 by 吉修

备份位置: /mnt/share/backups/openclaw/scripts/（每2小时更新）

⚠️ 你不在时，按以下步骤一步步手动执行即可恢复全部服务

⚡ 快速恢复（3分钟）

第一步：SSH登录服务器后执行

bash /home/joehuang/.openclaw/scripts/system_restore.sh

等待30秒，检查输出是否全部 ✅

📋 详细恢复步骤（按顺序执行）

阶段1：检查系统状态（立即）

# 1.1 检查cron是否运行
ps aux | grep cron | grep -v grep

# 1.2 检查当前crontab
crontab -l | wc -l
# 如果显示数字 < 20，说明crontab丢失，需要恢复

阶段2：恢复Crontab（如果丢失）

# 2.1 查看是否有master crontab备份
ls -la /home/joehuang/.openclaw/scripts/master_crontab.txt

# 2.2 恢复crontab
crontab /home/joehuang/.openclaw/scripts/master_crontab.txt

# 2.3 验证
crontab -l | wc -l
# 应该显示 21

阶段3：启动关键服务

# 3.1 检查mihomo（代理服务）
ps aux | grep mihomo | grep -v grep
# 如果没有运行：
sudo systemctl start mihomo

# 3.2 检查SearXNG（搜索）
ps aux | grep searxng | grep -v grep
# 如果没有运行：
nohup /home/joehuang/.local/bin/searxng > /home/joehuang/.openclaw/logs/searxng.log 2>&1 &

# 3.3 检查hermes（助手）
ps aux | grep hermes | grep -v grep
# 如果没有运行：
cd /opt-var-home/home/joehuang/.hermes
HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 TELEGRAM_PROXY=http://127.0.0.1:7890 \
nohup /home/joehuang/.local/bin/hermes gateway run --replace >> /opt-var-home/home/joehuang/.hermes/hermes.log 2>&1 &

# 3.4 检查OpenClaw
ps aux | grep openclaw | grep -v grep
# 如果没有运行：
cd /home/joehuang/.openclaw
nohup /home/joehuang/.local/bin/openclaw gateway run >> /home/joehuang/.openclaw/logs/openclaw.log 2>&1 &

阶段4：验证恢复结果

# 4.1 检查所有进程
ps aux | grep -E "(openclaw|hermes|searxng|mihomo)" | grep -v grep

# 4.2 检查端口
netstat -tlnp | grep -E "(8888|7890|8792)"

# 4.3 测试SearXNG搜索
curl "http://127.0.0.1:8888/search?q=test&format=json&limit=1"

# 4.4 检查cron任务数
crontab -l | grep -v "^#" | grep -v "^$" | wc -l
# 应该显示 21

🔧 单独恢复某个服务

恢复 SearXNG（搜索服务）

# 停止旧进程
pkill -f searxng

# 启动
nohup /home/joehuang/.local/bin/searxng > /home/joehuang/.openclaw/logs/searxng.log 2>&1 &

# 验证
curl "http://127.0.0.1:8888/search?q=test&format=json&limit=1"

恢复 hermes（助手Bot）

# 停止旧进程
pkill -f hermes

# 启动
cd /opt-var-home/home/joehuang/.hermes
HTTP_PROXY=http://127.0.0.1:7890 HTTPS_PROXY=http://127.0.0.1:7890 TELEGRAM_PROXY=http://127.0.0.1:7890 \
nohup /home/joehuang/.local/bin/hermes gateway run --replace >> /opt-var-home/home/joehuang/.hermes/hermes.log 2>&1 &

# 验证
ps aux | grep hermes | grep -v grep

恢复 OpenClaw Gateway

# 停止旧进程
pkill -f openclaw

# 启动
cd /home/joehuang/.openclaw
nohup /home/joehuang/.local/bin/openclaw gateway run >> /home/joehuang/.openclaw/logs/openclaw.log 2>&1 &

# 验证
ps aux | grep openclaw | grep -v grep

恢复 mihomo（代理服务）

# 检查状态
systemctl status mihomo

# 启动/重启
sudo systemctl restart mihomo

# 验证
curl -x http://127.0.0.1:7890 https://api.telegram.org -v 2>&1 | head

恢复 Hub Parser Daemon

# 检查进程
ps aux | grep parser_daemon | grep -v grep

# 如果没有运行：
nohup /usr/bin/python3 /home/joehuang/.openclaw/projects/agent-hub/parser_daemon.py >> /home/joehuang/.openclaw/logs/parser_daemon.log 2>&1 &

📁 备份文件位置

自动备份（每2小时）

类型 路径 保留份数
脚本备份 /mnt/share/backups/openclaw/scripts/ 84份（7天）
最新符号链接 latest_scripts_backup.tar.gz -

每日全量备份（23:59）

类型 路径 保留天数
完整备份 /mnt/share/backups/openclaw/openclaw-full-*.tar.gz 30天

系统快照

类型 路径
最新快照 /home/joehuang/.openclaw/snapshots/snapshot_latest.json
快照历史 /home/joehuang/.openclaw/snapshots/snapshot_*.json

Master Crontab

类型 路径
完整配置 /home/joehuang/.openclaw/scripts/master_crontab.txt

🔄 从备份恢复单个脚本

方法1：从高频备份恢复

# 查看可用备份
ls -la /mnt/share/backups/openclaw/scripts/

# 解压到临时目录
cd /tmp
tar xzf /mnt/share/backups/openclaw/scripts/scripts_backup_YYYYMMDD_HHMM.tar.gz

# 复制需要的文件
cp /tmp/xxx/你需要的文件 /home/joehuang/.openclaw/scripts/

方法2：从git恢复

cd /home/joehuang/.openclaw/scripts
git log --oneline -10
git checkout <commit_hash> -- <文件名>

🚨 紧急情况处理

情况1：完全不知道发生了什么

# 1. 查看系统日志
tail -100 /home/joehuang/.openclaw/logs/openclaw.log
tail -100 /home/joehuang/.openclaw/logs/searxng_monitor.log

# 2. 查看最新快照
cat /home/joehuang/.openclaw/snapshots/snapshot_latest.json

# 3. 执行完整恢复
bash /home/joehuang/.openclaw/scripts/system_restore.sh

情况2：SearXNG完全无响应

# 1. 杀死所有相关进程
pkill -9 -f searxng

# 2. 检查端口是否释放
netstat -tlnp | grep 8888

# 3. 重新启动
nohup /home/joehuang/.local/bin/searxng > /home/joehuang/.openclaw/logs/searxng.log 2>&1 &

# 4. 等10秒后测试
sleep 10
curl "http://127.0.0.1:8888/search?q=test&format=json&limit=1"

情况3：OpenClaw无法启动

# 1. 检查端口是否被占用
netstat -tlnp | grep 8792

# 2. 查看错误日志
tail -50 /home/joehuang/.openclaw/logs/openclaw.log

# 3. 尝试重启
cd /home/joehuang/.openclaw
openclaw gateway stop 2>/dev/null || true
sleep 2
nohup /home/joehuang/.local/bin/openclaw gateway run >> /home/joehuang/.openclaw/logs/openclaw.log 2>&1 &

情况4：所有Agent都不响应

# 1. 检查Hub是否运行
ps aux | grep "parser_daemon" | grep -v grep

# 2. 检查Hub API
curl http://127.0.0.1:8792/api/health 2>/dev/null || echo "Hub API无响应"

# 3. 重启Hub
pkill -f parser_daemon
sleep 2
nohup /usr/bin/python3 /home/joehuang/.openclaw/projects/agent-hub/parser_daemon.py >> /home/joehuang/.openclaw/logs/parser_daemon.log 2>&1 &

📞 需要帮助时

  1. 查看日志：/home/joehuang/.openclaw/logs/
  2. 查看快照：/home/joehuang/.openclaw/snapshots/snapshot_latest.json
  3. 联系吉修：通过Telegram发送问题

✅ 恢复完成检查清单

浩元居口号: 纳浩元正气，布太和人居 🏮
备份位置: /mnt/share/backups/openclaw/scripts/