Pi 开发工作流

在 OpenClaw 中开发 Pi 集成的一个合理工作流。

类型检查和代码规范检查

• 默认本地检查点：pnpm check
• 构建检查点：当更改可能影响构建输出、打包或延迟加载/模块边界时，运行 pnpm build
• 针对重度 Pi 更改的完整落地检查点：pnpm check && pnpm test

运行 Pi 测试

使用 Vitest 直接运行专注于 Pi 的测试集：

pnpm test \
  "src/agents/pi-*.test.ts" \
  "src/agents/pi-embedded-*.test.ts" \
  "src/agents/pi-tools*.test.ts" \
  "src/agents/pi-settings.test.ts" \
  "src/agents/pi-tool-definition-adapter*.test.ts" \
  "src/agents/pi-hooks/**/*.test.ts"

要包含实时提供商演练：

OPENCLAW_LIVE_TEST=1 pnpm test src/agents/pi-embedded-runner-extraparams.live.test.ts

这涵盖了主要的 Pi 单元套件：

• src/agents/pi-*.test.ts
• src/agents/pi-embedded-*.test.ts
• src/agents/pi-tools*.test.ts
• src/agents/pi-settings.test.ts
• src/agents/pi-tool-definition-adapter.test.ts
• src/agents/pi-hooks/*.test.ts

手动测试

推荐流程：

• 在开发模式下运行网关：
  • pnpm gateway:dev
• 直接触发代理：
  • pnpm openclaw agent --message "Hello" --thinking low
• 使用 TUI 进行交互式调试：
  • pnpm tui

对于工具调用行为，提示进行 read 或 exec 操作，以便查看工具流传输和负载处理。

完全重置

状态存储在 OpenClaw 状态目录下。默认为 ~/.openclaw。如果设置了 OPENCLAW_STATE_DIR，则使用该目录。

要重置所有内容：

• openclaw.json 用于配置
• agents/<agentId>/agent/auth-profiles.json 用于模型认证配置文件（API 密钥 + OAuth）
• credentials/ 用于仍存在于认证配置文件存储之外的提供商/渠道状态
• agents/<agentId>/sessions/ 用于代理会话历史记录
• agents/<agentId>/sessions/sessions.json 用于会话索引
• sessions/ 如果存在旧版路径
• workspace/ 如果你想要一个空白的工作区

如果你只想重置会话，请删除该代理的 agents/<agentId>/sessions/。如果你想保留认证，请保留 agents/<agentId>/agent/auth-profiles.json 和 credentials/ 下的任何提供商状态。

参考

• 测试
• 入门指南

相关

• Pi 集成架构