OpenClaw 背後核心框架 Pi：好的 Coding Agent 應該讓用戶決定需要什麼

🔑 增強重點摘要

• •Pi 的 session 設計為樹狀結構，支持分支與導航，可在不浪費主 session 上下文的情況下處理子任務，如修復工具後回溯並總結分支內容。[1]
• •Pi 支持多模型提供者，session 可攜性高，避免依賴特定模型功能，並透過擴展實現自訂 TUI 元件如進度條、檔案選擇器，甚至在終端運行 Doom。[1]
• •OpenClaw 移除 auth: 'none' 模式以提升安全性，憑證以明文 Markdown/JSON 儲存於本地，建議綁定 loopback 並使用 SSH 隧道遠端存取。[3][5]
• •Pi 被嵌入 OpenClaw 的 Agent Runtime 中，使用 RPC 風格調用與串流回應，包含 session 解析、上下文組裝、模型調用與工具執行四階段流程。[2]

🛠️ 技術深入

• •Pi 的 Agent Runtime 位於 src/agents/piembeddedrunner.ts，使用 @mariozechner/pi-agent-core 庫，執行四階段：session 解析、上下文組裝（包含 base system prompt 與工作區檔案）、串流模型回應與工具執行、狀態持久化至磁碟。[2]
• •系統提示為可組合式，由 AGENTS.md、SOUL.md、TOOLS.md 等檔案定義，允許透過編輯檔案變更行為，而不需修改原始碼，執行與沙箱由 runtime 強制。[2]
• •安全機制包括輸入消毒（src/agents/pi-embedded-helpers.ts）、模型故障轉移（src/agents/model-fallback.ts）、上下文視窗守護（src/agents/context-window-guard.ts）與 session 壓縮（src/agents/compaction.ts）。[6]
• •Gateway 綁定預設埠 18789，提供控制 UI 與 WebChat，支持 50+ 訊息通道如 WhatsApp、Telegram、Slack，憑證本地明文儲存於特定目錄。[5]

🔮 前景展望AI analysis grounded in cited sources

⏳ 時間線