Pi Integration Architecture

这页讲的是 OpenClaw 怎么把一个叫 “pi” 的 AI 助手装到自己身体里。它不是简单地叫 pi 来帮忙，而是直接把 pi 的“大脑”请进来，这样 OpenClaw 就能完全控制它，让它按照 OpenClaw 的方式工作。

第一步：启动这个内置的 AI 助手 要启动它，需要告诉它一些事情，比如你是谁（sessionId），在哪里工作（workspaceDir），以及你想问它什么问题（prompt）。这就像你要叫醒一个聪明的朋友，得先告诉他你的名字，然后他才能在你自己的房间里帮你干活。

1. 要做什么：告诉 OpenClaw 你想启动 AI 助手。 怎么做：使用一个叫 runEmbeddedPiAgent 的命令，并告诉它你的名字、工作文件夹和你想问的问题。

第二步：给 AI 助手一个“身份”和“工具箱” 启动后，OpenClaw 会给这个 AI 助手创建一个“会话”。这就像给朋友一张工作证和一个工具箱。工具箱里有各种工具，比如读文件、写文件、发消息的工具。OpenClaw 还会把一些 pi 原来的工具换成自己更喜欢的工具。

1. 要做什么：创建 AI 助手的“会话”。 怎么做：使用一个叫 createAgentSession 的命令来创建。这里要小心，OpenClaw 会把所有工具都放在一个叫 customTools 的盒子里，而不是分开。

第三步：听听 AI 助手在干什么 创建好会话后，OpenClaw 会“竖起耳朵”听这个 AI 助手在做什么。比如，AI 开始思考了、开始用工具了、或者要回话了，OpenClaw 都能知道。这样它就能把 AI 的回答实时地发给你看。

1. 要做什么：监听 AI 助手的动作。 怎么做：使用一个叫 subscribeEmbeddedPiSession 的命令来“订阅”各种事件，比如 onBlockReply（当 AI 要回话时）。

第四步：向 AI 助手提问 一切都准备好后，就可以正式向 AI 助手提问了！OpenClaw 会把你的问题（和图片，如果你发了的话）交给它。然后 AI 助手就会开始思考，用工具箱里的工具，并一点点把回答“流”出来。

1. 要做什么：向 AI 助手提问。 怎么做：使用会话的 prompt 方法，把你的问题和图片传给它。

一些重要的注意事项：

• 工具箱很特别：OpenClaw 用的工具和 pi 自己用的不完全一样。它有自己的消息工具、画画工具，还会根据不同的聊天软件（比如 Discord、WhatsApp）换上不同的专用工具。
• “记忆”管理：AI 助手和你的对话历史会保存在一个文件里。如果对话太长了，OpenClaw 会帮它“整理记忆”，把不重要的部分压缩一下，这样它就不会忘记前面重要的内容。
• 多个“钥匙”：和 AI 模型（比如 Claude、GPT）说话需要“钥匙”（API Key）。OpenClaw 可以准备好多把钥匙，如果一把不好用了，它会自动换另一把试试。
• 不同的“大脑”：OpenClaw 可以和不同的 AI 模型（Anthropic 的 Claude、Google 的 Gemini、OpenAI 的 GPT 等）一起工作。但每个“大脑”脾气有点不一样，OpenClaw 知道怎么和它们每个都好好相处。
• 安全“沙箱”：如果打开了“沙箱”模式，AI 助手只能在规定的小区域里活动，不能乱跑乱动你电脑的其他地方。
• 和原来的 pi 不一样：OpenClaw 是把 pi 当作一个“零件”装在自己里面用，而不是直接运行 pi 那个完整的程序。所以它们管理对话、工具、钥匙的方式都有一点不同。