OpenAB Kiro

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

このテンプレートは Kiro バリアントをデプロイし、ベース openab イメージと kiro-cli をエージェントバックエンドとして使用します。

注意事項

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

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

3. Kiro API Key の取得（Pro/Pro+/Power プランのみ）

有料の Kiro サブスクリプションをお持ちの場合、kiro.dev → Settings → API Keys で key を作成し、KIRO_API_KEY 変数に入力してください。サービスが自動的に認証されるため、デプロイ後の手動操作は不要です。

無料プランのユーザーは KIRO_API_KEY を空のままにし、デプロイ後にステップ 5 で認証してください。

4. デプロイ

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

5. Device Flow で Kiro を認証（無料プランのみ）

ステップ 3 で KIRO_API_KEY を入力した場合はこのステップをスキップしてください。

サービスが起動した後、Zeabur Dashboard でサービスターミナルを開き、以下を実行：

HOME=/home/agent kiro-cli login --use-device-flow

⚠️ agent ユーザーで実行する必要があります。root で実行すると認証ファイルが /root/ に書き込まれ、永続化されないため再起動時に失われます。

画面に表示される URL とコードをブラウザで開いて認証を完了してください。認証後はサービスを再起動してください。

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 は永続的な Kiro session に対応（デフォルト 24 時間 TTL）

カスタマイズ

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

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

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

無効化

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

リンク

• OpenAB GitHub
• Agent Client Protocol