puppetcat-fire 小龙虾安全点对点加密通讯技能
技能描述
这是一个完整的端到端加密通信系统，专为小龙虾代理间的安全通信设计。提供消息加密、文件安全传输、身份验证和联系人管理功能。
核心特性
🔐 端到端加密
- RSA-2048 非对称加密用于密钥交换
- AES-256-GCM 对称加密用于消息内容
- 完美前向保密（每次会话生成新密钥）
- 消息完整性验证（GCM认证标签）
🦞 小龙虾身份系统
- 每个小龙虾代理有唯一加密身份
- 基于公钥密码学的身份验证
- 指纹验证防止中间人攻击
- 本地密钥存储，私钥永不离开设备
📨 安全消息传递
- 文本消息的端到端加密
- 支持大文件的安全传输
- 消息元数据保护（发件人、时间戳）
- 本地加密存储通信记录
👥 联系人管理
- 基于公钥的联系人系统
- 联系人指纹验证
- 支持离线添加联系人
- 联系人信任等级管理
安全设计原则
1. 零信任架构
- 不信任任何中间节点
- 所有通信端到端加密
- 用户完全控制密钥
2. 最小权限原则
- 只请求必要的权限
- 本地数据处理
- 无网络监听
3. 透明操作
- 所有加密操作可审计
- 开源算法实现
- 无隐藏后门
4. 防御深度
- 多层加密保护
- 密钥分离存储
- 定期密钥轮换建议
使用场景
场景1：私人约饭邀请
柏然 → [加密] → 朋友
"周六海底捞，晚上7点"
场景2：小龙虾代理间协调
小龙虾A → [加密] → 小龙虾B
"需要协助处理用户请求"
场景3：敏感文件传输
用户 → [加密文件] → 律师
"合同草案，请保密"
场景4：安全群组通信
创建加密群组 → 添加成员 → 群组加密通信
技术架构
加密协议栈
应用层：消息/文件
↓
会话层：AES-256-GCM加密
↓
传输层：RSA加密的会话密钥
↓
网络层：任意传输渠道（微信、邮件、小龙虾等）
密钥管理
主密钥对（RSA-2048）
├── 身份标识
├── 消息加密密钥派生
└── 文件加密密钥派生
会话密钥（AES-256）
├── 每次通信生成新密钥
├── 使用对方公钥加密传输
└── 使用后立即销毁
数据流
发送方：
明文 → AES加密 → RSA加密密钥 → 传输包
接收方：
传输包 → RSA解密密钥 → AES解密 → 明文
文件结构
secure-p2p-messenger/
├── SKILL.md (本文件)
├── secure-messenger.sh (主脚本)
├── key-manager.sh (密钥管理)
├── encryptor.sh (加密/解密工具)
├── contact-manager.sh (联系人管理)
├── file-transfer.sh (文件传输)
├── install.sh (安装脚本)
├── config/
│ ├── default-config.json
│ └── keyring/ (密钥存储目录)
├── lib/
│ ├── crypto-utils.sh (加密工具函数)
│ ├── protocol.sh (通信协议)
│ └── utils.sh (通用工具)
└── examples/
├── basic-chat.sh (基础聊天示例)
├── secure-file-transfer.sh (文件传输示例)
└── group-chat.sh (群组聊天示例)
安装与配置
1. 安装依赖
# 确保系统有必要的工具
sudo apt-get install openssl jq coreutils # Debian/Ubuntu
# 或
brew install openssl jq coreutils # macOS
2. 安装技能
./install.sh
3. 初始化身份
./secure-messenger.sh init
4. 添加第一个联系人
# 获取朋友的公钥（让他们运行 ./secure-messenger.sh identity）
./secure-messenger.sh add-contact friend_id "朋友名字" "公钥base64"
基本使用
初始化加密身份
./secure-messenger.sh init
这将生成：
- RSA-2048密钥对
- 唯一身份ID
- 身份指纹（用于验证）
显示身份信息
./secure-messenger.sh identity
分享你的身份ID和公钥给朋友。
添加联系人
./secure-messenger.sh add-contact alice "Alice" "MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEA..."
发送加密消息
./secure-messenger.sh send alice "你好，这是加密消息！"
输出加密的消息包，可以通过任何渠道发送。
接收和解密消息
./secure-messenger.sh receive '{"encryptedKey":"...","encryptedMsg":"..."}'
安全文件传输
# 发送文件
./secure-messenger.sh send-file alice document.pdf
# 接收文件
./secure-messenger.sh receive-file transfer_info.json encrypted_file.enc
高级功能
1. 消息自毁
# 发送自毁消息（阅读后自动删除）
./secure-messenger.sh send-burn alice "机密信息" --ttl 300
2. 群组加密通信
# 创建加密群组
./secure-messenger.sh create-group "项目组" alice bob charlie
# 发送群组消息
./secure-messenger.sh send-group "项目组" "会议纪要"
3. 数字签名
# 签名消息
./secure-messenger.sh sign-message "重要公告"
# 验证签名
./secure-messenger.sh verify-signature signed_message.json
4. 密钥轮换
# 生成新密钥对
./secure-messenger.sh rotate-keys
# 通知联系人更新公钥
./secure-messenger.sh notify-key-rotation
安全最佳实践
密钥管理
- 备份私钥：安全存储私钥备份
- 密码保护：使用强密码加密私钥文件
- 定期轮换：建议每6-12个月轮换密钥
- 离线存储：长期不用的密钥离线存储
通信安全
- 验证指纹：首次通信时验证对方指纹
- 安全渠道：通过可信渠道交换公钥
- 警惕中间人：注意异常通信行为
- 及时更新：保持软件和密钥更新
数据保护
- 本地加密：所有本地数据加密存储
- 及时清理：删除不再需要的消息
- 安全删除：使用安全删除工具
- 访问控制：限制对配置目录的访问
技术细节
加密算法
- 非对称加密：RSA-2048 with OAEP padding
- 对称加密：AES-256-GCM
- 哈希算法：SHA-256
- 随机数生成：/dev/urandom
消息格式
{
"version": "1.0",
"id": "msg_1647081234_abc123",
"sender": "claw_abc123...",
"recipient": "claw_def456...",
"timestamp": "2026-03-12T11:40:00Z",
"encryptedKey": "base64(RSA加密的会话密钥)",
"iv": "base64(初始化向量)",
"encryptedMsg": "base64(AES加密的消息)",
"authTag": "base64(GCM认证标签)"
}
文件传输格式
{
"version": "1.0",
"id": "transfer_1647081234_xyz789",
"sender": "claw_abc123...",
"recipient": "claw_def456...",
"filename": "document.pdf",
"filesize": 1048576,
"filehash": "sha256哈希",
"encryptedKey": "base64(RSA加密的文件密钥)",
"iv": "base64(初始化向量)",
"timestamp": "2026-03-12T11:40:00Z"
}
性能考虑
加密性能
- 消息加密：< 100ms (1KB消息)
- 文件加密：~10MB/s (AES-NI加速)
- 密钥生成：~2s (RSA-2048)
存储需求
- 密钥对：~1.7KB (RSA-2048)
- 消息存储：消息大小 + ~500字节开销
- 联系人：~200字节/联系人
网络开销
- 加密开销：~33% (Base64编码)
- 协议开销：~500字节/消息
- 批处理：支持消息批处理减少开销
限制与注意事项
技术限制
- 文件大小：建议单个文件 < 100MB
- 消息长度：建议单条消息 < 10KB
- 联系人数量：无硬性限制，但建议 < 1000
- 平台兼容性：需要bash和openssl
安全注意事项
- 私钥安全：私钥泄露等于身份被盗
- 中间人攻击：首次交换公钥时需要安全渠道
- 侧信道攻击：注意时间和内存使用模式
- 量子计算：RSA可能被量子计算机破解
法律合规
- 出口管制：某些加密技术受出口管制
- 数据保护：遵守当地数据保护法规
- 执法访问：某些地区要求提供后门
- 使用条款：确保使用符合服务条款
故障排除
常见问题
- openssl命令找不到：安装openssl包
- 权限被拒绝：检查文件权限和SELinux
- 解密失败：检查密钥匹配和消息完整性
- 性能缓慢：检查系统资源和openssl版本
调试模式
# 启用详细输出
export SECURE_P2P_DEBUG=1
./secure-messenger.sh send alice "测试消息"
日志文件
- 主日志：
~/.openclaw/secure-p2p/secure-p2p.log - 错误日志：
~/.openclaw/secure-p2p/error.log - 审计日志：
~/.openclaw/secure-p2p/audit.log
未来扩展
计划功能
- 量子安全加密：添加后量子密码学支持
- 移动端应用：iOS/Android客户端
- 浏览器扩展：Web端加密通信
- 区块链集成：去中心化身份验证
社区贡献
欢迎贡献代码、文档和测试用例：
- Fork项目
- 创建功能分支
- 提交Pull Request
- 通过代码审查
路线图
- v1.0：基础加密通信 ✓
- v1.1：群组通信和文件传输
- v1.2：移动端支持和UI改进
- v2.0：量子安全加密和区块链集成
支持与反馈
获取帮助
- 文档：阅读本SKILL.md文件
- 示例：查看examples/目录
- 问题：创建GitHub Issue
- 讨论：加入OpenClaw社区
报告安全问题
发现安全漏洞时：
- 不要公开披露
- 通过安全渠道报告
- 提供详细复现步骤
- 等待修复和发布
贡献者
- 柏然：创始人和主要开发者
- 小龙虾：AI助手和测试者
- OpenClaw社区：反馈和改进建议
许可证
本项目采用MIT许可证。详见LICENSE文件。
🦞 安全通信，自由连接。保护你的数字隐私，从每一次加密开始。
最后更新：2026年3月12日 版本：secure-p2p-messenger v1.0.0