OpenAB — Open Agent Broker¶

資料來源¶

項目	連結
GitHub Repo	openabdev/openab
Helm Chart 文件	openabdev.github.io/openab
Zeabur 一鍵部署	Zeabur Template
ACP 官方協定	agentclientprotocol.com
ACP 開發者介紹	A Developer's Intro to ACP
ACP 協定缺口分析	OpenClaw ACP Protocol Gaps
競品：OpenACP	Open-ACP/OpenACP
靈感來源：sample-acp-bridge	aws-samples/sample-acp-bridge

專案狀態： ⭐ 238 stars · Rust · MIT · 2026-04-03 創建 · 活躍開發中

專案概述¶

OpenAB（Open Agent Broker）是一個用 Rust 寫的輕量級 ACP harness，將 Discord 聊天介面橋接到任何 Agent Client Protocol 相容的 Coding CLI。使用者在 Discord 頻道中 @mention 機器人，OpenAB 自動建立 thread、spawn CLI 子程序、透過 stdio JSON-RPC 雙向通訊，並以 edit-streaming 即時更新回覆。

核心定位：讓團隊成員在 Discord 中直接使用 Kiro CLI、Claude Code、Codex、Gemini 等 Coding Agent，不需要每個人都安裝 CLI 或設定開發環境。特別適合部署在 Kubernetes 上作為團隊共享的 Agent 服務。

核心架構¶

┌──────────────┐  Gateway WS   ┌──────────────┐  ACP stdio    ┌──────────────┐
│   Discord    │◄─────────────►│   OpenAB     │──────────────►│  Coding CLI  │
│   使用者      │               │   (Rust)     │◄── JSON-RPC ──│  (ACP mode)  │
└──────────────┘               └──────────────┘               └──────────────┘
                                      │
                                      ▼
                               ┌──────────────┐
                               │ Session Pool │ ← 每個 Discord thread 一個 CLI process
                               │ max=10, TTL  │
                               └──────────────┘

原始碼結構¶

檔案	職責
`src/main.rs`	進入點：tokio + serenity + cleanup + shutdown
`src/config.rs`	TOML 設定 + `${ENV_VAR}` 展開
`src/discord.rs`	Discord bot：@mention、thread 建立、edit-streaming
`src/format.rs`	訊息切割（Discord 2000 字元限制）
`src/reactions.rs`	狀態 emoji 控制器（debounce、stall 偵測）
`src/acp/protocol.rs`	JSON-RPC types + ACP event 分類
`src/acp/connection.rs`	spawn CLI、stdio JSON-RPC 通訊
`src/acp/pool.rs`	thread_id → AcpConnection map

支援的 Agent 後端¶

Agent Key	CLI	ACP Adapter	認證方式
`kiro`（預設）	Kiro CLI	原生 `kiro-cli acp`	`kiro-cli login --use-device-flow`
`codex`	Codex	@zed-industries/codex-acp	`codex login --device-auth`
`claude`	Claude Code	@agentclientprotocol/claude-agent-acp	`claude setup-token`
`gemini`	Gemini CLI	原生 `gemini --acp`	Google OAuth 或 `GEMINI_API_KEY`
`copilot` ⚠️	Copilot CLI	原生 `copilot --acp --stdio`	`gh auth login` device flow

⚠️ Copilot CLI 的 ACP 支援自 2026-01-28 進入 public preview，需付費訂閱（Pro/Pro+/Business/Enterprise），Free tier 不包含 CLI/ACP 存取。預設模型為 Claude Sonnet 4.6，也可切換 Opus 4.6、GPT-5.3-Codex、Gemini 3 Pro。

核心功能¶

功能	說明
@mention 觸發	在允許的頻道中 @bot 啟動對話
Thread 多輪對話	自動建立 thread，後續回覆不需 @mention
Edit-streaming	每 1.5s 更新 Discord 訊息，即時顯示生成內容
Emoji 狀態反應	👀→🤔→🔥/👨‍💻/⚡→👍 + 隨機表情，視覺化 Agent 狀態
Session Pool	每個 thread 一個 CLI process，自動生命週期管理
權限自動回覆	ACP tool call 的 permission 請求自動處理
Voice STT	自動轉錄 Discord 語音訊息，支援 Groq / OpenAI / 本地 Whisper
Multi-Agent 部署	單一 Helm release 同時運行多個 Agent（各自獨立 Pod）
Kubernetes-ready	Dockerfile + k8s manifests + Helm chart，PVC 持久化認證
Zeabur 一鍵部署	雲端模板免設定部署

