OpenAB

OpenAB 是一個輕量的開源 Rust 程式，透過 stdio JSON-RPC 將 Discord 橋接到任何支援 Agent Client Protocol 的 coding CLI。

此模板部署的是 Claude 變體（openab-claude），使用 claude-agent-acp 作為 agent 後端。

注意事項

映像標籤： 此模板使用固定版本（0.8.3-beta.4）。如需升級，請在 Zeabur Dashboard → 服務 → 設定中更改映像標籤。可用標籤：GitHub Packages。
持久化儲存： /home/node 掛載為持久化磁碟。Plugins、設定、config 和認證資料會在重啟後保留。
檔案權限： 容器以 root 啟動後切換為 node 用戶（uid 1000）執行 openab。如遇權限問題，重啟服務即可 — 啟動時會自動修正權限。

設定步驟

1. 取得 Discord Bot Token

前往 https://discord.com/developers/applications，點擊 New Application
進入 Bot 頁籤 → 點擊 Reset Token → 複製 token
同一頁面往下滑，在 Privileged Gateway Intents 下啟用 Message Content Intent
前往 OAuth2 → URL Generator → 勾選 scope bot → 勾選權限：Send Messages、Send Messages in Threads、Create Public Threads、Read Message History、Add Reactions、Manage Messages
複製產生的 URL，在瀏覽器中開啟以邀請 Bot 到你的伺服器

2. 選擇認證方式（選填 — 留空則於容器內登入）

方式	使用方法
Anthropic API Key	前往 console.anthropic.com/settings/keys → Create Key → 將 `sk-ant-api...` 金鑰填入 `OPENAB_AUTH_TOKEN`
Zeabur AI Hub Token	前往 Zeabur AI Hub → API Keys → Create → 將 token 填入 `OPENAB_AUTH_TOKEN`
Claude OAuth Token	在終端執行 `claude setup-token`（需要 Claude Pro/Max/Team/Enterprise 訂閱）→ 開啟顯示的 URL → 授權 → 貼回驗證碼 → 將輸出的 `sk-ant-oat...` token 填入 `OPENAB_AUTH_TOKEN`
容器內登入	`OPENAB_AUTH_TOKEN` 留空。部署後到 Zeabur Dashboard → 服務 → Exec 執行 `runuser -u node -- claude auth login`（或 `claude setup-token`）。認證資料會寫入持久卷的 `/home/node/.claude/`，重啟後仍保留。

將 token 傳給 agent： openab 會以 env_clear() 隔離 agent 子程序，因此方式 1–3 需在首次啟動後編輯 /home/node/.config/openab/config.toml，在 [agent] 區塊加入 env allowlist（或顯式 env map）：
[agent]
inherit_env = ["ANTHROPIC_API_KEY", "CLAUDE_CODE_OAUTH_TOKEN", "ANTHROPIC_BASE_URL", "CLAUDE_CODE_DISABLE_EXPERIMENTAL_BETAS"]
方式 4 不需修改 — 認證資料直接從 ~/.claude/.credentials.json 讀取。

3. 取得 Discord 頻道 ID

開啟 Discord → 前往 使用者設定（齒輪圖示）→ 進階 → 啟用 開發者模式
對你要 Bot 回應的頻道按右鍵 → 複製頻道 ID
多個頻道用逗號分隔：123456789012345678,234567890123456789

4. 部署

填入變數後點擊部署即可。服務會自動連線到 Discord 和/或 Slack。

Slack 設定（選用）

OpenAB 支援透過 Socket Mode 連接 Slack，不需要公開 URL。

前往 https://api.slack.com/apps → Create New App → From scratch
Socket Mode → 啟用 → 產生 App-Level Token，scope 選 connections:write → 複製 xapp-... token（SLACK_APP_TOKEN）
Event Subscriptions → 啟用 → 新增 bot events：app_mention、message.channels、message.groups
OAuth & Permissions → Bot Token Scopes → 新增：app_mentions:read、chat:write、channels:history、groups:history、channels:read、groups:read、reactions:write、files:read、users:read
Install App → 安裝到工作區 → 複製 xoxb-... token（SLACK_BOT_TOKEN）
在每個要使用 Bot 的 Slack 頻道執行 /invite @YourAppName

部署前填入 SLACK_BOT_TOKEN 和 SLACK_APP_TOKEN 變數。Discord 和 Slack 可同時運作。

新增通訊平台（Telegram / LINE / Feishu / Google Chat / MS Teams）

若要橋接 Telegram、LINE、Feishu/Lark、Google Chat 或 MS Teams，請在同一個 Zeabur 專案中部署 OpenAB Gateway 模板，然後在此服務新增以下環境變數：

GATEWAY_URL = ws://openab-gateway:8080/ws
GATEWAY_PLATFORM = telegram、line、feishu、googlechat 或 teams 其中之一

重新啟動服務後，啟動腳本會自動在 config.toml 中加入 [gateway] 區塊。

使用方式

在允許的 Discord 或 Slack 頻道中 @mention Bot 即可開始對話
OpenAB 會自動建立 thread 進行多輪對話 — 後續訊息不需要再 @mention
每個 thread 對應一個持久的 Claude session（預設 24 小時 TTL）

自訂設定

檔案	說明
`/home/node/CLAUDE.md`	Agent 指令 — Claude 每次 session 會自動讀取
`/home/node/.config/openab/config.toml`	OpenAB 設定（sessions、reactions、STT 等）
`/etc/claude-code/managed-settings.json`	Claude Code 權限模式

config.toml 在首次啟動時從內建範本建立。之後請直接編輯檔案，環境變數僅用於初始設定。要恢復預設值請刪除後重啟：rm /home/node/.config/openab/config.toml

設定選項請參閱 OpenAB 文件。

停用

部署時將 Discord Bot Token 留空即可。服務會進入 sleep 狀態，不會崩潰。

OpenAB Claude

模板內的服務

openab