從 demo 到可靠運行的坑：OpenClaw Pi SDK 架構文件的誠實告白

OpenClaw 架構文件的誠實之處，在最後那段自列的五個待重構區域。但在那之前，七層工具鏈和每個 LLM 的骨折修復，已經告訴你把 AI agent 從能動帶到可靠運行需要多少代價。 ⭐ 文章深度讀：七層工具鏈架構全解析和 LLM 骨折修復細節 → https://heymaibao.com/openclaw-pi-agent-production-cost/ ⚡ 章節重點 00:00 開場：五分鐘 demo 的崩潰現場 01:50 架構選擇代價：叫計程車 vs 自己開車 04:56 七層才夠用：不是誇張是必要 08:39 每個 LLM 都有骨折：日常打石膏 📝 懶人包 ∙ OpenClaw 選擇把 pi SDK 直接嵌入程式碼 (embedded)，而非用子程序或遠端呼叫，換到的是完整控制權，代價是更高的整合複雜度。 ∙ 工具鏈是七層工具流程，最後一個設計決策尤其值得注意：把所有工具都放進「自訂工具」那堆，不留任何內建預設，確保規則過濾對每個工具一視同仁。 ∙ Gemini、Anthropic、OpenAI 每家都有自己的怪癖，OpenClaw 用了一層專屬的「骨折修復」代碼，才讓上層 API 可以假裝 AI 服務商不存在。 ∙ 我的觀察：架構文件結尾那五個「未來待重構區域」，比整份文件的其他部分都誠實。正式上線的 AI 工具不是做完就完，一直有待改進的地方才是正常狀態。 📚 參考資料 Pi Integration Architecture → https://docs.openclaw.ai/pi