快速開始¶

# 1. 設定
cp config.toml.example config.toml
# 編輯 bot_token 和 allowed_channels

# 2. 開發模式
export DISCORD_BOT_TOKEN="your-token"
cargo run

# 3. 生產模式
cargo build --release
./target/release/openab config.toml

Helm 安裝（推薦）：

helm repo add openab https://openabdev.github.io/openab
helm repo update

# 單一 Agent（Kiro CLI）
helm install openab openab/openab \
  --set agents.kiro.discord.botToken="$DISCORD_BOT_TOKEN" \
  --set-string 'agents.kiro.discord.allowedChannels[0]=YOUR_CHANNEL_ID'

# 多 Agent（Kiro + Claude 同時運行）
helm install openab openab/openab \
  --set agents.kiro.discord.botToken="$KIRO_BOT_TOKEN" \
  --set agents.claude.discord.botToken="$CLAUDE_BOT_TOKEN" \
  ...

Voice STT（語音訊息轉文字）¶

OpenAB 可自動轉錄 Discord 語音訊息並轉發給 ACP Agent 處理：

Discord 語音訊息 (.ogg) → openab 下載 → POST /audio/transcriptions → STT 服務
                                                                          ↓
                          ACP Agent 收到純文字 ← "[Voice message transcript]: ..."

STT 供應商選項¶

方案	設定	成本	備註
Groq（推薦）	`api_key = "${GROQ_API_KEY}"`	免費 tier	預設，自動偵測 env var
OpenAI	`base_url = "https://api.openai.com/v1"`	~$0.006/min	model: `whisper-1`
本地 Whisper	`base_url = "http://localhost:8080/v1"`	$0	音訊不離開本機
LAN Sidecar	`base_url = "http://192.168.x.x:8080/v1"`	$0	區網內其他機器

# config.toml 最簡設定
[stt]
enabled = true
# 只要環境變數有 GROQ_API_KEY 就自動使用 Groq

相容的本地 Whisper server：faster-whisper-server、whisper.cpp server、LocalAI（皆支援 Apple Silicon 硬體加速）。

Multi-Agent 部署¶

單一 Helm release 即可同時運行多個 Agent，每個 Agent 獨立 Deployment + ConfigMap + Secret + PVC：

# 同時跑 Kiro + Claude + Codex + Gemini
helm install openab openab/openab \
  --set agents.kiro.discord.botToken="$KIRO_BOT_TOKEN" \
  --set agents.claude.discord.botToken="$CLAUDE_BOT_TOKEN" \
  --set agents.claude.image=ghcr.io/openabdev/openab-claude:latest \
  --set agents.codex.discord.botToken="$CODEX_BOT_TOKEN" \
  --set agents.codex.image=ghcr.io/openabdev/openab-codex:latest \
  --set agents.gemini.discord.botToken="$GEMINI_BOT_TOKEN" \
  --set agents.gemini.image=ghcr.io/openabdev/openab-gemini:latest \
  ...

每個 Agent 可設定不同的 allowedChannels，讓不同 Discord 頻道使用不同 Agent。設定 agents.<name>.enabled: false 可跳過特定 Agent。

ACP 協定簡介¶

Agent Client Protocol（ACP）是由 Zed 編輯器團隊推動的標準化協定，定義 編輯器/客戶端 與 Coding Agent 之間的通訊方式：

ACP 協定定位
─────────────────────────────────────────
  MCP = Agent ↔ 工具/資料（Tool Protocol）
  ACP = Client ↔ Agent（Agent Protocol）
  兩者正交，可組合使用
─────────────────────────────────────────

通訊方式：JSON-RPC 2.0 over stdio（本地）/ HTTP（遠端，開發中）
Session 模型：Client spawn Agent 為子程序 → 建立 session → prompt → streaming response

OpenAB 的創新在於：將 ACP 的 client 角色從「編輯器」替換為「Discord bot」，使得 ACP Agent 可以在聊天平台上被使用。

與 OpenACP 的比較¶

