Pi Agent Core 开发指南
基于 @earendil-works/pi-ai 构建的有状态智能体，支持工具执行和事件流。
安装
npm install @earendil-works/pi-agent-core
快速开始
4 篇文章带有标签 “agent-loop”
Cline 项目架构设计文档
1. 项目概述
Cline 是一个 AI 驱动的编程助手 VS Code 扩展，基于 Claude Sonnet 的代理编程能力。它能够处理复杂的软件开发任务，包括：
- 文件创建和编辑
- 项目探索和代码分析
- 命令执行
- 浏览器自动化
- MCP (Model Context Protocol) 工具扩展
2. 整体架构图
OpenClaw - 智能体
网关架构 (Gateway Architecture)
概述
- 一个长期的网关 (Gateway) 进程拥有所有消息传输表面（WhatsApp 通过 Baileys，Telegram 通过 grammY，Slack，Discord，Signal，iMessage，WebChat）。
- 控制平面客户端（macOS 应用、CLI、Web UI、自动化脚本）通过 WebSocket 连接到网关，绑定在配置的主机上（默认
127.0.0.1:18789）。 - 节点 (Nodes)（macOS/iOS/Android/无头设备）也通过 WebSocket 连接，但需声明
role: node并包含明确的能力/命令。 - 每台主机对应一个网关；它是唯一开启 WhatsApp 会话的地方。
- 画布主机 (Canvas host)（默认
18793）用于提供代理可编辑的 HTML 和 A2UI。
组件与流程
网关 (Gateway) (守护进程)
- 维护提供商连接。
- 公开类型化的 WS API（请求、响应、服务器推送事件）。
- 根据 JSON Schema 验证入站数据帧。
- 触发事件，如
agent、chat、presence、health、heartbeat、cron。
客户端 (Client) (Mac 应用 / CLI / Web 管理)
- 每个客户端一条 WS 连接。
- 发送请求 (
health、status、send、agent、system-presence)。 - 订阅事件 (
tick、agent、presence、shutdown)。
使用 Claude Agent SDK 构建智能体
Claude Agent SDK 是 Anthropic 发布的、用于在 Claude Code 基础上构建强大智能体（agents）的工具集合。该 SDK 最初是作为 Claude Code SDK（一个智能编码解决方案）发布的，旨在支持 Anthropic 内部的开发者效率。由于 Claude Code 已经超越了编码工具的范畴，被用于深度研究、视频制作和笔记记录等无数非编码应用，因此该工具被更名为 Claude Agent SDK，以反映其更广泛的愿景。
一、核心设计原则：赋予 Claude 计算机能力
Claude Agent SDK 的关键设计原则是让 Claude 拥有程序员日常使用的相同工具。这意味着 Claude 必须能够：在代码库中查找文件、编写和编辑文件、运行代码、调试、以及迭代执行这些操作直到成功。
通过允许 Claude 访问用户计算机（经由终端），并赋予其运行 bash 命令、编辑文件、创建文件和搜索文件的能力，它能够有效执行非编码任务，如：阅读 CSV 文件、搜索网络、构建可视化、解释指标等数字工作，从而创建出具有通用目的的智能体。
二、构建的新型智能体
赋予 Claude 计算机能力解锁了许多以前效率不高的智能体类型。SDK 提供了用于自动化任何工作流程的原语，开发者可以构建：