PiClaw 將 Pi Coding Agent 包裝成一個自託管工作區，配備三種語言的串流網頁使用者介面、持久化狀態、多供應商 LLM 支援，以及內建工具。可選的附加元件可擴展運行時間和網頁 UI。
作為一個有狀態的代理工作區，在本機或容器中運行。
開啟 http://localhost:8080 並輸入 /login 以設定您的 LLM 供應商，包括自訂的 OpenAI 相容端點和本機 llama.cpp 路由器預設設定。網頁 UI 預設提供英文、簡體中文和日文，可在設定中切換語言。
對於 docker run / podman run，請保持 --init 啟用，以便運行時間插入一個微小的 init 程序來處理信號轉發和僵屍進程回收。內建的 docker-compose.yml 現在設定了等效的 init: true 標誌。
在容器映像中，/home/agent/.pi 由 /config/.pi 支援。使用上述 docker run 範例或內建的 docker-compose.yml，Pi 的主目錄狀態將保留在主機的 ./home/.pi/agent/ 下。
這表示供應商登入狀態和模型元數據在儲存於以下檔案時應能存活於重建/重新建立過程：
切勿刪除 /workspace/.piclaw/store/messages.db。它是聊天記錄、媒體、任務和運行日誌、令牌使用量、加密的金鑰鏈條目、通行金鑰、網頁會話和聊天分支的真相來源。
您無需在 piclaw 環境變數中設定供應商 API 金鑰。PiClaw 會重複使用在 Pi Agent 設定中配置的供應商憑證。
工作區範圍的 shell 環境覆蓋設定可放在 /workspace/.env.sh。PiClaw 會為嵌入式終端機和運行時間啟動期間載入該檔案。用於 PATH 變更或具有 GH_CONFIG_DIR=/workspace/.config/gh 的持久化 GitHub CLI 目錄等設定。無效內容可能會破壞啟動、shell 行為或工具解析。
PiClaw 是單用戶、行動裝置友善的，並透過 SSE 串流更新。
如需完整的特色導覽，請參閱 docs/web-ui.md。
內建的 xterm.js 實作為預設終端機渲染器。Ghostty/WASM 渲染器可透過可選的 @rcarmo/piclaw-addon-ghostty-terminal 附加元件獨立取得。
如需完整列表、TOTP/通行金鑰設定、基於 SSH 的會話範圍遠端工具、反向代理配置以及工作區環境掛鉤，請參閱 docs/configuration.md。
實驗性功能。支援 Linux/macOS/Windows。請參閱 docs/install-from-repo.md。
Windows 支援為實驗性功能。Shell 式子進程在此處以 attached 模式運行 (detached=false)，因此 stdout 和 stderr 仍可被捕獲。類 Unix 主機使用 detached 進程組，以便 abort 和 shutdown 可以終止進程樹。
PiClaw 還提供了一個可選的 Electrobun 桌面包裝器，圍繞現有的本機網頁 UI：
桌面 shell 在 127.0.0.1 上啟動 Piclaw，使用從 18080 開始的可用端口，開啟一個原生窗口，並將其預設工作區儲存在平台應用程式數據目錄下。設定 PICLAW_DESKTOP_URL 以包裝一個已在運行的 Piclaw 網頁伺服器，而不是啟動一個新的。
工作項目和錯誤報告在 GitHub Issues 中追蹤。
使用 issue 模板和項目板標籤來定義泳道和分類分類法。
piclaw 與 pi.dev 沒有直接關聯。它是一個基於 Pi 核心的衍生作品，並添加了自己的運行時間、工具和 UI 層。
一個穿著彩色網路風衣的 pi 編碼代理