Files
openclaw/docs/zh-CN/pi-dev.md
yunxiafei 89a243be70
Some checks failed
CI / docs-scope (push) Has been cancelled
CI / secrets (push) Has been cancelled
CI / ios (push) Has been cancelled
Docker Release / validate_manual_backfill (push) Has been cancelled
Install Smoke / docs-scope (push) Has been cancelled
Sandbox Common Smoke / sandbox-common-smoke (push) Has been cancelled
Workflow Sanity / no-tabs (push) Has been cancelled
Workflow Sanity / actionlint (push) Has been cancelled
Workflow Sanity / config-docs-drift (push) Has been cancelled
CI / changed-scope (push) Has been cancelled
CI / build-artifacts (push) Has been cancelled
CI / release-check (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && bunx vitest run --config vitest.unit.config.ts, bun, test) (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && pnpm test, node, 2, 1, test) (push) Has been cancelled
CI / checks (pnpm canvas:a2ui:bundle && pnpm test, node, 2, 2, test) (push) Has been cancelled
CI / checks (pnpm protocol:check, node, protocol) (push) Has been cancelled
CI / checks (pnpm test:channels, node, channels) (push) Has been cancelled
CI / checks (pnpm test:extensions, node, extensions) (push) Has been cancelled
CI / check (push) Has been cancelled
CI / startup-memory (push) Has been cancelled
CI / check-docs (push) Has been cancelled
CI / compat-node22 (push) Has been cancelled
CI / skills-python (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 1, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 2, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 3, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 4, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 5, test) (push) Has been cancelled
CI / checks-windows (pnpm test, node, 6, 6, test) (push) Has been cancelled
CI / macos (push) Has been cancelled
CI / android (./gradlew --no-daemon :app:assembleDebug, build) (push) Has been cancelled
CI / android (./gradlew --no-daemon :app:testDebugUnitTest, test) (push) Has been cancelled
Docker Release / approve_manual_backfill (push) Has been cancelled
Docker Release / build-amd64 (push) Has been cancelled
Docker Release / build-arm64 (push) Has been cancelled
Docker Release / create-manifest (push) Has been cancelled
Install Smoke / install-smoke (push) Has been cancelled
初版
2026-03-16 17:22:13 +08:00

2.1 KiB

title, x-i18n
title x-i18n
Pi 开发工作流程
generated_at model provider source_hash source_path workflow
2026-02-03T10:07:59Z claude-opus-4-5 pi 65bd0580dd03df05321ced35a036ce6fb815ce3ddac1d35c9976279adcbf87c0 pi-dev.md 15

Pi 开发工作流程

本指南总结了在 OpenClaw 中开发 Pi 集成的合理工作流程。

类型检查和代码检查

  • 类型检查和构建:pnpm build
  • 代码检查:pnpm lint
  • 格式检查:pnpm format
  • 推送前完整检查:pnpm lint && pnpm build && pnpm test

运行 Pi 测试

使用专用脚本运行 Pi 集成测试集:

scripts/pi/run-tests.sh

要包含执行真实提供商行为的实时测试:

scripts/pi/run-tests.sh --live

该脚本通过以下 glob 模式运行所有 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-extensions/*.test.ts

手动测试

推荐流程:

  • 以开发模式运行 Gateway 网关:
    • pnpm gateway:dev
  • 直接触发智能体:
    • pnpm openclaw agent --message "Hello" --thinking low
  • 使用 TUI 进行交互式调试:
    • pnpm tui

对于工具调用行为,提示执行 readexec 操作,以便查看工具流式传输和负载处理。

完全重置

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

要重置所有内容:

  • openclaw.json 用于配置
  • credentials/ 用于认证配置文件和 token
  • agents/<agentId>/sessions/ 用于智能体会话历史
  • agents/<agentId>/sessions.json 用于会话索引
  • sessions/ 如果存在旧版路径
  • workspace/ 如果你想要一个空白工作区

如果只想重置会话,删除该智能体的 agents/<agentId>/sessions/agents/<agentId>/sessions.json。如果不想重新认证,保留 credentials/

参考资料