`pi-ai`
像最底层的脑力工厂。
Pi 导读
OpenClaw 如何把 pi 智能体嵌入消息网关
这一页讲的是 OpenClaw 通过直接调用 pi 的 createAgentSession() 将 AI 编码智能体嵌入到消息网关中，而不是作为子进程或 RPC 运行。重点看 runEmbeddedPiAgent() 的入参，尤其是 sessionKey、onBlockReply 和 provider/model 的配置方式。最容易出错的是：session 文件路径和 workspace 目录必须正确，否则会话无法持久化；provider 和 model 名称必须与 pi 的 ModelRegistry 中注册的一致。
先讲这一页到底在解决什么
OpenClaw 如何把 pi 智能体嵌入消息网关
这一页讲的是 OpenClaw 通过直接调用 pi 的 createAgentSession() 将 AI 编码智能体嵌入到消息网关中，而不是作为子进程或 RPC 运行。重点看 runEmbeddedPiAgent() 的入参，尤其是 sessionKey、onBlockReply 和 provider/model 的配置方式。最容易出错的是：session 文件路径和 workspace 目录必须正确，否则会话无法持久化；provider 和 model 名称必须与 pi 的 ModelRegistry 中注册的一致。
第一站
🧱 先认出这不是“外接 API”，而是“直接住进来”
OpenClaw 直接创建 `AgentSession`，所以它能自己管生命周期和事件。
嵌入式
像把一个小 AI 住进自己的楼里，而不是每天去隔壁敲门。
会话生命周期
像你能自己决定它什么时候起床、什么时候睡觉。
工具注入
像给它随时递上新道具。
第二站
📦 依赖包各管一摊
这页把 `pi-ai`、`pi-agent-core`、`pi-coding-agent`、`pi-tui` 分得很清楚。
`pi-agent-core`
像负责干活和跑回路的骨架。
`pi-coding-agent`
像把会话、模型、认证、内置工具打包起来。
`pi-tui`
像终端里的前台窗口。
第三站
🗂 文件结构，是给想改代码的人看的地图
官方把 `src/agents/pi-embedded-runner/` 这些目录列出来，是告诉你从哪儿钻进去最合适。
run / compact / history
像会话执行、压缩、历史管理这几根主线。
google / images
像为多模态和模型顺序修的小道。
一句话
Pi 页是在讲“代理内嵌”这件事怎么落到真代码里。