# Agent Mailer Protocol：为AI智能体打造的异步邮件协作系统

> 介绍AMP协议如何为Claude Code、Cursor、OpenClaw等AI智能体提供持久化身份、收件箱和线程消息能力，实现真正的多智能体异步协作。

- 板块: [Openclaw Llm](https://www.zingnex.cn/forum/board/openclaw-llm)
- 发布时间: 2026-04-28T11:44:42.000Z
- 最近活动: 2026-04-28T11:50:13.156Z
- 热度: 157.9
- 关键词: AI Agent, Multi-Agent, Async Messaging, Claude Code, OpenClaw, FastAPI, Self-Hosted
- 页面链接: https://www.zingnex.cn/forum/thread/agent-mailer-protocol-ai
- Canonical: https://www.zingnex.cn/forum/thread/agent-mailer-protocol-ai
- Markdown 来源: ingested_event

---

# Agent Mailer Protocol：为AI智能体打造的异步邮件协作系统

## 背景：多智能体协作的通信困境

随着AI智能体（Agent）在软件开发、自动化工作流中的广泛应用，一个核心问题日益凸显：如何让多个独立运行的智能体高效协作？传统的解决方案往往要求开发者构建复杂的工具链、编写DAG工作流图，或是开发繁琐的RPC胶水代码。这些方法不仅增加了系统复杂度，还限制了智能体的灵活性和可扩展性。

Agent Mailer Protocol（AMP）应运而生，它借鉴了人类使用电子邮件协作的直观模式，为AI智能体提供了一套自托管的异步消息协议。通过AMP，每个智能体都拥有持久的身份标识、专属的收件箱、线程化的消息管理能力，以及一个可视化的操作控制台。

## 核心设计理念：邮件隐喻

AMP的核心创新在于将"邮件"这一人类熟悉的通信模式移植到AI智能体世界。与传统消息队列或RPC框架不同，AMP让智能体之间像发送邮件一样进行通信：发送、回复、转发、标记已读/未读、归档整理。这种设计有几个显著优势：

**异步解耦**：发送方无需等待接收方即时响应，消息被持久化存储，接收方按自己的节奏处理。

**线程化对话**：相关消息自动组织成线程，保持上下文连贯性，避免信息碎片化。

**持久身份**：每个智能体拥有类似"coder@alice.amp.linkyun.co"的地址，形成稳定的通信端点。

**操作可视化**：人类操作员可以通过浏览器控制台查看所有智能体的收件箱、消息线程、搜索历史记录。

## 系统架构与技术实现

AMP采用现代化的技术栈构建，确保高性能与易部署性：

### 后端架构

- **语言与框架**：Python 3.11+配合FastAPI，充分利用异步IO能力
- **数据库**：本地开发使用SQLite，生产环境支持PostgreSQL
- **认证机制**：bcrypt密码加密、JWT会话管理、API密钥认证
- **部署方式**：支持本地直接运行（uv包管理器）和Docker Compose一键部署

### 核心功能模块

**智能体注册与管理**：新智能体通过API密钥完成自注册，系统自动生成身份文件（AGENT.md或SOUL.md），包含智能体的地址、职责说明和系统提示词。

**消息传递系统**：完整的邮件原语支持——发送（send）、回复（reply）、转发（forward）、收件箱查询（inbox）、线程读取（thread）、已读标记（read/unread）。

**操作控制台**：基于Web的UI界面，支持消息搜索、标签管理、归档/回收站、团队统计、API密钥管理和多租户隔离。

**团队记忆**：允许将重要消息保存到共享知识库，供团队成员后续查阅，实现长期上下文共享。

## 多运行时兼容性

AMP的一个关键设计目标是兼容主流AI智能体运行时环境。项目提供了针对不同平台的适配文件：

| 运行时环境 | 适配文件 | 身份文件 |
|-----------|---------|---------|
| Claude Code | CLAUDE.md | AGENT.md |
| Cursor | .cursorrules | AGENT.md |
| OpenClaw | CLAW.md | AGENT.md |
| Dreamfactory | DREAMER.md | SOUL.md |
| Linkyun Infiniti Agent | INFINITI.md | SOUL.md |
| 自定义智能体 | 自定义加载器 | AGENT.md或SOUL.md |

这种设计确保无论开发者使用哪种智能体框架，都能无缝接入AMP生态系统。适配文件负责加载身份配置，告知智能体：它是谁、拥有哪个邮箱地址、如何调用Broker API、应该遵循什么系统提示词。

## 典型工作流示例

AMP特别适合需要多角色协作的复杂开发任务。以下是一个典型的软件开发生命周期示例：

```
规划智能体(Planner) --转发--> 编码智能体(Coder) --转发--> 审查智能体(Reviewer)
     ^                                                        |
     |                                                        |
     +----------------------回复------------------------------+
```

在这个流程中：

1. **Planner**接收高层需求，拆解为具体任务，通过AMP发送给Coder
2. **Coder**完成任务后，将代码和说明转发给Reviewer进行审查
3. **Reviewer**发现问题时直接回复Coder；确认无误后回复Planner确认完成
4. **人类操作员**全程可通过控制台监控进度，必要时人工介入

整个过程无需复杂的DAG编排，每个智能体只需关注自己的收件箱，按需响应消息即可。

## 部署与使用

AMP的部署非常简便，开发者可以选择本地快速启动或生产级部署：

**本地开发模式**（使用SQLite）：
```bash
# 配置环境变量
echo "AGENT_MAILER_SECRET_KEY=change-this-secret" > .env

# 同步依赖并启动
uv sync
./run.sh
```

启动后访问 http://127.0.0.1:9800/admin/ui 打开操作控制台，首次启动会显示引导注册码用于创建超级管理员账户。

**生产部署模式**（使用PostgreSQL）：
```bash
AGENT_MAILER_SECRET_KEY=change-this-secret docker compose up -d
```

Docker Compose会自动启动PostgreSQL 16、AMP应用服务，并配置持久化存储卷。

## 智能体自注册流程

AMP设计了一个优雅的智能体 onboarding 流程：

1. 人类操作员在控制台创建API密钥
2. 将API密钥提供给待注册的智能体
3. 智能体访问 `/setup.md` 获取自注册指引
4. 智能体调用注册API，下载身份文件和适配模板
5. 智能体将身份信息写入 AGENT.md 或 SOUL.md
6. 智能体开始定期检查收件箱，进入工作就绪状态

这个过程实现了"零配置"接入——智能体自己完成注册，无需人工手动配置每个实例。

## 安全与隔离机制

AMP内置了多层安全保护：

- **邀请码注册**：新用户需要有效的邀请码才能创建账户
- **会话认证**：浏览器访问使用JWT会话管理
- **API密钥**：智能体API调用使用独立的API密钥认证
- **多租户隔离**：不同租户的消息数据完全隔离
- **超级管理员控制**：集中管理用户、团队和系统配置

## 未来展望

Agent Mailer Protocol代表了AI智能体协作通信的一种新范式。它不是在已有消息队列或RPC框架上修修补补，而是重新思考智能体之间"应该如何对话"。邮件隐喻的引入降低了心智负担，异步设计适应了AI处理的时间不确定性，持久身份和线程管理确保了上下文连贯性。

对于正在构建多智能体系统的开发者来说，AMP提供了一个立即可用的基础设施层。无论是Claude Code的编码助手、Cursor的AI编辑器，还是OpenClaw的自动化代理，都能通过AMP实现无缝协作。项目采用MIT许可证开源，社区可以自由扩展和定制。

随着AI智能体生态的成熟，像AMP这样的通信基础设施将变得越来越重要。它不仅是技术实现，更是一种设计哲学：让智能体像人类一样自然地协作。