logo
icon

OpenAB Claude

Open Agent Broker — stdio JSON-RPC を通じて Discord と Slack を ACP 対応の coding CLI(Claude Code、Codex、Gemini、Kiro)にブリッジする軽量な Rust ハーネス。 ソース:https://github.com/openabdev/openab

template cover
展開済み57
発行者zeaburZeabur
作成日2026-04-10
最小構成2 コア4 GB
推奨構成4 コア8 GB
タグ
AIDeveloper ToolsDiscordSlack

OpenAB

OpenAB は、stdio JSON-RPC を通じて Discord を Agent Client Protocol 対応の coding CLI にブリッジする軽量なオープンソース Rust ハーネスです。

このテンプレートは Claude バリアント(openab-claude)をデプロイし、claude-agent-acp をエージェントバックエンドとして使用します。

注意事項

  • イメージタグ: このテンプレートは固定バージョン(0.8.3-beta.4)を使用しています。アップグレードするには、Zeabur Dashboard → サービス → 設定でイメージタグを変更してください。利用可能なタグ:GitHub Packages
  • 永続ストレージ: /home/node が永続ボリュームとしてマウントされます。プラグイン、設定、config、認証情報は再起動後も保持されます。
  • ファイル権限: コンテナは root で起動し、openab 実行前に node ユーザー(uid 1000)に切り替わります。権限の問題が発生した場合、サービスを再起動してください — 起動時に自動的に権限が修正されます。

セットアップ

1. Discord Bot Token の取得

  1. https://discord.com/developers/applications にアクセスし、New Application をクリック
  2. Bot タブ → Reset Token をクリック → token をコピー
  3. 同じページを下にスクロールし、Privileged Gateway Intents の Message Content Intent を有効化
  4. OAuth2 → URL Generator → scope bot にチェック → 権限にチェック:Send Messages、Send Messages in Threads、Create Public Threads、Read Message History、Add Reactions、Manage Messages
  5. 生成された URL をコピーし、ブラウザで開いて Bot をサーバーに招待

2. 認証方法を選択(オプション — 空のままにするとコンテナ内ログインが可能)

方法使用方法
Anthropic API Keyconsole.anthropic.com/settings/keys → Create Key → sk-ant-api... キーを OPENAB_AUTH_TOKEN に貼り付け
Zeabur AI Hub TokenZeabur 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 → サービス → Execrunuser -u node -- claude auth login(または claude setup-token)を実行。認証情報は永続ボリュームの /home/node/.claude/ に書き込まれ、再起動後も保持されます。

トークンを agent に渡す: openab は env_clear() で agent サブプロセスを分離するため、方法 1–3 では初回起動後に /home/node/.config/openab/config.toml を編集し、[agent] セクションに env allowlist(または明示的な env マップ)を追加する必要があります:

[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 の取得

  1. Discord を開く → ユーザー設定(歯車アイコン)→ 詳細設定開発者モード を有効化
  2. Bot に応答させたいチャンネルを右クリック → チャンネル ID をコピー
  3. 複数チャンネルはカンマで区切る:123456789012345678,234567890123456789

4. デプロイ

変数を入力してデプロイをクリック。サービスは自動的に Discord および/または Slack に接続します。

Slack セットアップ(オプション)

OpenAB は Socket Mode 経由で Slack をサポートします — 公開 URL は不要です。

  1. https://api.slack.com/appsCreate New AppFrom scratch
  2. Socket Mode → 有効化 → scope connections:write で App-Level Token を生成 → xapp-... token をコピー(SLACK_APP_TOKEN
  3. Event Subscriptions → 有効化 → bot events を追加:app_mentionmessage.channelsmessage.groups
  4. OAuth & Permissions → Bot Token Scopes → 追加:app_mentions:readchat:writechannels:historygroups:historychannels:readgroups:readreactions:writefiles:readusers:read
  5. Install App → ワークスペースにインストール → xoxb-... token をコピー(SLACK_BOT_TOKEN
  6. Bot を使用したい各 Slack チャンネルで /invite @YourAppName を実行

デプロイ前に SLACK_BOT_TOKENSLACK_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 = telegramlinefeishugooglechatteams のいずれか

サービスを再起動すると、起動スクリプトが config.toml[gateway] セクションを自動追加します。

使い方

  • 許可された Discord または Slack チャンネルで Bot を @mention して会話を開始
  • OpenAB は自動的に thread を作成してマルチターン会話を行います — 以降のメッセージでは @mention 不要
  • 各 thread は永続的な Claude session に対応(デフォルト 24 時間 TTL)

カスタマイズ

ファイル説明
/home/node/CLAUDE.mdエージェント指示 — Claude が毎セッション自動的に読み込みます
/home/node/.config/openab/config.tomlOpenAB 設定(sessions、reactions、STT など)
/etc/claude-code/managed-settings.jsonClaude Code 権限モード

config.toml は初回起動時に内蔵テンプレートから作成されます。以降の変更はファイルを直接編集してください。環境変数は初期設定時のみ使用されます。デフォルトに戻すにはファイルを削除して再起動:rm /home/node/.config/openab/config.toml

設定オプションは OpenAB ドキュメント を参照。

無効化

デプロイ時に Discord Bot Token を空にしてください。サービスはクラッシュせずスリープ状態になります。

リンク