Pi Local
pilocal runs the Pi coding agent CLI on the same machine as Paperclip. Use it when you want Pi's built-in tool set (read, bash, edit, write, grep, find, ls), provider/model routing, and session resum…
Pi Local
pilocal runs the Pi coding agent CLI on the same machine as Paperclip. Use it when you want Pi's built-in tool set (read, bash, edit, write, grep, find, ls), provider/model routing, and session resume across heartbeats.
---
When To Use
You already use the Pi CLI locally. You want provider/model routing in Pi's --provider <name> --model <id> format. You want Paperclip to resume Pi sessions across heartbeats via --session. You need Pi's tool set available to the agent.
When Not To Use
The runtime lives behind a webhook or API. Use OpenClaw Gateway (/docs/adapters/openclaw-gateway) or HTTP (/docs/adapters/http). You only need a one-shot shell command. Use Process (/docs/adapters/process). Pi CLI is not installed on the machine.
---
Common Fields
| Field | Required | Notes | |---|---:|---| | cwd | no | Absolute working directory. Recommended. Created when permissions allow; otherwise falls back to the process working directory. | | model | yes | Pi model id in provider/model format (e.g. xai/grok-4). | | thinking | no | Thinking level passed to Pi. Accepts off, minimal, low, medium, high, xhigh. | | promptTemplate | no | User prompt template passed via the -p flag. | | instructionsFilePath | no | Absolute path to a Markdown instructions file appended to Pi's system prompt via --append-system-prompt. | | command | no | Defaults to pi. Override only for a non-default executable path. | | env | no | Environment variables. Secret refs supported. | | timeoutSec | no | Run timeout in seconds. 0 means no timeout. | | graceSec | no | SIGTERM grace period before a forced stop. |