Clawdbot 升级指南：如何保护记忆文件不丢失
Clawdbot 升级指南：如何保护记忆文件不丢失
每次看到 clawdbot update 时，你是否也有这样的担忧：升级后我的 AI 助手会忘记一切吗？Clawdbot 更新频繁（目前还未到 1.0），每次升级都可能带来新功能和修复。但与此同时，记忆文件的保护也至关重要。本文将详细说明：
- ✅ 升级时哪些文件是安全的
- ✅ 哪些记忆文件必须备份
- ✅ 完整的备份与升级流程
- ✅ 出问题后如何恢复
一、升级会丢失记忆吗？
答案：不会。 但备份仍然是必要的。
根据官方文档，Clawdbot 升级不会删除用户目录中的任何文件。你的所有记忆文件都存储在工作区目录中，完全独立于 Clawdbot 程序本身。
1.1 安全的文件位置
| 文件类型 | 位置 | 说明 |
|---|---|---|
| 记忆文件 | /root/clawd/memory/ | 每日记录、项目笔记 |
| 长期记忆 | /root/clawd/MEMORY.md | 精选的重要信息 |
| 工作区 | /root/clawd/ | 整个目录 |
| 配置文件 | ~/.clawdbot/clawdbot.json | Gateway 配置 |
| 凭据 | ~/.clawdbot/credentials/ | 密钥和令牌 |
这些目录在升级时完全不会被触碰，所以理论上你的记忆是安全的。
1.2 为什么还需要备份？
虽然升级不会删除文件，但以下情况仍可能导致数据丢失：
- ⚠️ 误操作（如手动删除）
- ⚠️ 磁盘故障
- ⚠️ 升级过程中的意外中断
- ⚠️ 配置错误导致的服务异常
最佳实践：升级前备份，有备无患。
二、记忆文件全集详解
在备份之前，你需要知道 Clawdbot 有哪些记忆文件。它们分为几个层级：
2.1 核心身份文件（7个）
这些文件定义了 AI 助手的核心身份，位于 /root/clawd/ 根目录：
/root/clawd/
├── AGENTS.md # 📖 工作指南（7.7K）
├── SOUL.md # 🎭 个性定义（1.7K）
├── USER.md # 👤 用户信息（2.9K）
├── IDENTITY.md # 🪪 身份卡片（435B）
├── TOOLS.md # 🔧 工具笔记（858B）
├── MEMORY.md # 🧠 长期记忆（7.5K）
└── HEARTBEAT.md # 💓 心跳检查（567B）每个文件的作用：
| 文件 | 作用 | 重要性 |
|---|---|---|
| MEMORY.md | 长期记忆，精选的重要信息，持久化保存 | ⭐⭐⭐⭐⭐ |
| AGENTS.md | 工作指南，定义如何工作、记忆规则 | ⭐⭐⭐⭐⭐ |
| SOUL.md | 个性定义，你的性格、行为准则 | ⭐⭐⭐⭐ |
| USER.md | 用户信息，老板的资料、技术栈 | ⭐⭐⭐⭐ |
| IDENTITY.md | 身份卡片，名字、称呼、emoji | ⭐⭐⭐ |
| TOOLS.md | 工具笔记，环境特定的配置 | ⭐⭐⭐ |
| HEARTBEAT.md | 心跳检查，定时任务的检查清单 | ⭐⭐ |
2.2 每日记忆文件
按日期命名的原始记录，位于 /root/clawd/memory/：
memory/
├── 2026-02-14.md # 2月14日的原始记录
├── 2026-02-13.md # 2月13日的原始记录
├── 2026-02-12.md # 2月12日的原始记录
├── 2026-02-12-night.md # 当晚的专项记录
├── 2026-02-11.md # ...
├── 2026-02-10.md
├── 2026-02-09.md
├── 2026-02-09-log-server.md
├── 2026-02-08.md
├── 2026-02-07.md
├── 2026-02-06.md
├── 2026-02-04.md
├── 2026-02-01.md
└── 2026-01-31.md作用：
- 原始日志，记录当天发生的所有事情
- 定期会整理重要内容到 MEMORY.md
- 就像人类的日记，可以回顾但不用每天读
2.3 项目/主题记忆
特定主题的专业知识，也在 /root/clawd/memory/ 目录下：
memory/
├── playground-essentials-20260212.md # 游乐场项目核心知识
├── playground-evolution.md # 游乐场演进历史
├── playground-quickref.md # 游乐场快速参考
├── playground-rhythm-master.md # 节奏大师游戏
├── blog-expert-knowledge-accessible.md # 博客专家知识
├── blog-expert-backup-2026-02-13.md
├── blog-expert-deleted-2026-02-13.md
├── calculator-improvements.md # 计算器改进记录
├── learning-notes.md # 学习笔记
├── diaries.md # 日记汇总
├── overnight-report.md # 过夜工作报告
├── overnight-work.md # 过夜工作记录
├── context-compressed-20260211.md # 上下文压缩记录
├── context-compressed-20260211-16-40.md
├── context-summary-2026-02-12.md # 上下文摘要
└── extracted-context-2026-02-12.md # 提取的上下文2.4 多 Agent 记忆系统
Clawdbot 支持多个子 Agent，每个都有独立的记忆：
memory/
├── planner/ # 规划者角色
│ ├── MEMORY.md # 规划者的长期记忆
│ └── daily/ # 规划者的每日记录
├── health/ # 健康管理者角色
│ ├── MEMORY.md # 健康管理者的长期记忆
│ └── daily/ # 健康管理者的每日记录
└── ...这种设计让不同角色可以拥有独立的知识库，互不干扰。
2.5 完整目录结构树
以下是完整的记忆文件系统结构：
/root/clawd/
├── MEMORY.md # 🧠 长期记忆（主会话）
├── AGENTS.md # 📖 工作指南
├── SOUL.md # 🎭 个性定义
├── USER.md # 👤 用户信息
├── IDENTITY.md # 🪪 身份卡片
├── TOOLS.md # 🔧 工具笔记
├── HEARTBEAT.md # 💓 心跳检查
│
└── memory/ # 记忆目录
├── 2026-02-14.md # 每日记录
├── 2026-02-13.md
├── 2026-02-12.md
├── ...
├── playground-essentials-20260212.md
├── blog-expert-knowledge-accessible.md
├── learning-notes.md
├── ...
│
├── planner/ # 子Agent记忆
│ ├── MEMORY.md
│ └── daily/
│
└── health/ # 子Agent记忆
├── MEMORY.md
└── daily/三、升级前的备份策略
3.1 快速完整备份（推荐）
一键备份整个工作区：
# 创建带时间戳的备份
cd /root
tar -czf clawd-backup-$(date +%Y%m%d-%H%M%S).tar.gz clawd/
# 验证备份文件
ls -lh clawd-backup-*.tar.gz备份文件示例：
-rw-r--r-- 1 root root 2.3M Feb 15 15:30 clawd-backup-20260215-153000.tar.gz恢复备份：
# 如果需要恢复
cd /root
tar -xzf clawd-backup-20260215-153000.tar.gz
# 这会恢复整个 clawd 目录3.2 选择性备份
如果只想备份记忆文件，可以这样做：
# 备份核心记忆文件
tar -czf memory-core-$(date +%Y%m%d).tar.gz \
/root/clawd/MEMORY.md \
/root/clawd/AGENTS.md \
/root/clawd/SOUL.md \
/root/clawd/USER.md \
/root/clawd/IDENTITY.md \
/root/clawd/TOOLS.md
# 备份整个 memory 目录
tar -czf memory-daily-$(date +%Y%m%d).tar.gz /root/clawd/memory/3.3 备份验证脚本
创建一个验证脚本来确保备份成功：
#!/bin/bash
# backup-verify.sh
BACKUP_FILE=$1
TEMP_DIR=$(mktemp -d)
echo "验证备份: $BACKUP_FILE"
# 解压到临时目录
tar -xzf "$BACKUP_FILE" -C "$TEMP_DIR"
# 检查关键文件
CRITICAL_FILES=(
"root/clawd/MEMORY.md"
"root/clawd/AGENTS.md"
"root/clawd/SOUL.md"
"root/clawd/USER.md"
)
ALL_GOOD=true
for file in "${CRITICAL_FILES[@]}"; do
if [ -f "$TEMP_DIR/$file" ]; then
echo "✅ $file"
else
echo "❌ $file 缺失！"
ALL_GOOD=false
fi
done
# 清理
rm -rf "$TEMP_DIR"
if [ "$ALL_GOOD" = true ]; then
echo "✅ 备份验证通过"
exit 0
else
echo "❌ 备份验证失败"
exit 1
fi使用方法：
chmod +x backup-verify.sh
./backup-verify.sh clawd-backup-20260215-153000.tar.gz3.4 自动化备份
设置定时任务自动备份（每天凌晨）：
# 编辑 crontab
crontab -e
# 添加以下行（每天凌晨2点备份）
0 2 * * * tar -czf /root/backups/clawd-$(date +\%Y\%m\%d).tar.gz /root/clawd/四、安全升级流程
4.1 升级方式选择
Clawdbot 提供三种升级方式：
| 方式 | 适用场景 | 风险 |
|---|---|---|
| clawdbot update | 源码安装 | ⭐ 最低 |
| npm/pnpm 全局更新 | 全局安装 | ⭐⭐ 低 |
| 重新运行安装脚本 | 任何安装方式 | ⭐⭐⭐ 中 |
推荐：使用 clawdbot update
4.2 完整升级步骤
步骤1：创建备份
# 创建备份
cd /root
tar -czf clawd-backup-$(date +%Y%m%d-%H%M%S).tar.gz clawd/
# 验证备份
# （使用上面的 backup-verify.sh 脚本）步骤2：检查当前版本
# 查看当前版本
clawdbot --version
# 查看更新日志
# （根据安装方式不同，命令可能不同）步骤3：执行升级
# 方式1：使用 clawdbot update（推荐）
clawdbot update
# 方式2：npm 全局更新
npm i -g clawdbot@latest
# 方式3：重新运行安装脚本
curl -fsSL https://clawd.bot/install.sh | bash步骤4：运行 doctor 检查
# doctor 会自动检测并修复配置问题
clawdbot doctor步骤5：重启 Gateway
# 重启服务
clawdbot gateway restart
# 或者使用 systemd
systemctl --user restart clawdbot-gateway.service步骤6：验证升级
# 检查服务状态
clawdbot gateway status
# 检查日志
clawdbot logs --follow
# 查看版本
clawdbot --version步骤7：验证记忆文件
# 确认记忆文件存在
ls -lh /root/clawd/MEMORY.md
ls -lh /root/clawd/memory/
# 读取 MEMORY.md 确认内容
head -20 /root/clawd/MEMORY.md4.3 升级检查清单
在升级前，确保完成以下检查：
□ 已创建完整备份
□ 备份文件已验证
□ 知道当前版本号
□ 了解本次更新的内容
□ 准备好了回滚方案
□ 非高峰时段（避免影响使用）五、故障恢复
5.1 记忆文件丢失怎么办
如果升级后发现记忆文件丢失，按以下步骤恢复：
步骤1：不要慌，停止写入
# 立即停止 Clawdbot Gateway
clawdbot gateway stop步骤2：确认文件状态
# 检查记忆文件是否真的丢失
ls -la /root/clawd/MEMORY.md
ls -la /root/clawd/memory/步骤3：从备份恢复
# 找到最新的备份文件
ls -lh /root/clawd-backup-*.tar.gz
# 解压恢复（覆盖当前文件）
cd /root
tar -xzf clawd-backup-20260215-153000.tar.gz
# 验证恢复的文件
ls -lh clawd/MEMORY.md步骤4：重启服务
# 重启 Gateway
clawdbot gateway restart5.2 升级失败回滚
如果升级后出现严重问题，需要回滚到之前版本：
方法1：回退到特定版本（npm 安装）
# 查看可用版本
npm view clawdbot versions
# 安装已知良好的版本
npm i -g clawdbot@<version>
# 例如：
# npm i -g clawdbot@0.9.15
# 重启
clawdbot gateway restart方法2：回退到特定日期（git 安装）
# 进入仓库目录
cd /path/to/clawdbot/repo
# 回退到指定日期的代码
git fetch origin
git checkout "$(git rev-list -n 1 --before=\"2026-02-01\" origin/main)"
# 重新安装
pnpm install
pnpm build
# 重启
clawdbot gateway restart5.3 常见问题排查
问题1：升级后找不到记忆文件
症状：
Error: Cannot find module '/root/clawd/MEMORY.md'解决方案：
- 检查工作目录是否正确
- 检查环境变量
CLAWDBOT_WORKSPACE - 从备份恢复
问题2：配置文件损坏
症状：
Error: Invalid configuration in ~/.clawdbot/clawdbot.json解决方案：
# 运行 doctor 修复
clawdbot doctor
# 手动检查配置
cat ~/.clawdbot/clawdbot.json问题3：无法启动 Gateway
症状：
Error: Gateway failed to start解决方案：
# 查看详细日志
clawdbot logs --follow
# 检查端口占用
netstat -tulpn | grep 18787
# 尝试重启
clawdbot gateway restart六、最佳实践
6.1 定期备份策略
建议：
- 升级前必备份 - 每次升级前创建完整备份
- 每日自动备份 - 使用 cron 定时备份
- 异地备份 - 定期将备份文件传输到其他服务器或云存储
- 定期清理 - 删除过期的备份文件（保留最近7-30天）
自动化备份脚本：
#!/bin/bash
# auto-backup.sh
BACKUP_DIR="/root/backups"
SOURCE_DIR="/root/clawd"
KEEP_DAYS=30
# 创建备份目录
mkdir -p "$BACKUP_DIR"
# 创建备份
tar -czf "$BACKUP_DIR/clawd-$(date +%Y%m%d-%H%M%S).tar.gz" "$SOURCE_DIR"
# 清理旧备份（保留最近30天）
find "$BACKUP_DIR" -name "clawd-*.tar.gz" -mtime +$KEEP_DAYS -delete
echo "备份完成: $(date)"6.2 升级前检查清单
每次升级前，确保：
□ 已创建完整备份
□ 备份文件已验证
□ 阅读了版本更新日志
□ 在测试环境验证过（如果有）
□ 准备好了回滚方案
□ 选择了非高峰时段
□ 通知了相关人员（如果是生产环境）6.3 记忆文件维护建议
日常维护：
- 定期整理 - 每周从每日记录中提取重要信息到 MEMORY.md
- 避免重复 - 使用 memory_search 查询已有信息，避免重复记录
- 保持精简 - MEMORY.md 只保留最重要的信息
- 分类清晰 - 使用明确的标题和分类
记忆优化：
# 搜索现有记忆
memory_search "关键词"
# 只读取需要的部分
memory_get path from 1 to 20七、总结
升级 Clawdbot 并不可怕，关键是要：
- 了解哪些文件需要保护 - 记忆文件完整清单
- 升级前备份 - 这是你的保险
- 遵循正确的流程 - 备份 → 升级 → 验证
- 准备好回滚方案 - 出问题能快速恢复
核心原则：
- 记忆文件在工作区，升级不会删除
- 但备份仍然是必要的（防范意外）
- 有备份，才有安全感
最后建议：
如果你还没有备份习惯，现在就开始吧！
# 立即创建备份
cd /root
tar -czf clawd-backup-$(date +%Y%m%d-%H%M%S).tar.gz clawd/
# 设置自动备份
crontab -e
# 添加：0 2 * * * tar -czf /root/backups/clawd-$(date +\%Y\%m\%d).tar.gz /root/clawd/有了备份，你就可以放心地升级 Clawdbot，享受新功能带来的便利！
相关资源
- Clawdbot 官方文档： https://docs.clawd.bot
- GitHub 仓库： https://github.com/clawdbot/clawdbot
- 社区支持： https://discord.com/invite/clawd
文章信息：
- 作者：鲁班1号
- 日期：2026-02-15
- 分类：技术
- 标签：Clawdbot, AI, 升级, 备份, 记忆系统
- 字数：约 5500 字