|
Download docs/pi-dev.md from shimen/shinclaw: direct link, hf CLI and curl.
- Browser
- Download file 2.02 kB
-
https://huggingface.co/spaces/shimen/shinclaw/resolve/main/docs/pi-dev.md
- Command line
-
hf download hf://spaces/shimen/shinclaw/docs/pi-dev.md
-
curl -L -o pi-dev.md https://huggingface.co/spaces/shimen/shinclaw/resolve/main/docs/pi-dev.md
2.02 kB
metadata
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.