- ClawdBot Docs: docs.clawdbot.com
- Skills Guide: docs.clawdbot.com/skills
- MCP Setup: docs.clawdbot.com/mcp

ClawdBot 备份技能

直接从 ClawdBot 备份、恢复和同步您的 ClawdBot 配置到不同设备。

概述

此技能帮助您：

• - 备份所有 ClawdBot 数据和设置
• 从备份中恢复
• 在多个机器之间同步
• 对配置进行版本控制
• 自动化备份流程
• 迁移到新设备

ClawdBot 目录结构

关键位置

~/.claude/ # ClawdBot 主目录
├── settings.json # 全局设置
├── settings.local.json # 本地覆盖（特定机器）
├── projects.json # 项目配置
├── skills/ # 您的自定义技能
│ ├── skill-name/
│ │ ├── SKILL.md
│ │ └── supporting-files/
│ └── another-skill/
├── commands/ # 自定义斜杠命令（旧版）
│ └── command-name.md
├── contexts/ # 保存的上下文
├── templates/ # 响应模板
└── mcp/ # MCP 服务器配置
└── servers.json

~/projects/ # 您的项目（可选备份）
├── project-1/
│ └── .claude/ # 项目特定配置
│ ├── settings.json
│ └── skills/
└── project-2/

需要备份的内容

必需（始终备份）：
✓ ~/.claude/skills/ # 自定义技能
✓ ~/.claude/commands/ # 自定义命令
✓ ~/.claude/settings.json # 全局设置
✓ ~/.claude/mcp/ # MCP 配置

推荐（通常备份）：
✓ ~/.claude/contexts/ # 保存的上下文
✓ ~/.claude/templates/ # 模板
✓ 项目 .claude/ 文件夹 # 项目配置

可选（视情况而定）：
○ ~/.claude/settings.local.json # 特定机器
○ 缓存目录 # 可重新构建
○ 日志文件 # 通常不需要

快速备份命令

完整备份

bash

创建带时间戳的备份

BACKUP_DIR=$HOME/clawdbot-backups
TIMESTAMP=$(date +%Y%m%d_%H%M%S)
BACKUPNAME=clawdbotbackup_$TIMESTAMP

mkdir -p $BACKUP_DIR

tar -czvf $BACKUPDIR/$BACKUPNAME.tar.gz \
-C $HOME \
.claude/skills \
.claude/commands \
.claude/settings.json \
.claude/mcp \
.claude/contexts \
.claude/templates \
2>/dev/null

echo 备份已创建：$BACKUPDIR/$BACKUPNAME.tar.gz

仅技能快速备份

bash

仅备份技能

tar -czvf ~/clawdbotskills$(date +%Y%m%d).tar.gz \
-C $HOME .claude/skills .claude/commands

从备份恢复

bash

恢复完整备份

BACKUPFILE=$HOME/clawdbot-backups/clawdbotbackup_20260129.tar.gz

先预览内容

tar -tzvf $BACKUP_FILE

恢复（将覆盖现有文件）

tar -xzvf $BACKUP_FILE -C $HOME

echo 恢复完成！

备份脚本

全功能备份脚本

bash
#!/bin/bash

clawdbot-backup.sh - 全面的 ClawdBot 备份工具

set -e

配置

BACKUPROOT=${CLAWDBOTBACKUP_DIR:-$HOME/clawdbot-backups} CLAUDE_DIR=$HOME/.claude MAX_BACKUPS=10 # 保留最近 N 个备份 TIMESTAMP=$(date +%Y%m%d_%H%M%S)

颜色

RED=\033[0;31m GREEN=\033[0;32m YELLOW=\033[1;33m NC=\033[0m

log_info() { echo -e ${GREEN}[信息]${NC} $1; }
log_warn() { echo -e ${YELLOW}[警告]${NC} $1; }
log_error() { echo -e ${RED}[错误]${NC} $1; }

检查 ClawdBot 目录是否存在

checkclaudedir() { if [ ! -d $CLAUDE_DIR ]; then logerror 未找到 ClawdBot 目录：$CLAUDEDIR exit 1 fi }

创建备份

create_backup() { local backup_type=${1:-full} local backupname=clawdbot${backuptype}${TIMESTAMP} local backuppath=$BACKUPROOT/$backup_name.tar.gz

mkdir -p $BACKUP_ROOT

loginfo 正在创建 $backuptype 备份...

case $backup_type in
full)
tar -czvf $backup_path \
-C $HOME \
.claude/skills \
.claude/commands \
.claude/settings.json \
.claude/settings.local.json \
.claude/projects.json \
.claude/mcp \
.claude/contexts \
.claude/templates \
2>/dev/null || true
;;
skills)
tar -czvf $backup_path \
-C $HOME \
.claude/skills \
.claude/commands \
2>/dev/null || true
;;
settings)
tar -czvf $backup_path \
-C $HOME \
.claude/settings.json \
.claude/settings.local.json \
.claude/mcp \
2>/dev/null || true
;;
*)
logerror 未知备份类型：$backuptype
exit 1
;;
esac

if [ -f $backup_path ]; then
local size=$(du -h $backup_path | cut -f1)
loginfo 备份已创建：$backuppath ($size)
else
log_error 备份失败！
exit 1
fi
}

列出备份

list_backups() { loginfo $BACKUPROOT 中的可用备份： echo

if [ -d $BACKUP_ROOT ]; then
ls -lh $BACKUP_ROOT/*.tar.gz 2>/dev/null | \
awk {print $9, $5, $6, $7, $8} || \
echo 未找到备份。
else
echo 备份目录不存在。
fi
}

恢复备份

restore_backup() { local backup_file=$1

if [ -z $backup_file ]; then
log_error 请指定备份文件
list_backups
exit 1
fi

if [ ! -f $backup_file ]; then
# 尝试备份目录中的相对路径
backupfile=$BACKUPROOT/$backup_file
fi

if [ ! -f $backup_file ]; then
logerror 未找到备份文件：$backupfile
exit 1
fi

log_warn 这将覆盖现有配置！
read -p 是否继续？(y/N) confirm

if [ $confirm != y ] && [ $confirm != Y ]; then
log_info 恢复已取消。
exit 0
fi

loginfo 正在从以下位置恢复：$backupfile
tar -xzvf $backup_file -C $HOME
log_info 恢复完成！
}

清理旧备份

cleanup_backups() { loginfo 正在清理旧备份（保留最近 $MAXBACKUPS 个）...

cd $BACKUP_ROOT 2>/dev/null || return

local count=$(ls -1 *.tar.gz 2>/dev/null | wc -l)

if [ $count -gt $MAX_BACKUPS ]; then
local todelete=$((count - MAXBACKUPS))
ls -1t *.tar.gz | tail -n $to_delete | xargs rm -v
loginfo 已删除 $todelete 个旧备份
else
log_info 无需清理（共 $count 个备份）
fi
}

显示备份统计信息

show_stats() { log_info ClawdBot 备份统计 echo

echo === 目录大小 ===
du -sh $CLAUDE_DIR/skills 2>/dev