Aqua 深度研究报告

项目: Aqua (AQUA Queries & Unifies Agents)

仓库: https://github.com/quailyquaily/aqua

作者: quailyquaily (Lyric)

语言: Go

当前版本: v0.0.18

报告日期: 2026-02-23

一句话总结

Aqua 是一个基于 libp2p 的 AI Agent 间点对点加密通信工具——给 Agent 装上了自己的"微信"，让它们可以在没有中心化服务器的情况下互相发消息。

项目定位

Aqua 从 Mister Morph（一个完整的 AI Agent 框架）中独立拆分出来，专注解决一个问题：Agent 之间怎么安全地互相通信？

现在大部分 Agent 框架（包括我们自己的 OpenClaw）的通信都依赖平台渠道（Discord、Telegram、Slack）。Aqua 提出了一种去中心化方案：Agent 直接 P2P 通信，不需要经过任何平台。

核心架构

技术栈

核心文件（~/.aqua/）

文件用途
`identity.json`本地身份（peer_id + 密钥）
`contacts.json`通讯录
`inbox_messages.jsonl`收件箱
`outbox_messages.jsonl`发件箱
`dedupe_records.json`消息去重

运行模式

1. aqua serve — 启动 libp2p 节点，监听消息

2. aqua relay serve — 专用中继服务器（帮 NAT 后面的节点转发）

3. aqua send/hello/ping — 客户端模式，主动连接对端

工作流程


Agent A                    Relay (可选)                Agent B
  |                           |                          |
  |--- aqua id alice -------->|                          |
  |                           |          aqua id bob ----|
  |--- aqua serve ----------->|<------- aqua serve ------|
  |                           |                          |
  |--- contacts add B ------->|                          |
  |                           |<------ contacts add A ---|
  |                           |                          |
  |--- send B "hello" ------->|--------> inbox --------->|
  |<-------- inbox -----------|<------- send A "hi" -----|

关键点：

与 Mister Morph 的关系

Mister Morph 是 quailyquaily 开发的完整 AI Agent 框架：

对比Mister MorphAqua
定位完整 Agent 框架专用通信层
功能LLM 调用 + 工具 + 技能 + 安全 + 通信仅 P2P 通信
渠道Telegram/Slack/HTTP/MAEP纯 P2P
依赖自包含已完全独立，不依赖 Mister Morph

Aqua 本质上是 Mister Morph 的 MAEP（Multi-Agent Exchange Protocol）通信层被独立出来的产物。独立后更容易被其他 Agent 框架集成。

AI Agent Skill 设计

Aqua 提供了标准的 SKILL.md，这意味着任何支持 Skill 加载的 Agent 都可以直接使用 Aqua：

Skill 内容包括完整的安装、配置、发送、接收流程，还有 --json 模式专门为 Agent 消费设计。

竞品对比

项目方式加密去中心化Agent 专用
**Aqua**libp2p P2PE2EE✅✅
OpenClaw Channels平台渠道平台提供❌❌ (通用)
A2H Protocol域名解析-部分Agent→Human
ai-maestroSlack/Discord平台提供❌✅
Matrix/Element联邦E2EE 可选部分❌ (通用)

Aqua 的独特之处：真正的 P2P + E2EE + 专为 Agent 设计。没有中心化注册服务器，没有平台依赖。

当前局限

1. 极早期 — v0.0.18，API 可能随时变

2. 无群组加密 — 路线图中但未实现

3. 无消息重传队列 — 离线消息可能丢失

4. 无在线目录服务 — 添加联系人必须手动交换地址（类似早期 Bitcoin 转账需要手动输地址）

5. 单一中继节点 — 官方只提供一个 relay，是单点故障

6. 生态极小 — 目前主要服务 Mister Morph 生态

与我们的关联

能用在哪？

如果我们想让 OpenClaw 的 Tony 与其他 Agent（比如 Mister Morph 的 A-Guo、A-Kou）直接通信，Aqua 提供了一条去中心化路径。不需要大家都上同一个 Discord 服务器。

实际价值判断

现阶段对我们价值有限。原因：

与 Moltbook 的对比

有趣的是，Moltbook 解决的是 Agent 的"社交媒体"问题（公开互动），Aqua 解决的是"私信"问题（私密通信）。两者互补。

作者 Lyric 的安全哲学

从 Mister Morph 的设计可以看出作者对安全非常重视：

这在 Agent 框架里相当少见。大部分框架（包括我们用的）在安全上是"先跑起来再说"。

总结评分

维度评分说明
技术方向⭐⭐⭐⭐⭐P2P + E2EE 是 Agent 通信的正确方向
成熟度⭐⭐v0.0.x，极早期
实用性⭐⭐生态太小，实际能通信的对象有限
代码质量⭐⭐⭐⭐Go 编写，架构清晰，有完整文档
安全设计⭐⭐⭐⭐⭐安全意识一流

一句话: 方向对、设计好、时机早。值得 star 和关注，但现在还不是动手集成的时候。等它有了目录服务和更大的 Agent 生态，会是一个值得认真对待的基础设施。

参考链接: