简要总结
Pi Development Workflow
这页说明书是给想玩转“Pi”积木的大朋友看的。Pi是OpenClaw里的一个聪明小助手。这里会告诉你，在动手搭建Pi之前和之后，有哪些像“检查积木有没有放对”和“试试看小助手会不会动”这样的重要事情要做。如果你正准备让Pi小助手开始工作，或者想把它重新收拾干净，就可以看看这页。
五岁小孩版解释
这页纸是教你如何安全、开心地和OpenClaw里的“Pi”小助手一起工作的。Pi就像一个很聪明的机器人朋友，但我们需要用正确的方法来检查它、测试它，这样它才能好好帮你。
第一步：先检查一下 在你让Pi小助手开始工作前，最好先检查一下它的“身体”是不是都准备好了。这就像你搭积木前，要先看看积木块全不全、有没有放对地方。
- 用
pnpm build命令检查。这就像让电脑帮你看看，给Pi小助手的指令写得对不对。 - 用
pnpm lint命令检查。这就像让电脑帮你看看，给Pi小助手的指令写得整不整齐。 - 用
pnpm format命令检查。这就像让电脑帮你看看，给Pi小助手的指令写得漂不漂亮。 在你准备把做好的Pi小助手交给别人（推送代码）之前，最好把上面三个检查一起做一遍，命令是pnpm lint && pnpm build && pnpm test。这是一个很重要的“大门”，检查通过了才能出去。
第二步：让Pi小助手做练习 现在，我们可以专门让Pi小助手做一些练习（运行测试），看看它学得怎么样。我们用Vitest这个“小教练”来指挥。
- 要开始练习，就在电脑里输入
pnpm test --，然后后面跟着一长串告诉小教练“只让Pi做这些练习”的指令。这些指令是："src/agents/pi-*.test.ts""src/agents/pi-embedded-*.test.ts"- 等等（后面还有几个类似的）。
- 如果你想做一个特别的“现场反应练习”（live provider exercise），需要先设置一个特殊开关。输入
OPENCLAW_LIVE_TEST=1 pnpm test -- src/agents/pi-embedded-runner-extraparams.live.test.ts。注意，这个练习需要特别的准备哦。
第三步：亲手和Pi小助手玩一玩 检查完也练习完了，我们可以亲手试试Pi小助手是不是真的会干活了。
- 首先，要把一个叫“gateway”的大门打开，并且让它处于“开发模式”。输入命令：
pnpm gateway:dev。 - 然后，你可以直接对Pi小助手说话。输入命令：
pnpm openclaw agent --message "Hello" --thinking low。这就像你对它说“你好”，并让它简单想想怎么回答。 - 你还可以用一个叫TUI的图画界面和它玩。输入命令：
pnpm tui。 如果你想看Pi小助手怎么使用“工具”（比如读文件或运行命令），你可以在测试时让它做一个read（读）或exec（执行）的动作，这样你就能看到它使用工具的样子了。
第四步：把Pi小助手收拾干净
有时候，你可能想把Pi小助手周围的环境恢复成干干净净的样子，就像把玩具箱清空一样。Pi小助手记住的东西（状态）通常放在一个叫 ~/.openclaw 的文件夹里。如果你的电脑设定了 OPENCLAW_STATE_DIR，那就放在它说的那个文件夹。
要清空一切，你需要删除下面这些东西：
openclaw.json文件：这里面是Pi小助手的基本设置。credentials/文件夹：这里面是登录的密码和钥匙，删掉的话下次就要重新登录了。agents/<agentId>/sessions/文件夹和agents/<agentId>/sessions.json文件：这是某个Pi小助手的聊天记录和目录，删掉它就忘记以前聊过什么了。sessions/文件夹（如果存在的话）：这是以前版本的聊天记录。workspace/文件夹：这是Pi小助手的工作台，清空它就什么都没有了。 小心哦，如果你只想让Pi小助手忘记聊天记录，但保留登录信息（这样就不用重新输密码了），那就只删除第3条里的那两个东西，不要动credentials/文件夹。