Pi (experimental)Pi 实验引擎

Pi (experimental)Pi 实验引擎

Start with engine capabilities, then follow its installation, model sync and workspace guide. Pi remains experimental; engine capabilities differ.先了解各引擎能力，再按目标完成安装、模型同步和工作台配置。Pi 仍为实验版，各引擎功能并不相同。

Pi 仍为实验版

Pi 自 ClawPanel 0.22.0 起提供独立受管安装与工作台，0.22.1 继续标记实验版，不代表与 OpenClaw 完整功能对等。当前固定验收版本是 @earendil-works/pi-coding-agent@1.1.0，要求完整 Node.js 22.19.0+ 和 npm；统一多引擎环境推荐 Node.js 24.16.0+（24.x）。

  1. 从侧栏选择 Pi，进入「运行与配置」安装受管运行时。
  2. 在「通用 → 模型渠道」保存地址、API Key、模型和上下文/输出上限，显式「同步到 Pi」，按需设为默认模型。
  3. 设置工作目录，在独立工作台创建会话、切换模型并发送测试消息。Pi 使用官方 JSONL RPC，不是上游实验 Web Server 的 iframe，也不需要 OpenClaw Gateway。

协议与逐次审批

转换支持 OpenAI Chat Completions、OpenAI Responses、Anthropic Messages、Google Generative AI；Ollama 使用 OpenAI 兼容 /v1。当前同步需要已保存 API Key，OAuth 和结构化 SecretRef 尚未接入；配置写入回读不是实际模型调用证明。

默认只开放 read/grep/find/ls；开启写入及命令后，edit/write/bash/powershell 每次操作均需确认。路径工具限制工作目录并防止越界，但工作目录不是操作系统沙箱：批准命令后仍具有面板进程账号的系统权限。不要用于多用户代码执行隔离。

默认不自动加载项目扩展、MCP、Skills、提示词模板和上下文文件。完整思考档位、排队/steer、附件、压缩和分支等能力尚未全部开放，不宣称完整兼容。

会话、更新与数据

数据保存在当前配置根的 clawpanel/pi/，不改写已有 ~/.pi；Web 不新增公开 Pi 端口。工作目录和工具权限作为新会话默认值，历史会话保留各自项目与权限；断线恢复不自动重发任务。

检查上游更新由用户触发，安装更新仅接受面板验收的固定版本，不自动切换到未经验证的新版本。任务执行期间限制安装、更新、卸载、同步和工作目录变更。卸载仅移除运行时，保留配置、凭据、会话及工作目录。

验收范围

本地模拟 Provider 的流式回复、审批和恢复测试，不等于付费供应商全部协议、Tauri GUI 或 Linux/macOS/ARM64 真机均已验收。实际使用应验证完整回复、审批拒绝/允许、停止及刷新恢复；反馈附脱敏日志。另见引擎与驱动。

Pi remains experimental

Pi has an independent managed runtime and workspace since ClawPanel 0.22.0 and remains experimental in 0.22.1, not feature-equivalent to OpenClaw. The accepted version is @earendil-works/pi-coding-agent@1.1.0, requiring complete Node.js 22.19.0+ and npm. Node.js 24.16.0+ (24.x) is recommended for a shared multi-engine environment.

  1. Select Pi and install the managed runtime in Run & configuration.
  2. Save the address, API key, models and context/output limits in General → Model channels. Explicitly select Sync to Pi and optionally set the default model.
  3. Choose a working directory, create a session in the independent workspace, switch models and send a test message. Pi uses official JSONL RPC, not an iframe of its experimental Web Server, and does not require OpenClaw Gateway.

Protocols and per-action approval

Conversion supports OpenAI Chat Completions, OpenAI Responses, Anthropic Messages and Google Generative AI; Ollama uses OpenAI-compatible /v1. Sync currently requires a saved API key; OAuth and structured SecretRef are not connected. Configuration readback is not proof of a model call.

Only read/grep/find/ls are enabled by default. After enabling writes and commands, each edit/write/bash/powershell action requires approval. Path tools enforce working-directory boundaries, but a working directory is not an operating-system sandbox: approved commands still have the panel process account's system permissions. This is not multi-user code-execution isolation.

Project extensions, MCP, Skills, prompt templates and context files are not loaded automatically. Full reasoning controls, queue/steer, attachments, compaction and branching are not all available; do not assume full compatibility.

Sessions, updates and data

Data lives under clawpanel/pi/ in the current configuration root without modifying an existing ~/.pi. Web mode adds no public Pi port. Working directories and tool permissions are defaults for new sessions; history retains its own project and permissions. Reconnection does not automatically resend tasks.

Users trigger upstream update checks; installs and updates accept only the fixed version validated by the panel, not unverified releases. Active tasks restrict install, update, uninstall, model sync and directory changes. Uninstall removes only the managed runtime, retaining configuration, credentials, sessions and projects.

Acceptance scope

Streaming, approval and restore tests with a local mock Provider do not prove paid-provider protocols, complete Tauri GUI behavior or Linux/macOS/ARM64 physical-device acceptance. Verify complete replies, approval denial/allow, stop and refresh restore in your deployment; provide redacted logs when reporting issues. See Engines & drivers.

qt.cool