技能名称: email-backup
详细描述:

邮件备份技能

QQ邮箱文件备份技能，可将指定目录打包成压缩包，并通过QQ邮箱SMTP发送到指定邮箱。

🚀 OpenClaw 安装此技能指南

方法一：通过 ClawHub 安装（推荐）

如果你的 OpenClaw 已配置 ClawHub，可直接安装：

bash

搜索技能

clawhub search email-backup

安装技能

clawhub install email-backup

方法二：直接发送命令给 OpenClaw

在 OpenClaw 聊天界面中发送以下命令：

安装 email-backup 技能

或者：

请帮我安装邮件备份技能，用于打包文件并发送到QQ邮箱

OpenClaw 会自动执行以下操作：

1. 1. 检查 Python 是否安装
2. 创建 skills 目录
3. 下载并解压技能文件
4. 设置执行权限
5. 测试安装是否成功

方法三：使用 OpenClaw 命令行

在终端中执行：

bash

安装邮件备份技能

openclaw skill install email-backup

或者从本地安装

openclaw skill install ./email-backup-skill.tar.gz

方法四：手动安装

1. 1. 下载技能文件

bash # 创建 skills 目录（如果不存在） mkdir -p ~/.openclaw/workspace/skills

# 下载并解压
cd ~/.openclaw/workspace/skills
tar -xzf email-backup-skill.tar.gz

1. 2. 验证安装

bash # 检查文件结构 ls -la ~/.openclaw/workspace/skills/email-backup/

# 应该看到：
# SKILL.md
# README.md
# scripts/

1. 3. 测试运行

bash # 测试脚本是否正常工作 cd ~/.openclaw/workspace/skills/email-backup python3 scripts/backupandsend.py --help

📦 依赖说明

必需依赖

• - Python 3.6+：脚本运行环境
• tarfile 模块：Python 内置模块，用于创建 tar.gz 压缩包（无需额外安装）
• smtplib 模块：Python 内置模块，用于 SMTP 邮件发送（无需额外安装）

可选依赖

• - QQ邮箱 SMTP 授权码：用于发送邮件（需在 QQ 邮箱设置中获取）

为什么不需要额外安装压缩工具？

本技能使用 Python 内置的 tarfile 模块来创建 tar.gz 压缩包，无需安装额外的压缩工具（如 tar、gzip 等）。tarfile 模块是 Python 标准库的一部分，所有 Python 安装均自带此模块。

优势：

• - ✅ 无需安装额外软件
• ✅ 跨平台兼容（Windows、Linux、macOS）
• ✅ 纯 Python 实现，无外部依赖
• ✅ 支持压缩级别调节（1-9）

功能特性

• - ✅ 支持打包任意目录为 tar.gz 压缩包
• ✅ 支持QQ邮箱SMTP发送（SSL加密）
• ✅ 支持敏感信息清理（API Key、密码等）
• ✅ 支持自定义邮件主题和正文
• ✅ 支持批量发送多个文件

安装要求

1. 1. Python 3.6+
2. QQ邮箱SMTP授权码（需在QQ邮箱设置中开启SMTP服务并获取授权码）

配置

1. 获取QQ邮箱SMTP授权码

1. 1. 登录QQ邮箱 (mail.qq.com)
2. 进入「设置」→「账户」
3. 找到「POP3/IMAP/SMTP/Exchange/CardDAV/CalDAV服务」
4. 开启「IMAP/SMTP服务」
5. 生成授权码（16位字母数字组合）

2. 配置环境变量

bash

设置QQ邮箱配置

export QQ_EMAIL=your-email@qq.com
export QQSMTPPASSWORD=your-auth-code

或者直接在脚本中修改配置

使用方法

基本用法

bash

打包目录并发送到邮箱

python3 scripts/backupandsend.py /path/to/directory

指定收件人

python3 scripts/backupandsend.py /path/to/directory --to recipient@qq.com

自定义邮件主题

python3 scripts/backupandsend.py /path/to/directory --subject 我的备份文件

清理敏感信息后发送

python3 scripts/backupandsend.py /path/to/directory --clean

高级用法

bash

打包多个目录

python3 scripts/backupandsend.py /path/to/dir1 /path/to/dir2

排除特定文件

python3 scripts/backupandsend.py /path/to/directory --exclude .log .tmp

设置压缩级别（1-9，9为最高压缩率）

python3 scripts/backupandsend.py /path/to/directory --compression 9

脚本说明

1. backupandsend.py

主脚本，整合打包和发送功能。

参数：

• - directories: 要打包的目录（支持多个）
• --to: 收件人邮箱（默认：发件人邮箱）
• --subject: 邮件主题
• --body: 邮件正文
• --clean: 清理敏感信息
• --exclude: 排除的文件模式
• --compression: 压缩级别（1-9）

2. clean_sensitive.py

敏感信息清理脚本，用于清理API Key、密码等敏感信息。

支持清理的敏感信息：

• - API Keys（sk-, tvly-等）
• 密码（PASSWORD=, password=等）
• 邮箱密码
• 用户ID
• 其他自定义敏感信息

3. send_email.py

邮件发送脚本，支持QQ邮箱SMTP发送。

参数：

• - --to: 收件人邮箱
• --subject: 邮件主题
• --body: 邮件正文
• --attachment: 附件路径

安全注意事项

1. 1. 不要将授权码提交到代码仓库
2. 使用环境变量存储敏感信息
3. 定期更换授权码
4. 清理备份文件中的敏感信息

示例

备份OpenClaw配置

bash

备份OpenClaw配置并发送到邮箱

python3 scripts/backupandsend.py ~/.openclaw/agents ~/.openclaw/workspace --clean

定期备份脚本

bash
#!/bin/bash

daily_backup.sh

设置环境变量

export QQ_EMAIL=your-email@qq.com export QQSMTPPASSWORD=your-auth-code

备份目录

BACKUP_DIRS=( ~/.openclaw/agents ~/.openclaw/workspace ~/important-docs )

执行备份

python3 ~/.openclaw/workspace/skills/email-backup/scripts/backupandsend.py \ ${BACKUP_DIRS[@]} \ --subject 每日备份 $(date +%Y-%m-%d) \ --clean

故障排除

1. SMTP连接失败

• - 检查网络连接
• 确认SMTP服务器地址和端口
• 检查防火墙设置

2. 认证失败

• - 确认授权码是否正确
• 检查邮箱是否开启了SMTP服务
• 尝试重新生成授权码

3. 附件过大

• - QQ邮箱附件限制为50MB
• 考虑分卷压缩或使用云存储

更新日志

v1.0.0 (2026-03-06)

• - 初始版本
• 支持QQ邮箱SMTP发送
• 支持敏感信息清理
• 支持批量打包和发送

许可证

MIT 许可证

作者

作者 🌸