OpenAB Codex

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

このテンプレートは Codex バリアント（openab-codex）をデプロイし、codex-acp をエージェントバックエンドとして使用します。

注意事項

• イメージタグ： このテンプレートは固定バージョン（0.8.1-beta.5）を使用します。アップグレードするには、Zeabur Dashboard → サービス → 設定でイメージタグを変更してください。利用可能なタグ：GitHub Packages。
• 永続ストレージ： /home/node が永続ボリュームとしてマウントされます。プラグイン、設定、config、認証情報は再起動後も保持されます。
• ファイル権限： コンテナは 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. 認証（いずれか一つ）

方法 A：OpenAI API Key（トークン課金 — 料金を確認）

1. platform.openai.com/api-keys にアクセス
2. Create new secret key をクリック → キーをコピー
3. デプロイ時に OpenAI API Key に入力
4. サービスの初回起動時に codex login --with-api-key が自動実行されます — 手動操作不要

方法 B：ChatGPT サブスクリプション（Plus/Pro/Business — 使用量はプランに含まれます）

1. デプロイ時に OpenAI API Key を空のまま
2. サービス起動後、Zeabur Dashboard → サービス → Exec
3. Exec ターミナルは root で開きます。認証情報を正しい場所に保存するため HOME を指定して実行：

   HOME=/home/node codex login --device-auth
   

4. ターミナルに表示された URL を開き、ChatGPT アカウントで認証
5. Dashboard からサービスを再起動
6. 認証情報は永続ボリューム /home/node/.codex/auth.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/apps → Create New App → From scratch
2. Socket Mode → 有効化 → scope connections:write で App-Level Token を生成 → xapp-... token をコピー（SLACK_APP_TOKEN）
3. Event Subscriptions → 有効化 → bot events を追加：app_mention、message.channels、message.groups
4. OAuth & Permissions → Bot Token Scopes → 追加：app_mentions:read、chat:write、channels:history、groups:history、channels:read、groups:read、reactions:write、files:read、users:read
5. Install App → ワークスペースにインストール → xoxb-... token をコピー（SLACK_BOT_TOKEN）
6. Bot を使用したい各 Slack チャンネルで /invite @YourAppName を実行

デプロイ前に SLACK_BOT_TOKEN と SLACK_APP_TOKEN 変数を入力してください。Discord と Slack は同時に使用できます。

使い方

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

カスタマイズ

ファイル	説明
/home/node/.config/openab/config.toml	OpenAB 設定（sessions、reactions、STT など）

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

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

無効化

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

リンク

• OpenAB GitHub
• Agent Client Protocol
• OpenAI Platform