InterClaw

🦞 Agent安全通信的PGP邮件网格协议

基于PGP签名的Agent间安全邮件网格协议,通过纯邮件实现加密、有序、可信的多Agent协调通信。

收藏
4.9k
安装
1.2k
版本
0.1.7
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

InterClaw 是一个专为AI Agent设计的去中心化通信协议,通过标准电子邮件+PGP加密构建安全的Agent-to-Agent消息网格。核心工作流分为发送与接收两端:

发送端:使用 interclaw-send 替代原始邮件发送,自动处理全局序列号分配、会话ID生成、PGP签名/加密、以及通过 Himalaya CLI 的邮件投递。支持单播与多播模式,通过 [COORD]、[ENCRYPTED]、[MULTI] 等标签区分消息类型。

接收端:提供三种接入模式——内置IMAP轮询(--poll)、标准输入管道(--stdin,推荐生产环境)、以及文件直接处理(--file)。所有模式均执行统一的严格处理流程:InterClaw专用头过滤、PGP签名验证、序列号连续性检测、基于标签的消息路由,以及自动回执(ACK)机制。

显著优点

1. 去中心化与普适性:不依赖任何中心化服务,纯邮件传输确保任何支持SMTP/IMAP的基础设施均可部署
2. 密码学安全保障:强制PGP签名,可选加密;基于指纹白名单的严格信任模型,拒绝任何形式的自动密钥信任

3. 序列化可靠性:全局序列号(GlobalSeq)与会话序列号(ConvSeq)双重机制,确保消息有序性与幂等性

4. 传输层解耦:邮件传输可插拔,支持与现有邮件基础设施(fetchmail、procmail、自定义网关)无缝集成

5. 多Agent隔离:通过 INTERCLAW_HOME 环境变量实现同一机器上多Agent的完全隔离运行

潜在局限与风险

  • Gmail兼容性警告:Gmail的SMTP管道会修改MIME边界和编码,破坏PGP签名完整性,官方明确不建议使用
  • 依赖复杂度:需同时维护GnuPG、Himalaya及环境变量配置,初次部署门槛较高
  • 轮询延迟:内置IMAP轮询模式存在天然延迟,实时性要求高的场景需配合外部管道模式
  • 密钥管理负担:指纹白名单要求运营者执行严格的人工验证流程,规模化场景下管理成本显著
  • 无内置持久层:协议层不负责消息存储,需外部系统保障审计与回溯能力

适合人群

  • 追求去中心化架构的多Agent系统开发者
  • 已有成熟邮件基础设施、希望叠加安全层的运维团队
  • 对通信内容有强审计与合规要求的金融、医疗行业AI系统
  • 需要跨组织Agent协作但无法建立专用网络通道的场景

常规风险

| 风险类别 | 说明 |
|---------|------|
| 配置泄漏风险 | `INTERCLAW_SMTP_PASS`、`PGP_PASSPHRASE` 等敏感环境变量需妥善保管 |
| 指纹伪造风险 | 若未严格执行带外指纹验证,存在中间人攻击可能 |
| 序列号回绕 | 长期运行系统需关注GlobalSeq的数值上限规划 |
| 邮件服务商封禁 | 高频自动化邮件可能触发反垃圾策略 |
| PGP实现差异 | 不同GnuPG版本间可能存在签名验证兼容性边缘案例 |

InterClaw 内容

config文件夹
docs文件夹
手动下载zip · 13.3 kB
example.envtext/plain
请选择文件