mirror of
https://github.com/openclaw/openclaw.git
synced 2026-02-09 05:19:32 +08:00
* docs(markdownlint): enable autofixable rules except list numbering * docs(zalo): fix malformed bot platform link
2.0 KiB
2.0 KiB
title
| title |
|---|
| Pi Development Workflow |
Pi Development Workflow
This guide summarizes a sane workflow for working on the pi integration in OpenClaw.
Type Checking and Linting
- Type check and build:
pnpm build - Lint:
pnpm lint - Format check:
pnpm format - Full gate before pushing:
pnpm lint && pnpm build && pnpm test
Running Pi Tests
Use the dedicated script for the pi integration test set:
scripts/pi/run-tests.sh
To include the live test that exercises real provider behavior:
scripts/pi/run-tests.sh --live
The script runs all pi related unit tests via these globs:
src/agents/pi-*.test.tssrc/agents/pi-embedded-*.test.tssrc/agents/pi-tools*.test.tssrc/agents/pi-settings.test.tssrc/agents/pi-tool-definition-adapter.test.tssrc/agents/pi-extensions/*.test.ts
Manual Testing
Recommended flow:
- Run the gateway in dev mode:
pnpm gateway:dev
- Trigger the agent directly:
pnpm openclaw agent --message "Hello" --thinking low
- Use the TUI for interactive debugging:
pnpm tui
For tool call behavior, prompt for a read or exec action so you can see tool streaming and payload handling.
Clean Slate Reset
State lives under the OpenClaw state directory. Default is ~/.openclaw. If OPENCLAW_STATE_DIR is set, use that directory instead.
To reset everything:
openclaw.jsonfor configcredentials/for auth profiles and tokensagents/<agentId>/sessions/for agent session historyagents/<agentId>/sessions.jsonfor the session indexsessions/if legacy paths existworkspace/if you want a blank workspace
If you only want to reset sessions, delete agents/<agentId>/sessions/ and agents/<agentId>/sessions.json for that agent. Keep credentials/ if you do not want to reauthenticate.