事件流
事件类型
| 事件 | 描述 |
|---|---|
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 模式。 |
包依赖关系图
当用户在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/无头设备） |
整体架构