事件流
事件类型
| 事件 | 描述 |
|---|---|
agent_start |
智能体开始处理 |
agent_end |
运行的最终事件。为此事件等待的订阅者仍会计入结算 |
turn_start |
新轮次开始（一次 LLM 调用 + 工具执行） |
turn_end |
轮次完成，包含助手消息和工具结果 |
message_start |
任何消息开始（user、assistant、toolResult） |
message_update |
仅限助手。 包含带有增量的 assistantMessageEvent |
message_end |
消息完成 |
tool_execution_start |
工具开始执行 |
tool_execution_update |
工具流式传输进度 |
tool_execution_end |
工具执行完成 |
prompt() 事件序列
当你调用 prompt("Hello") 时：
基于 @earendil-works/pi-ai 构建的有状态智能体，支持工具执行和事件流。
安装
npm install @earendil-works/pi-agent-core
快速开始
本 SDK 提供对 Pi 智能体能力的程序化访问。可用于将 Pi 嵌入其他应用、构建自定义界面，或集成到自动化工作流中。
典型使用场景：
参见 examples/sdk/，获取从极简到全量控制的可运行示例。
快速上手 import { AuthStorage, createAgentSession, ModelRegistry, SessionManager } from "@earendil-works/pi-coding-agent"; // 设置凭证存储与模型注册器 const authStorage = AuthStorage.create(); const modelRegistry = ModelRegistry.create(authStorage); const { session } = await createAgentSession({ sessionManager: SessionManager.inMemory(), authStorage, modelRegistry, }); // 订阅事件流 session.subscribe((event) => { if (event.
通过两种方式，在 TypeScript 中使用 @earendil-works 的 Pi Agent 框架连接本地运行的 Ollama 模型（以 qwen3.5:9b 为例）。
环境初始化
首先，初始化项目并配置为 ES Modules (ESM) 模式，以支持顶层 await 语法。
npm init -y
在生成的 package.json 中，手动添加 "type": "module"：
Pi 是一个模块化的 AI 编码智能体 Monorepo，使用 TypeScript 构建。它提供统一的 LLM 抽象层、通用的智能体运行时、丰富的终端 UI 框架，以及完全可扩展的编码智能体命令行工具。
1. 项目概览
Pi（@earendil-works/pi-mono）是由 Mario Zechner 开发的 AI 编码智能体 Monorepo，设计理念是模块化、可扩展、供应商无关。它将多个 LLM 供应商的复杂性抽象为统一 API，提供强大的智能体运行时和工具执行能力，并附带生产就绪的终端 UI。
核心能力
| 能力 | 说明 |
|---|---|
| 统一 LLM API | 9 种 API 协议和 30+ 供应商品牌的单一接口。只需修改一个字符串即可切换供应商。 |
| 智能体运行时 | 完整的智能体循环，支持并行工具执行、消息注入队列和上下文压缩。 |
| 丰富的终端 UI | 独立的终端 UI 框架，支持差异化渲染、文本编辑器、图片显示和浮层系统。 |
| 扩展系统 | 80+ 扩展示例、20+ 生命周期钩子。可注册工具、命令、快捷键和供应商。 |
| Web 组件 | 基于 Lit 的聊天 UI，支持沙箱化 Artifact 渲染（HTML、SVG、PDF、DOCX 等）。 |
| 多运行模式 | 交互式终端、管道友好的打印模式，以及用于 IDE 集成的 JSONL RPC 模式。 |
包依赖关系图
graph TD
subgraph "第一层：基础层"
ai["<b>pi-ai</b><br/>统一 LLM API<br/>30+ 供应商"]
end
subgraph "第二层：运行时层"
agent["<b>pi-agent-core</b><br/>智能体运行时<br/>工具执行"]
end
subgraph "第三层：UI 层"
tui["<b>pi-tui</b><br/>终端 UI 框架<br/>零依赖"]
end
subgraph "第四层：应用层"
coding["<b>pi-coding-agent</b><br/>编码智能体 CLI<br/>扩展与工具"]
webui["<b>pi-web-ui</b><br/>Web UI 组件<br/>Lit + Tailwind"]
end
ai --> agent
agent --> coding
tui --> coding
ai --> webui
tui --> webui
style ai fill:#1f6feb,stroke:#388bfd,color:#fff
style agent fill:#238636,stroke:#3fb950,color:#fff
style tui fill:#8957e5,stroke:#bc8cff,color:#fff
style coding fill:#da3633,stroke:#f85149,color:#fff
style webui fill:#e3b341,stroke:#d29922,color:#fff
图 1: Pi monorepo 包依赖关系图 — 4 层架构，5 个包
当用户在whatsapp, discord 等消息软件中发送了消息后，网关是如何获得的，再到回复，整个流程是如何运转的？
OpenClaw 消息处理完整流程
1. 消息接入 → 2. 路由决策 → 3. AI 处理 → 4. 回复发送
核心文件位置
| 模块 | 文件位置 | 功能 |
|---|---|---|
| 渠道实现 | extensions/*/src/channel.ts |
WhatsApp/Discord/Telegram 等渠道插件 |
| 渠道监听 | extensions/discord/src/monitor/listeners.ts |
监听渠道消息事件 |
| 消息分发 | src/auto-reply/dispatch.ts |
协调预处理、路由、回复 |
| 路由解析 | src/routing/resolve-route.ts |
根据 bindings 配置决定由哪个 agent 处理 |
| 网关服务 | src/gateway/server.impl.ts |
网关服务器主实现 |
| Agent 执行 | src/agents/pi-embedded-runner/ |
运行 AI agent |
| 消息发送 | src/infra/outbound/deliver.ts |
统一发送逻辑 |
详细流程示例（以 Discord 为例）
目录
概览
OpenClaw 是一个多渠道 AI 助手网关，设计用于在用户自己的设备上运行。它采用单一网关 + 多客户端/节点模型，支持 WhatsApp、Telegram、Slack、Discord、Google Chat、Signal、iMessage 等多种通信渠道。
核心结构
| 组件 | 描述 |
|---|---|
| 🌐 Gateway（网关） | 长期运行的守护进程，管理所有消息平台连接和智能体通信 |
| 💻 Clients（客户端） | 控制平面应用（macOS 应用、CLI、Web 界面） |
| 📱 Nodes（节点） | 设备节点，提供硬件能力（macOS/iOS/Android/无头设备） |
整体架构
graph TB
subgraph UserLayer["用户设备层"]
MacApp["macOS 应用"]
IOSApp["iOS 应用"]
AndroidApp["Android 应用"]
CLI["命令行界面"]
WebUI["Web 界面"]
end
subgraph GatewayLayer["网关核心层"]
Gateway["Gateway 网关服务"]
WS["WebSocket 服务器"]
HTTP["HTTP 服务器"]
NodeReg["节点注册表"]
ChannelMgr["渠道管理器"]
end
subgraph ChannelLayer["消息渠道层"]
Telegram["Telegram"]
Slack["Slack"]
Discord["Discord"]
WhatsApp["WhatsApp"]
Signal["Signal"]
GoogleChat["Google Chat"]
OtherChannels["其他渠道..."]
end
subgraph AgentLayer["智能体层"]
AgentSystem["智能体系统"]
Skills["技能系统"]
Memory["记忆系统"]
Providers["AI 提供商"]
end
MacApp --> WS
IOSApp --> WS
AndroidApp --> WS
CLI --> WS
WebUI --> HTTP
WS --> Gateway
HTTP --> Gateway
Gateway --> NodeReg
Gateway --> ChannelMgr
ChannelMgr --> Telegram
ChannelMgr --> Slack
ChannelMgr --> Discord
ChannelMgr --> WhatsApp
ChannelMgr --> Signal
ChannelMgr --> GoogleChat
ChannelMgr --> OtherChannels
Gateway --> AgentSystem
AgentSystem --> Skills
AgentSystem --> Memory
AgentSystem --> Providers
style Gateway fill:#7c3aed,stroke:#5b21b6,color:#fff
style WS fill:#8b5cf6,stroke:#7c3aed,color:#fff
style ChannelMgr fill:#8b5cf6,stroke:#7c3aed,color:#fff
style AgentSystem fill:#10b981,stroke:#059669,color:#fff
架构原则
核心组件
🎛️ Gateway Server（网关服务器）
网关的核心实现，负责协调所有子系统。
位置: src/gateway/server.impl.ts