比較項目	OpenAB	OpenACP
語言	Rust	Node.js
聊天平台	Discord only	Telegram + Discord + Slack
支援 Agent 數	5（Kiro/Claude/Codex/Gemini/Copilot）	28+（含 Cursor、Cline、goose 等）
部署方式	Kubernetes / Helm / Zeabur	npm + daemon mode
特色功能	Emoji 狀態、edit-streaming、Voice STT、Multi-Agent Helm	Monaco Editor、語音訊息、REST API
專案成熟度	新專案（238 stars, 快速成長中）	較成熟（58 stars, 1,410 commits）
設計哲學	輕量、單一用途、Rust 效能	功能全面、Plugin 系統

目前限制¶

限制	說明
僅支援 Discord	不像 OpenACP 支援 Telegram/Slack
新專案風險	2026-04-03 建立，約兩週歷史，API 可能變動
單機 Session	Session pool 綁定單一 Pod，無跨 Pod 分散
認證需手動	首次需 `kubectl exec` 進 Pod 做 OAuth 登入
無多使用者隔離	所有頻道使用者共享同一個 Agent 身份
Copilot ACP 為 preview	行為可能變更，需付費 Copilot 訂閱
Ollama 不支援 STT	Ollama 無 `/audio/transcriptions` endpoint

研究價值與啟示¶

關鍵洞察¶

ACP 正在成為 Coding Agent 的「USB 介面」：就像 LSP 統一了編輯器與語言伺服器的溝通，ACP 正在統一 Client 與 Coding Agent 的溝通。OpenAB 證明了 ACP 的 client 不一定是編輯器——任何能 spawn process 的程式都能成為 ACP client，包括 Discord bot、Telegram bot、甚至 CI/CD pipeline。
Discord 作為 Coding Agent 介面的價值：團隊中不是每個人都需要（或想要）在終端機裡跑 Coding Agent。Discord 提供了低門檻的存取方式——PM 可以叫 Agent 解釋程式碼、QA 可以叫 Agent 跑測試、設計師可以叫 Agent 調 CSS。這是 Agent 民主化的一步。
Rust 用於 Agent Harness 的合理性：Agent harness 需要處理 WebSocket（Discord Gateway）+ stdio（ACP）+ 高並發 session pool。Rust 的 tokio async runtime + 零成本抽象在這裡有實際優勢，特別是部署在 Kubernetes 上時，記憶體和 CPU 效率直接影響成本。
Emoji 狀態反應是低成本但高價值的 UX 設計：OpenAB 用 emoji reaction 即時呈現 Agent 狀態（思考中、呼叫工具中、寫程式碼中），讓使用者不用等到完整回覆就能知道 Agent 在做什麼。這個模式值得在其他 Agent 介面中借鏡。
OpenAB vs OpenACP 反映兩種設計哲學：OpenAB 選擇「做好一件事」（Rust、Discord only、輕量），OpenACP 選擇「做所有事」（Node.js、3 平台、28+ agent、Plugin 系統）。兩者都有市場，但 OpenAB 的 Helm chart + K8s 原生設計更適合企業團隊部署。
Voice STT 讓 Coding Agent 進入「語音指揮」模式：結合 Discord 語音訊息 + Groq 免費 Whisper API，開發者可以用語音描述需求，OpenAB 自動轉文字交給 Agent 執行。這與 Boris Cherny 推薦的 /voice 模式異曲同工——語音比打字快 3x，且 prompt 更詳細。支援本地 Whisper server 則滿足了資料不離開企業網路的合規需求。
Multi-Agent Helm 部署的實用價值：單一 Helm release 同時跑 Kiro + Claude + Codex + Gemini，每個 Agent 獨立 Pod 和頻道。團隊可以在 Discord 設立不同頻道分別使用不同 Agent，讓成員根據任務特性選擇最適合的 Agent——這是 vendor-neutral 策略的具體實踐。

與其他專案的關聯¶

OpenClaw / OpenClaw Claude Proxy：OpenAB 的 StatusReactionController 直接受 OpenClaw 啟發，同屬 ACP 生態系的不同切面
Agent Orchestrator / Dispatch：OpenAB 是「聊天介面→Agent」的橋接，Dispatch 是「Agent→Agent」的協作——兩者可以組合使用
Claude Agent SDK：OpenAB 使用 claude-agent-acp adapter 連接 Claude Code，底層依賴 Claude 的 ACP 實作
sample-acp-bridge（AWS）：OpenAB 的直接靈感來源，ACP protocol + process pool 架構從此衍生