OpenAB Pi

一鍵部署 OpenAB 搭配 Pi coding agent 作為 AI 後端。透過 pi-acp Node.js 適配器橋接 ACP JSON-RPC ↔ Pi CLI。

為什麼選 Pi？

• 原生訂閱認證 — Claude Pro/Max 與 ChatGPT Plus/Pro 透過 pi /login，無需 auth-proxy sidecar。
• 極簡工具 — 僅 4 個工具（read / write / edit / bash），最大化 context window。
• 多模型 — 支援 Anthropic / OpenAI / Google 與任何 OpenAI-compatible endpoint（DeepSeek、Groq、Together、Ollama 等），可於對話中切換模型。
• 分支 session — Pi 將 history 存為樹狀，可從同一決策點探索多個方向。

注意事項

• 映像標籤： 本模板追蹤 beta 標籤。若要 pin 特定版本，請至 Zeabur Dashboard → 服務 → 設定修改映像標籤。
• 持久化儲存： /home/node 掛載為持久化磁碟。Config、認證 Token（~/.pi/）與 session 樹會在重啟後保留。
• Config 位置： 首次啟動時生成於 /home/node/.config/openab/config.toml。之後直接編輯即可。
• 使用者目錄： Pi 以 node 使用者（UID 1000）執行——與其他 agent 模板的 agent 使用者不同。本模板所有路徑皆以 /home/node 開頭。

設定

1. 建立 Discord Bot

1. 前往 Discord Developer Portal 建立應用程式並加上 Bot
2. 在 Privileged Gateway Intents 啟用 Message Content Intent
3. 複製 bot token 貼到 DISCORD_BOT_TOKEN
4. OAuth2 → URL Generator → scope 勾 bot、權限勾 Send Messages、Read Message History、Add Reactions 等
5. 用產生的網址邀請 bot 到伺服器

2. 認證 Pi

Pi 認證採互動式介面。部署後於 Zeabur Dashboard → Exec 分頁執行：

pi

在 Pi 互動介面中輸入：

/login

選擇你的 provider 並依瀏覽器 OAuth 流程完成。Token 會存於 /home/node/.pi/。

若要用 API key（pay-per-token）取代訂閱：

pi
# 在 Pi 中：
/set OPENAI_API_KEY sk-...
# 或
/set ANTHROPIC_API_KEY sk-ant-...

3. 設定頻道（選填）

設定 OPENAB_ALLOWED_CHANNELS 限制 bot 回應的頻道；留空則允許所有頻道。

Slack 設定（選填）

1. https://api.slack.com/apps → Create New App
2. 啟用 Socket Mode → 產生 App-Level Token（scope connections:write）
3. 啟用 Event Subscriptions → bot events: app_mention、message.channels、message.groups
4. OAuth & Permissions → scopes: app_mentions:read、chat:write、channels:history 等
5. 安裝 App → 複製 xoxb-... 與 xapp-... token

自訂

檔案	說明
/home/node/.config/openab/config.toml	OpenAB 設定（sessions、reactions 等）
/home/node/.pi/	Pi 設定與認證 Token
/home/node/.pi/sessions/	Pi session 樹
/home/node/AGENTS.md	專案層級的 Pi steering 檔案（注入到 context）
/home/node/.pi/APPEND_SYSTEM.md	附加到 Pi 預設 system prompt
/home/node/.pi/SYSTEM.md	完全取代 Pi 預設 system prompt

重置 OpenAB config：rm /home/node/.config/openab/config.toml 後重啟。

限制

• 不支援串流 — pi-acp 一次回傳完整回應；中間輸出會被緩衝。
• 取消為盡力而為 — session/cancel 可能無法中斷生成中的回應；Pi CLI 會執行到完成。

連結

• OpenAB GitHub
• Pi Coding Agent
• Pi 設定指南
• Agent Client Protocol