--- read_when: - Discord チャンネル機能に取り組む summary: Discord ボットの対応状況、機能、設定 title: Discord x-i18n: generated_at: "2026-07-03T02:41:59Z" model: gpt-5.5 postprocess_version: locale-links-v1 provider: openai source_hash: b7e8724b02baa1a2dba1ac932e20533c9293b6021f30b1a79107349c34f195e5 source_path: channels/discord.md workflow: 16 --- 公式 Discord Gateway 経由で DM と guild channel を利用できます。 Discord DM はデフォルトでペアリングモードになります。 ネイティブコマンドの動作とコマンドカタログ。 チャンネル横断の診断と修復フロー。 ## クイックセットアップ ボット付きの新しいアプリケーションを作成し、そのボットをサーバーに追加して、OpenClaw とペアリングする必要があります。自分専用のプライベートサーバーにボットを追加することを推奨します。まだサーバーがない場合は、[先に作成](https://support.discord.com/hc/en-us/articles/204849977-How-do-I-create-a-server)してください（**Create My Own > For me and my friends** を選択）。 [Discord Developer Portal](https://discord.com/developers/applications) に移動し、**New Application** をクリックします。"OpenClaw" のような名前を付けます。 サイドバーで **Bot** をクリックします。**Username** を、OpenClaw エージェントに付けたい名前に設定します。 引き続き **Bot** ページで、**Privileged Gateway Intents** まで下にスクロールし、次を有効にします。 - **Message Content Intent**（必須） - **Server Members Intent**（推奨。ロール許可リストと名前から ID への照合に必要） - **Presence Intent**（任意。プレゼンス更新にのみ必要） **Bot** ページの上部に戻り、**Reset Token** をクリックします。 名前に反して、これは最初のトークンを生成します。「リセット」されるものはありません。 トークンをコピーし、どこかに保存します。これが **Bot Token** で、すぐに必要になります。 サイドバーで **OAuth2** をクリックします。ボットをサーバーに追加するための適切な権限を持つ招待 URL を生成します。 **OAuth2 URL Generator** まで下にスクロールし、次を有効にします。 - `bot` - `applications.commands` 下に **Bot Permissions** セクションが表示されます。少なくとも次を有効にします。 **General Permissions** - チャンネルを表示 **Text Permissions** - メッセージを送信 - メッセージ履歴を読む - リンクを埋め込む - ファイルを添付 - リアクションを追加（任意） これは通常のテキストチャンネル向けの基本セットです。スレッドを作成または継続するフォーラムやメディアチャンネルのワークフローを含め、Discord スレッドに投稿する予定がある場合は、**Send Messages in Threads** も有効にします。 下部に生成された URL をコピーし、ブラウザに貼り付けてサーバーを選択し、**Continue** をクリックして接続します。これで Discord サーバー内にボットが表示されるはずです。 Discord アプリに戻り、内部 ID をコピーできるように Developer Mode を有効にする必要があります。 1. **User Settings**（アバター横の歯車アイコン）をクリック → サイドバーの **Developer** までスクロール → **Developer Mode** をオンにする *(注: Discord モバイルアプリでは、Developer Mode は **App Settings** → **Advanced** の下にあります)* 2. サイドバーの **サーバーアイコン** を右クリック → **Copy Server ID** 3. **自分のアバター** を右クリック → **Copy User ID** **Server ID** と **User ID** を Bot Token と一緒に保存します。次のステップで、この 3 つをすべて OpenClaw に送信します。 ペアリングを機能させるには、Discord がボットからあなたへの DM を許可する必要があります。**サーバーアイコン** を右クリック → **Privacy Settings** → **Direct Messages** をオンにします。 これにより、サーバーメンバー（ボットを含む）があなたに DM を送信できます。OpenClaw で Discord DM を使いたい場合は、これを有効にしたままにします。guild channel のみを使う予定なら、ペアリング後に DM を無効にできます。 Discord ボットトークンは（パスワードのような）シークレットです。エージェントにメッセージを送る前に、OpenClaw を実行しているマシンで設定します。 ```bash export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN" cat > discord.patch.json5 <<'JSON5' { channels: { discord: { enabled: true, token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" }, }, }, } JSON5 openclaw config patch --file ./discord.patch.json5 --dry-run openclaw config patch --file ./discord.patch.json5 openclaw gateway ``` OpenClaw がすでにバックグラウンドサービスとして実行中の場合は、OpenClaw Mac アプリから、または `openclaw gateway run` プロセスを停止して再起動することで再起動します。 管理サービスとしてインストールしている場合は、`DISCORD_BOT_TOKEN` が存在するシェルから `openclaw gateway install` を実行するか、その変数を `~/.openclaw/.env` に保存して、再起動後にサービスが env SecretRef を解決できるようにします。 ホストが Discord の起動時アプリケーション検索でブロックまたはレート制限される場合は、Developer Portal から Discord アプリケーション/クライアント ID を設定して、起動時にその REST 呼び出しをスキップできるようにします。デフォルトアカウントには `channels.discord.applicationId` を使い、複数の Discord ボットを実行する場合は `channels.discord.accounts..applicationId` を使います。 既存の任意のチャンネル（例: Telegram）で OpenClaw エージェントとチャットし、次のように伝えます。Discord が最初のチャンネルの場合は、代わりに CLI / config タブを使います。 > 「Discord ボットトークンはすでに config に設定しました。User ID `` と Server ID `` で Discord セットアップを完了してください。」 ファイルベースの config を使いたい場合は、次を設定します。 ```json5 { channels: { discord: { enabled: true, token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN", }, }, }, } ``` デフォルトアカウントの env fallback: ```bash DISCORD_BOT_TOKEN=... ``` スクリプト化またはリモートセットアップでは、同じ JSON5 ブロックを `openclaw config patch --file ./discord.patch.json5 --dry-run` で書き込み、その後 `--dry-run` なしで再実行します。平文の `token` 値もサポートされています。SecretRef 値も、env/file/exec provider 全体で `channels.discord.token` に対応しています。[Secrets Management](/ja-JP/gateway/secrets) を参照してください。 複数の Discord ボットでは、各ボットトークンとアプリケーション ID をそれぞれのアカウント配下に保持します。トップレベルの `channels.discord.applicationId` はアカウントに継承されるため、すべてのアカウントが同じアプリケーション ID を使う場合にのみ、そこに設定します。 ```json5 { channels: { discord: { enabled: true, accounts: { personal: { token: { source: "env", provider: "default", id: "DISCORD_PERSONAL_TOKEN" }, applicationId: "111111111111111111", }, work: { token: { source: "env", provider: "default", id: "DISCORD_WORK_TOKEN" }, applicationId: "222222222222222222", }, }, }, }, } ``` Gateway が実行されるまで待ってから、Discord でボットに DM を送信します。ボットはペアリングコードを返します。 既存のチャンネルでペアリングコードをエージェントに送信します。 > 「この Discord ペアリングコードを承認してください: ``」 ```bash openclaw pairing list discord openclaw pairing approve discord ``` ペアリングコードは 1 時間後に期限切れになります。 これで、Discord の DM 経由でエージェントとチャットできるはずです。 トークン解決はアカウントを認識します。Config のトークン値は env fallback より優先されます。`DISCORD_BOT_TOKEN` はデフォルトアカウントにのみ使用されます。 有効な 2 つの Discord アカウントが同じボットトークンに解決される場合、OpenClaw はそのトークンに対して 1 つの Gateway モニターだけを開始します。config 由来のトークンはデフォルトの env fallback より優先されます。それ以外の場合は、最初の有効なアカウントが優先され、重複アカウントは無効として報告されます。 高度な outbound 呼び出し（メッセージツール/チャンネルアクション）では、呼び出しごとの明示的な `token` がその呼び出しに使われます。これは送信と read/probe-style アクション（例: read/search/fetch/thread/pins/permissions）に適用されます。アカウントポリシー/リトライ設定は、引き続きアクティブなランタイムスナップショットで選択されたアカウントから取得されます。 ## 推奨: guild ワークスペースをセットアップする DM が動作したら、Discord サーバーを完全なワークスペースとしてセットアップできます。各チャンネルには、それぞれ独自のコンテキストを持つエージェントセッションが割り当てられます。これは、自分とボットだけのプライベートサーバーに推奨されます。 これにより、エージェントは DM だけでなく、サーバー上の任意のチャンネルで応答できるようになります。 > 「Discord Server ID `` を guild 許可リストに追加してください」 ```json5 { channels: { discord: { groupPolicy: "allowlist", guilds: { YOUR_SERVER_ID: { requireMention: true, users: ["YOUR_USER_ID"], }, }, }, }, } ``` デフォルトでは、エージェントは guild channel で @mentioned された場合にのみ応答します。プライベートサーバーでは、おそらくすべてのメッセージに応答させたいはずです。 guild channel では、通常の返信はデフォルトで自動投稿されます。共有の常時オンの部屋では、`messages.groupChat.visibleReplies: "message_tool"` を有効にすると、エージェントは待機し、チャンネル返信が有用だと判断した場合にのみ投稿できます。これは GPT 5.5 のような、最新世代でツール信頼性の高いモデルと最も相性が良いです。環境的なルームイベントは、ツールが送信しない限り静かなままです。完全な待機モード config については、[Ambient room events](/ja-JP/channels/ambient-room-events) を参照してください。 Discord に typing が表示され、ログにトークン使用量が表示されるのにメッセージが投稿されない場合は、そのターンが環境的なルームイベントとして設定されていたか、message-tool visible replies にオプトインしていたかを確認してください。 > 「@mentioned されなくても、このサーバーでエージェントが応答できるようにしてください」 guild config で `requireMention: false` を設定します。 ```json5 { channels: { discord: { guilds: { YOUR_SERVER_ID: { requireMention: false, }, }, }, }, } ``` 表示されるグループ/チャンネル返信に message-tool 送信を要求するには、`messages.groupChat.visibleReplies: "message_tool"` を設定します。 デフォルトでは、長期メモリ（MEMORY.md）は DM セッションでのみ読み込まれます。guild channel は MEMORY.md を自動読み込みしません。 > 「Discord チャンネルで質問したとき、MEMORY.md から長期コンテキストが必要な場合は memory_search または memory_get を使ってください。」 すべてのチャンネルで共有コンテキストが必要な場合は、安定した指示を `AGENTS.md` または `USER.md` に入れます（これらはすべてのセッションに注入されます）。長期的なメモは `MEMORY.md` に保持し、必要に応じて memory tools でアクセスします。 次に、Discord サーバーにいくつかのチャンネルを作成してチャットを始めます。エージェントはチャンネル名を確認でき、各チャンネルには独立したセッションが割り当てられます。そのため、`#coding`、`#home`、`#research` など、ワークフローに合うものをセットアップできます。 ## ランタイムモデル - Gateway が Discord 接続を所有します。 - 返信ルーティングは決定的です。Discord からの受信返信は Discord に戻ります。 - Discord のギルド/チャンネルメタデータは、ユーザーに見える返信プレフィックスではなく、信頼されない コンテキストとしてモデルプロンプトに追加されます。モデルがそのエンベロープを 返信にコピーした場合、OpenClaw は送信返信と 将来のリプレイコンテキストから、コピーされたメタデータを取り除きます。 - デフォルトでは（`session.dmScope=main`）、ダイレクトチャットはエージェントのメインセッション（`agent:main:main`）を共有します。 - ギルドチャンネルは分離されたセッションキーです（`agent::discord:channel:`）。 - グループ DM はデフォルトで無視されます（`channels.discord.dm.groupEnabled=false`）。 - ネイティブのスラッシュコマンドは分離されたコマンドセッション（`agent::discord:slash:`）で実行されますが、ルーティング先の会話セッションへ `CommandTargetSessionKey` も引き続き渡します。 - Discord へのテキストのみの Cron/Heartbeat 告知配信では、最後の アシスタントから見える回答を 1 回使用します。メディアと構造化コンポーネントペイロードは、 エージェントが複数の配信可能ペイロードを発行した場合、複数メッセージのままです。 ## フォーラムチャンネル Discord のフォーラムチャンネルとメディアチャンネルはスレッド投稿のみを受け付けます。OpenClaw はそれらを作成する 2 つの方法をサポートします。 - フォーラム親（`channel:`）にメッセージを送信して、スレッドを自動作成します。スレッドタイトルには、メッセージの最初の空でない行が使用されます。 - `openclaw message thread create` を使用して、スレッドを直接作成します。フォーラムチャンネルでは `--message-id` を渡さないでください。 例: フォーラム親に送信してスレッドを作成する ```bash openclaw message send --channel discord --target channel: \ --message "Topic title\nBody of the post" ``` 例: フォーラムスレッドを明示的に作成する ```bash openclaw message thread create --channel discord --target channel: \ --thread-name "Topic title" --message "Body of the post" ``` フォーラム親は Discord コンポーネントを受け付けません。コンポーネントが必要な場合は、スレッド自体（`channel:`）に送信してください。 ## インタラクティブコンポーネント OpenClaw はエージェントメッセージ用の Discord components v2 containers をサポートします。`components` ペイロードを指定してメッセージツールを使用します。インタラクション結果は通常の受信メッセージとしてエージェントにルーティングされ、既存の Discord `replyToMode` 設定に従います。 サポートされるブロック: - `text`, `section`, `separator`, `actions`, `media-gallery`, `file` - アクション行では最大 5 個のボタン、または 1 個のセレクトメニューを使用できます - セレクトタイプ: `string`, `user`, `role`, `mentionable`, `channel` デフォルトでは、コンポーネントは 1 回だけ使用できます。ボタン、セレクト、フォームを期限切れまで複数回使用できるようにするには、`components.reusable=true` を設定します。 ボタンをクリックできるユーザーを制限するには、そのボタンに `allowedUsers` を設定します（Discord ユーザー ID、タグ、または `*`）。設定されている場合、一致しないユーザーには一時的な拒否が返されます。 コンポーネントコールバックはデフォルトで 30 分後に期限切れになります。デフォルトの Discord アカウントのコールバックレジストリの有効期間を変更するには `channels.discord.agentComponents.ttlMs` を設定し、マルチアカウント設定で 1 つのアカウントを上書きするには `channels.discord.accounts..agentComponents.ttlMs` を設定します。値はミリ秒で、正の整数である必要があり、`86400000`（24 時間）を上限とします。長い TTL は、ボタンを使用可能なままにする必要があるレビューや承認ワークフローに役立ちますが、古い Discord メッセージが引き続きアクションをトリガーできる期間も延長します。ワークフローに合う最短の TTL を優先し、古いコールバックが予想外になる場合はデフォルトのままにしてください。 `/model` と `/models` スラッシュコマンドは、プロバイダー、モデル、互換性のあるランタイムのドロップダウンと送信ステップを備えたインタラクティブなモデルピッカーを開きます。`/models add` は非推奨であり、チャットからモデルを登録する代わりに非推奨メッセージを返すようになりました。ピッカーの返信は一時的で、呼び出したユーザーだけが使用できます。Discord セレクトメニューは 25 個のオプションに制限されているため、`openai` や `vllm` などの選択したプロバイダーについてのみ動的に検出されたモデルをピッカーに表示したい場合は、`agents.defaults.models` に `provider/*` エントリを追加してください。 ファイル添付: - `file` ブロックは添付参照（`attachment://`）を指している必要があります - `media`/`path`/`filePath`（単一ファイル）で添付を指定します。複数ファイルには `media-gallery` を使用します - アップロード名を添付参照と一致させる必要がある場合は、`filename` を使用して上書きします モーダルフォーム: - 最大 5 個のフィールドを持つ `components.modal` を追加します - フィールドタイプ: `text`, `checkbox`, `radio`, `select`, `role-select`, `user-select` - OpenClaw はトリガーボタンを自動的に追加します 例: ```json5 { channel: "discord", action: "send", to: "channel:123456789012345678", message: "Optional fallback text", components: { reusable: true, text: "Choose a path", blocks: [ { type: "actions", buttons: [ { label: "Approve", style: "success", allowedUsers: ["123456789012345678"], }, { label: "Decline", style: "danger" }, ], }, { type: "actions", select: { type: "string", placeholder: "Pick an option", options: [ { label: "Option A", value: "a" }, { label: "Option B", value: "b" }, ], }, }, ], modal: { title: "Details", triggerLabel: "Open form", fields: [ { type: "text", label: "Requester" }, { type: "select", label: "Priority", options: [ { label: "Low", value: "low" }, { label: "High", value: "high" }, ], }, ], }, }, } ``` ## アクセス制御とルーティング `channels.discord.dmPolicy` は DM アクセスを制御します。`channels.discord.allowFrom` は正規の DM 許可リストです。 - `pairing`（デフォルト） - `allowlist` - `open`（`channels.discord.allowFrom` に `"*"` が含まれている必要があります） - `disabled` DM ポリシーが open でない場合、不明なユーザーはブロックされます（または `pairing` モードではペアリングを促されます）。 マルチアカウントの優先順位: - `channels.discord.accounts.default.allowFrom` は `default` アカウントにのみ適用されます。 - 1 つのアカウントでは、`allowFrom` が従来の `dm.allowFrom` より優先されます。 - 名前付きアカウントは、自身の `allowFrom` と従来の `dm.allowFrom` が未設定の場合、`channels.discord.allowFrom` を継承します。 - 名前付きアカウントは `channels.discord.accounts.default.allowFrom` を継承しません。 従来の `channels.discord.dm.policy` と `channels.discord.dm.allowFrom` は互換性のため引き続き読み取られます。`openclaw doctor --fix` は、アクセスを変更せずに実行できる場合、それらを `dmPolicy` と `allowFrom` に移行します。 配信用の DM ターゲット形式: - `user:` - `<@id>` メンション チャンネルのデフォルトが有効な場合、裸の数値 ID は通常チャンネル ID として解決されますが、アカウントの有効な DM `allowFrom` に含まれる ID は互換性のためユーザー DM ターゲットとして扱われます。 Discord DM とテキストコマンド認可では、`channels.discord.allowFrom` 内の動的な `accessGroup:` エントリを使用できます。 アクセスグループ名はメッセージチャンネル間で共有されます。メンバーを各チャンネルの通常の `allowFrom` 構文で表す静的グループには `type: "message.senders"` を使用し、Discord チャンネルの現在の `ViewChannel` オーディエンスによってメンバーシップを動的に定義する必要がある場合は `type: "discord.channelAudience"` を使用します。共有アクセスグループの動作はこちらに記載されています: [アクセスグループ](/ja-JP/channels/access-groups) ```json5 { accessGroups: { operators: { type: "message.senders", members: { "*": ["global-owner-id"], discord: ["discord:123456789012345678"], telegram: ["987654321"], }, }, }, channels: { discord: { dmPolicy: "allowlist", allowFrom: ["accessGroup:operators"], }, }, } ``` Discord テキストチャンネルには別個のメンバーリストがありません。`type: "discord.channelAudience"` はメンバーシップを次のようにモデル化します。DM 送信者は設定されたギルドのメンバーであり、ロールとチャンネル上書きが適用された後、設定されたチャンネルに対して現在有効な `ViewChannel` 権限を持っています。 例: DMs は他の全員に対して閉じたまま、`#maintainers` を見られる全員にボットへの DM を許可します。 ```json5 { accessGroups: { maintainers: { type: "discord.channelAudience", guildId: "1456350064065904867", channelId: "1456744319972282449", membership: "canViewChannel", }, }, channels: { discord: { dmPolicy: "allowlist", allowFrom: ["accessGroup:maintainers"], }, }, } ``` 動的エントリと静的エントリを混在させることができます。 ```json5 { accessGroups: { maintainers: { type: "discord.channelAudience", guildId: "1456350064065904867", channelId: "1456744319972282449", }, }, channels: { discord: { dmPolicy: "allowlist", allowFrom: ["accessGroup:maintainers", "discord:123456789012345678"], }, }, } ``` ルックアップは失敗時に閉じます。Discord が `Missing Access` を返した場合、メンバールックアップが失敗した場合、またはチャンネルが別のギルドに属している場合、DM 送信者は未認可として扱われます。 チャンネルオーディエンスのアクセスグループを使用する場合は、ボットに対して Discord Developer Portal の **Server Members Intent** を有効にします。DM にはギルドメンバー状態が含まれないため、OpenClaw は認可時に Discord REST を通じてメンバーを解決します。 ギルドの処理は `channels.discord.groupPolicy` によって制御されます。 - `open` - `allowlist` - `disabled` `channels.discord` が存在する場合の安全なベースラインは `allowlist` です。 `allowlist` の動作: - ギルドは `channels.discord.guilds` と一致する必要があります（`id` 推奨、slug も可） - 任意の送信者許可リスト: `users`（安定した ID 推奨）と `roles`（ロール ID のみ）。どちらかが設定されている場合、送信者は `users` または `roles` に一致すると許可されます - 直接の名前/タグ照合はデフォルトで無効です。緊急互換モードとしてのみ `channels.discord.dangerouslyAllowNameMatching: true` を有効にしてください - `users` では名前/タグがサポートされますが、ID の方が安全です。名前/タグエントリが使用されている場合、`openclaw security audit` が警告します - ギルドに `channels` が設定されている場合、一覧にないチャンネルは拒否されます - ギルドに `channels` ブロックがない場合、その許可リスト済みギルド内のすべてのチャンネルが許可されます 例: ```json5 { channels: { discord: { groupPolicy: "allowlist", guilds: { "123456789012345678": { requireMention: true, ignoreOtherMentions: true, users: ["987654321098765432"], roles: ["123456789012345678"], channels: { general: { allow: true }, help: { allow: true, requireMention: true }, }, }, }, }, }, } ``` `DISCORD_BOT_TOKEN` だけを設定し、`channels.discord` ブロックを作成していない場合、`channels.defaults.groupPolicy` が `open` であっても、ランタイムフォールバックは `groupPolicy="allowlist"` になります（ログに警告が出ます）。 ギルドメッセージはデフォルトでメンションゲートされます。 メンション検出には次が含まれます。 - 明示的なボットメンション - 設定されたメンションパターン（`agents.list[].groupChat.mentionPatterns`、フォールバック `messages.groupChat.mentionPatterns`） - サポートされる場合の暗黙的なボットへの返信動作 Discord 送信メッセージを書く場合は、正規のメンション構文を使用してください。ユーザーには `<@USER_ID>`、チャンネルには `<#CHANNEL_ID>`、ロールには `<@&ROLE_ID>` を使用します。従来の `<@!USER_ID>` ニックネームメンション形式は使用しないでください。 `requireMention` はギルド/チャンネルごとに設定されます（`channels.discord.guilds...`）。 `ignoreOtherMentions` は、ボットではなく別のユーザー/ロールにメンションしているメッセージを任意で破棄します（@everyone/@here を除く）。 グループ DM: - デフォルト: 無視（`dm.groupEnabled=false`） - `dm.groupChannels`（チャンネル ID または slug）による任意の許可リスト ### ロールベースのエージェントルーティング `bindings[].match.roles` を使用すると、ロール ID によって Discord ギルドメンバーを別々のエージェントへルーティングできます。ロールベースのバインディングはロール ID のみを受け付け、ピアまたは親ピアのバインディングの後、ギルドのみのバインディングの前に評価されます。バインディングが他の match フィールドも設定している場合（たとえば `peer` + `guildId` + `roles`）、設定されたすべてのフィールドが一致する必要があります。 ```json5 { bindings: [ { agentId: "opus", match: { channel: "discord", guildId: "123456789012345678", roles: ["111111111111111111"], }, }, { agentId: "sonnet", match: { channel: "discord", guildId: "123456789012345678", }, }, ], } ``` ## ネイティブコマンドとコマンド認可 - `commands.native` のデフォルトは `"auto"` で、Discord では有効です。 - チャンネルごとの上書き: `channels.discord.commands.native`。 - `commands.native=false` は起動時の Discord スラッシュコマンド登録とクリーンアップをスキップします。以前に登録されたコマンドは、Discord アプリから削除するまで Discord に表示されたままになる場合があります。 - ネイティブコマンド認可は、通常のメッセージ処理と同じ Discord 許可リスト/ポリシーを使用します。 - 認可されていないユーザーにも、Discord UI ではコマンドが表示される場合があります。実行時には引き続き OpenClaw 認可が強制され、"not authorized" が返されます。 コマンドカタログと動作については、[スラッシュコマンド](/ja-JP/tools/slash-commands) を参照してください。 デフォルトのスラッシュコマンド設定: - `ephemeral: true` ## 機能の詳細 Discord はエージェント出力内の返信タグをサポートします。 - `[[reply_to_current]]` - `[[reply_to:]]` `channels.discord.replyToMode` で制御します。 - `off`（デフォルト） - `first` - `all` - `batched` 注: `off` は暗黙的な返信スレッド化を無効にします。明示的な `[[reply_to_*]]` タグは引き続き尊重されます。 `first` は、そのターンの最初の送信 Discord メッセージに、暗黙的なネイティブ返信参照を常に付与します。 `batched` は、受信イベントが複数メッセージのデバウンス済みバッチだった場合にのみ、Discord の暗黙的なネイティブ返信参照を付与します。これは、すべての単一メッセージターンではなく、主に曖昧で突発的なチャットにネイティブ返信を使いたい場合に便利です。 メッセージ ID はコンテキスト/履歴に表示されるため、エージェントは特定のメッセージを対象にできます。 Discord はデフォルトで URL のリッチリンク埋め込みを生成します。OpenClaw は、送信 Discord メッセージで生成されるそれらの埋め込みをデフォルトで抑制するため、明示的に有効化しない限り、エージェントが送信した URL はプレーンリンクのままになります。 ```json5 { channels: { discord: { suppressEmbeds: false, }, }, } ``` 1 つのアカウントを上書きするには、`channels.discord.accounts..suppressEmbeds` を設定します。エージェントのメッセージツール送信でも、単一メッセージに対して `suppressEmbeds: false` を渡せます。明示的な Discord `embeds` ペイロードは、デフォルトのリンクプレビュー設定では抑制されません。 OpenClaw は、一時メッセージを送信し、テキストの到着に合わせて編集することで、下書き返信をストリーミングできます。`channels.discord.streaming` は `off` | `partial` | `block` | `progress`（デフォルト）を受け取ります。`progress` は編集可能なステータス下書きを 1 つ維持し、最終配信までツール進行状況で更新します。共有スターターラベルは流れる行なので、十分な作業が表示されると他の内容と同じようにスクロールして消えます。`streamMode` はレガシーランタイムエイリアスです。永続化された設定を正規キーへ書き換えるには、`openclaw doctor --fix` を実行してください。 Discord プレビュー編集を無効にするには、`channels.discord.streaming.mode` を `off` に設定します。Discord ブロックストリーミングが明示的に有効な場合、OpenClaw は二重ストリーミングを避けるためにプレビューストリームをスキップします。 ```json5 { channels: { discord: { streaming: { mode: "progress", progress: { label: "auto", maxLines: 8, maxLineChars: 120, toolProgress: true, commentary: false, }, }, }, }, } ``` - `partial` は、トークンが到着するたびに単一のプレビューメッセージを編集します。 - `block` は下書きサイズのチャンクを出力します（サイズとブレークポイントの調整には `draftChunk` を使用し、`textChunkLimit` に制限されます）。 - メディア、エラー、明示的返信の最終結果は、保留中のプレビュー編集をキャンセルします。 - `streaming.preview.toolProgress`（デフォルト `true`）は、ツール/進行状況の更新がプレビューメッセージを再利用するかどうかを制御します。 - ツール/進行状況行は、利用可能な場合、コンパクトな絵文字 + タイトル + 詳細として表示されます。例: `🛠️ Bash: run tests` または `🔎 Web Search: for "query"`。 - `streaming.progress.commentary`（デフォルト `false`）は、一時的な進行状況下書きにアシスタントのコメント/前置きテキストを含めます。コメントは表示前にクリーンアップされ、一時的なままで、最終回答の配信は変更しません。 - `streaming.progress.maxLineChars` は、行ごとの進行状況プレビュー予算を制御します。文章は単語境界で短縮され、コマンドとパスの詳細は有用な接尾部を維持します。 - `streaming.preview.commandText` / `streaming.progress.commandText` は、コンパクトな進行状況行のコマンド/実行詳細を制御します: `raw`（デフォルト）または `status`（ツールラベルのみ）。 コンパクトな進行状況行を維持しながら、生のコマンド/実行テキストを非表示にします。 ```json { "channels": { "discord": { "streaming": { "mode": "progress", "progress": { "toolProgress": true, "commandText": "status" } } } } } ``` プレビューストリーミングはテキストのみです。メディア返信は通常配信にフォールバックします。`block` ストリーミングが明示的に有効な場合、OpenClaw は二重ストリーミングを避けるためにプレビューストリームをスキップします。 ギルド履歴コンテキスト: - `channels.discord.historyLimit` デフォルト `20` - フォールバック: `messages.groupChat.historyLimit` - `0` で無効化 DM 履歴制御: - `channels.discord.dmHistoryLimit` - `channels.discord.dms[""].historyLimit` スレッド動作: - Discord スレッドはチャンネルセッションとしてルーティングされ、上書きされない限り親チャンネル設定を継承します。 - スレッドセッションは、モデルのみのフォールバックとして、親チャンネルのセッションレベルの `/model` 選択を継承します。スレッドローカルの `/model` 選択は引き続き優先され、トランスクリプト継承が有効でない限り、親トランスクリプト履歴はコピーされません。 - `channels.discord.thread.inheritParent`（デフォルト `false`）は、新しい自動スレッドで親トランスクリプトからのシードを有効にします。アカウントごとの上書きは `channels.discord.accounts..thread.inheritParent` 配下にあります。 - メッセージツールのリアクションは `user:` DM ターゲットを解決できます。 - `guilds..channels..requireMention: false` は、返信段階のアクティベーションフォールバック中も保持されます。 チャンネルトピックは**信頼されていない**コンテキストとして注入されます。許可リストは、エージェントをトリガーできるユーザーを制限するものであり、完全な補足コンテキストの秘匿境界ではありません。 Discord はスレッドをセッションターゲットにバインドできるため、そのスレッド内の後続メッセージは同じセッション（サブエージェントセッションを含む）へルーティングされ続けます。 コマンド: - `/focus ` 現在/新規スレッドをサブエージェント/セッションターゲットにバインド - `/unfocus` 現在のスレッドバインディングを削除 - `/agents` アクティブな実行とバインディング状態を表示 - `/session idle ` フォーカスされたバインディングの非アクティブ時自動フォーカス解除を確認/更新 - `/session max-age ` フォーカスされたバインディングの厳格な最大経過時間を確認/更新 設定: ```json5 { session: { threadBindings: { enabled: true, idleHours: 24, maxAgeHours: 0, }, }, channels: { discord: { threadBindings: { enabled: true, idleHours: 24, maxAgeHours: 0, spawnSessions: true, defaultSpawnContext: "fork", }, }, }, } ``` 注: - `session.threadBindings.*` はグローバルデフォルトを設定します。 - `channels.discord.threadBindings.*` は Discord の動作を上書きします。 - `spawnSessions` は `sessions_spawn({ thread: true })` と ACP スレッドスポーンの自動作成/バインドを制御します。デフォルト: `true`。 - `defaultSpawnContext` は、スレッドバインドされたスポーンのネイティブサブエージェントコンテキストを制御します。デフォルト: `"fork"`。 - 非推奨の `spawnSubagentSessions`/`spawnAcpSessions` キーは `openclaw doctor --fix` によって移行されます。 - アカウントでスレッドバインディングが無効な場合、`/focus` と関連するスレッドバインディング操作は利用できません。 [サブエージェント](/ja-JP/tools/subagents)、[ACP エージェント](/ja-JP/tools/acp-agents)、[設定リファレンス](/ja-JP/gateway/configuration-reference) を参照してください。 安定した「常時稼働」の ACP ワークスペースには、Discord 会話を対象とするトップレベルの型付き ACP バインディングを設定します。 設定パス: - `bindings[]`、`type: "acp"` と `match.channel: "discord"` を指定 例: ```json5 { agents: { list: [ { id: "codex", runtime: { type: "acp", acp: { agent: "codex", backend: "acpx", mode: "persistent", cwd: "/workspace/openclaw", }, }, }, ], }, bindings: [ { type: "acp", agentId: "codex", match: { channel: "discord", accountId: "default", peer: { kind: "channel", id: "222222222222222222" }, }, acp: { label: "codex-main" }, }, ], channels: { discord: { guilds: { "111111111111111111": { channels: { "222222222222222222": { requireMention: false, }, }, }, }, }, }, } ``` 注: - `/acp spawn codex --bind here` は現在のチャンネルまたはスレッドをその場でバインドし、以後のメッセージを同じ ACP セッション上に維持します。スレッドメッセージは親チャンネルバインディングを継承します。 - バインドされたチャンネルまたはスレッドでは、`/new` と `/reset` は同じ ACP セッションをその場でリセットします。一時的なスレッドバインディングは、アクティブな間ターゲット解決を上書きできます。 - `spawnSessions` は `--thread auto|here` による子スレッド作成/バインドを制御します。 バインディング動作の詳細については、[ACP エージェント](/ja-JP/tools/acp-agents) を参照してください。 ギルドごとのリアクション通知モード: - `off` - `own`（デフォルト） - `all` - `allowlist`（`guilds..users` を使用） リアクションイベントはシステムイベントに変換され、ルーティングされた Discord セッションに添付されます。 `ackReaction` は、OpenClaw が受信メッセージを処理している間、確認応答の絵文字を送信します。 解決順序: - `channels.discord.accounts..ackReaction` - `channels.discord.ackReaction` - `messages.ackReaction` - エージェント ID 絵文字フォールバック（`agents.list[].identity.emoji`、なければ "👀"） 注: - Discord は Unicode 絵文字またはカスタム絵文字名を受け付けます。 - チャンネルまたはアカウントのリアクションを無効にするには `""` を使用します。 チャンネル起点の設定書き込みはデフォルトで有効です。 これは `/config set|unset` フロー（コマンド機能が有効な場合）に影響します。 無効化: ```json5 { channels: { discord: { configWrites: false, }, }, } ``` `channels.discord.proxy` を使用して、Discord Gateway WebSocket トラフィックと起動時の REST ルックアップ（アプリケーション ID + 許可リスト解決）を HTTP(S) プロキシ経由でルーティングします。 Discord Gateway WebSocket プロキシは明示的です。WebSocket 接続は Gateway プロセスの環境プロキシ変数を継承しません。起動時の REST ルックアップは、`channels.discord.proxy` が設定されている場合にこのプロキシを使用します。 ```json5 { channels: { discord: { proxy: "http://proxy.example:8080", }, }, } ``` アカウントごとの上書き: ```json5 { channels: { discord: { accounts: { primary: { proxy: "http://proxy.example:8080", }, }, }, }, } ``` PluralKit 解決を有効にして、プロキシされたメッセージをシステムメンバー ID にマッピングします。 ```json5 { channels: { discord: { pluralkit: { enabled: true, token: "pk_live_...", // optional; needed for private systems }, }, }, } ``` 注: - 許可リストでは `pk:` を使用できます - メンバー表示名は、`channels.discord.dangerouslyAllowNameMatching: true` の場合のみ名前/スラッグで照合されます - ルックアップは元のメッセージ ID を使用し、時間枠で制限されます - ルックアップに失敗した場合、プロキシされたメッセージは bot メッセージとして扱われ、`allowBots=true` でない限り破棄されます エージェントが既知の Discord ユーザーに対して決定的な送信メンションを必要とする場合は、`mentionAliases` を使用します。キーは先頭の `@` を除いたハンドルで、値は Discord ユーザー ID です。不明なハンドル、`@everyone`、`@here`、Markdown コードスパン内のメンションは変更されません。 ```json5 { channels: { discord: { mentionAliases: { Vladislava: "123456789012345678", }, accounts: { ops: { mentionAliases: { OpsLead: "234567890123456789", }, }, }, }, }, } ``` ステータスまたはアクティビティフィールドを設定した場合、または自動プレゼンスを有効にした場合に、プレゼンス更新が適用されます。 ステータスのみの例: ```json5 { channels: { discord: { status: "idle", }, }, } ``` アクティビティの例（カスタムステータスがデフォルトのアクティビティタイプです）: ```json5 { channels: { discord: { activity: "Focus time", activityType: 4, }, }, } ``` ストリーミングの例: ```json5 { channels: { discord: { activity: "Live coding", activityType: 1, activityUrl: "https://twitch.tv/openclaw", }, }, } ``` アクティビティタイプの対応表: - 0: プレイ中 - 1: ストリーミング中（`activityUrl` が必要） - 2: 聴取中 - 3: 視聴中 - 4: カスタム（アクティビティテキストをステータス状態として使用します。絵文字は任意です） - 5: 競争中 自動プレゼンスの例（ランタイムヘルスシグナル）: ```json5 { channels: { discord: { autoPresence: { enabled: true, intervalMs: 30000, minUpdateIntervalMs: 15000, exhaustedText: "token exhausted", }, }, }, } ``` 自動プレゼンスはランタイムの可用性を Discord ステータスにマッピングします: healthy => online、degraded または unknown => idle、exhausted または unavailable => dnd。任意のテキスト上書き: - `autoPresence.healthyText` - `autoPresence.degradedText` - `autoPresence.exhaustedText`（`{reason}` プレースホルダーをサポート） Discord は DM でボタンベースの承認処理をサポートし、任意で元のチャンネルに承認プロンプトを投稿できます。 設定パス: - `channels.discord.execApprovals.enabled` - `channels.discord.execApprovals.approvers`（任意。可能な場合は `commands.ownerAllowFrom` にフォールバックします） - `channels.discord.execApprovals.target`（`dm` | `channel` | `both`、デフォルト: `dm`） - `agentFilter`、`sessionFilter`、`cleanupAfterResolve` Discord は、`enabled` が未設定または `"auto"` で、`execApprovals.approvers` または `commands.ownerAllowFrom` のいずれかから少なくとも 1 人の承認者を解決できる場合、ネイティブ実行承認を自動的に有効化します。Discord はチャンネルの `allowFrom`、レガシーの `dm.allowFrom`、またはダイレクトメッセージの `defaultTo` から実行承認者を推測しません。Discord をネイティブ承認クライアントとして明示的に無効化するには、`enabled: false` を設定します。 `/diagnostics` や `/export-trajectory` など、機密性の高い所有者専用グループコマンドでは、OpenClaw は承認プロンプトと最終結果を非公開で送信します。呼び出し元の所有者に Discord 所有者ルートがある場合は、まず Discord DM を試します。利用できない場合は、Telegram など、`commands.ownerAllowFrom` から最初に利用可能な所有者ルートにフォールバックします。 `target` が `channel` または `both` の場合、承認プロンプトはチャンネルに表示されます。解決済みの承認者だけがボタンを使用でき、他のユーザーには一時的な拒否が返されます。承認プロンプトにはコマンドテキストが含まれるため、チャンネル配信は信頼できるチャンネルでのみ有効にしてください。セッションキーからチャンネル ID を導出できない場合、OpenClaw は DM 配信にフォールバックします。 Discord は、他のチャットチャンネルで使用される共有承認ボタンもレンダリングします。ネイティブ Discord アダプターは主に、承認者 DM ルーティングとチャンネルファンアウトを追加します。 これらのボタンが存在する場合、それらが主要な承認 UX です。OpenClaw は、 ツール結果がチャット承認を利用できない、または手動承認が唯一の経路であると示す場合にのみ、 手動の `/approve` コマンドを含めるべきです。 Discord ネイティブ承認ランタイムがアクティブでない場合、OpenClaw は ローカルの決定的な `/approve ` プロンプトを表示したままにします。 ランタイムがアクティブでもネイティブカードをどのターゲットにも配信できない場合、 OpenClaw は保留中の承認からの正確な `/approve` コマンドを含む同一チャットのフォールバック通知を送信します。 Gateway 認証と承認解決は、共有 Gateway クライアント契約に従います（`plugin:` ID は `plugin.approval.resolve` で解決され、その他の ID は `exec.approval.resolve` で解決されます）。承認はデフォルトで 30 分後に期限切れになります。 [実行承認](/ja-JP/tools/exec-approvals)を参照してください。 ## ツールとアクションゲート Discord メッセージアクションには、メッセージ送信、チャンネル管理、モデレーション、プレゼンス、メタデータアクションが含まれます。 コアの例: - メッセージング: `sendMessage`、`readMessages`、`editMessage`、`deleteMessage`、`threadReply` - リアクション: `react`、`reactions`、`emojiList` - モデレーション: `timeout`、`kick`、`ban` - プレゼンス: `setPresence` `event-create` アクションは、スケジュール済みイベントのカバー画像を設定するための任意の `image` パラメーター（URL またはローカルファイルパス）を受け付けます。 アクションゲートは `channels.discord.actions.*` 配下にあります。 デフォルトのゲート動作: | アクショングループ | デフォルト | | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------ | -------- | | reactions、messages、threads、pins、polls、search、memberInfo、roleInfo、channelInfo、channels、voiceStatus、events、stickers、emojiUploads、stickerUploads、permissions | 有効 | | roles | 無効 | | moderation | 無効 | | presence | 無効 | ## Components v2 UI OpenClaw は、実行承認とクロスコンテキストマーカーに Discord components v2 を使用します。Discord メッセージアクションはカスタム UI 用に `components` も受け付けることができます（高度。discord ツールを介してコンポーネントペイロードを構築する必要があります）。一方、レガシーの `embeds` も引き続き利用できますが、推奨されません。 - `channels.discord.ui.components.accentColor` は、Discord コンポーネントコンテナーで使用されるアクセントカラー（16 進数）を設定します。 - アカウントごとに `channels.discord.accounts..ui.components.accentColor` で設定します。 - `channels.discord.agentComponents.ttlMs` は、送信済み Discord コンポーネントコールバックを登録したままにする期間を制御します（デフォルト `1800000`、最大 `86400000`）。アカウントごとに `channels.discord.accounts..agentComponents.ttlMs` で設定します。 - components v2 が存在する場合、`embeds` は無視されます。 - プレーン URL プレビューはデフォルトで抑制されます。単一の送信リンクを展開する必要がある場合は、メッセージアクションで `suppressEmbeds: false` を設定します。 例: ```json5 { channels: { discord: { ui: { components: { accentColor: "#5865F2", }, }, }, }, } ``` ## 音声 Discord には 2 つの異なる音声サーフェスがあります。リアルタイムの**音声チャンネル**（継続的な会話）と**音声メッセージ添付ファイル**（波形プレビュー形式）です。Gateway は両方をサポートします。 ### 音声チャンネル セットアップチェックリスト: 1. Discord Developer Portal で Message Content Intent を有効にします。 2. ロール/ユーザー許可リストを使用する場合は、Server Members Intent を有効にします。 3. `bot` と `applications.commands` スコープで bot を招待します。 4. 対象の音声チャンネルで Connect、Speak、Send Messages、Read Message History を付与します。 5. ネイティブコマンド（`commands.native` または `channels.discord.commands.native`）を有効にします。 6. `channels.discord.voice` を設定します。 セッションを制御するには `/vc join|leave|status` を使用します。このコマンドはアカウントのデフォルトエージェントを使用し、他の Discord コマンドと同じ許可リストおよびグループポリシールールに従います。 ```bash /vc join channel: /vc status /vc leave ``` 参加前に bot の有効な権限を検査するには、次を実行します。 ```bash openclaw channels capabilities --channel discord --target channel: ``` 自動参加の例: ```json5 { channels: { discord: { voice: { enabled: true, model: "openai/gpt-5.5", autoJoin: [ { guildId: "123456789012345678", channelId: "234567890123456789", }, ], allowedChannels: [ { guildId: "123456789012345678", channelId: "234567890123456789", }, ], daveEncryption: true, decryptionFailureTolerance: 24, connectTimeoutMs: 30000, reconnectGraceMs: 15000, realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", }, }, }, }, } ``` 注: - `voice.tts` は `stt-tts` の音声再生でのみ `messages.tts` を上書きします。リアルタイムモードは `voice.realtime.speakerVoice` を使用します。 - `voice.mode` は会話パスを制御します。デフォルトは `agent-proxy` です。リアルタイム音声フロントエンドがターンのタイミング、割り込み、再生を処理し、実質的な作業を `openclaw_agent_consult` 経由でルーティングされた OpenClaw エージェントへ委任し、その結果をその話者からの入力済み Discord プロンプトのように扱います。`stt-tts` は従来のバッチ STT と TTS のフローを維持します。`bidi` は、OpenClaw の頭脳向けに `openclaw_agent_consult` を公開しながら、リアルタイムモデルが直接会話できるようにします。 - `voice.agentSession` は、どの OpenClaw 会話が音声ターンを受け取るかを制御します。音声チャンネル自身のセッションを使う場合は未設定のままにします。または、`{ mode: "target", target: "channel:" }` を設定して、音声チャンネルを `#maintainers` など既存の Discord テキストチャンネルセッションのマイク/スピーカー拡張として動作させます。 - `voice.model` は、Discord 音声応答とリアルタイム相談で使う OpenClaw エージェントの頭脳を上書きします。未設定のままにすると、ルーティングされたエージェントモデルを継承します。これは `voice.realtime.model` とは別です。 - `voice.followUsers` により、ボットは選択したユーザーとともに Discord 音声へ参加、移動、退出できます。動作ルールと例については [音声でユーザーをフォロー](#follow-users-in-voice) を参照してください。 - `agent-proxy` は音声を `discord-voice` 経由でルーティングします。これにより話者と対象セッションの通常のオーナー/ツール認可は保持されますが、Discord 音声が再生を所有するため、エージェントの `tts` ツールは非表示になります。デフォルトでは、`agent-proxy` はオーナー話者に対して、相談へオーナー相当の完全なツールアクセスを付与し (`voice.realtime.toolPolicy: "owner"`)、実質的な回答の前に OpenClaw エージェントへ相談することを強く優先します (`voice.realtime.consultPolicy: "always"`)。そのデフォルトの `always` モードでは、リアルタイム層は相談回答の前に穴埋め発話を自動では行いません。音声をキャプチャして文字起こしし、その後ルーティングされた OpenClaw の回答を発話します。Discord が最初の回答をまだ再生している間に複数の強制相談回答が完了した場合、後続の厳密な発話回答は文の途中で音声を置き換えるのではなく、再生がアイドルになるまでキューに入れられます。 - `stt-tts` モードでは、STT は `tools.media.audio` を使用します。`voice.model` は文字起こしに影響しません。 - リアルタイムモードでは、`voice.realtime.provider`、`voice.realtime.model`、`voice.realtime.speakerVoice` がリアルタイム音声セッションを構成します。OpenAI Realtime 2 と Codex の頭脳を使う場合は、`voice.realtime.model: "gpt-realtime-2"` と `voice.model: "openai/gpt-5.5"` を使用します。 - リアルタイム音声モードは、デフォルトで小さな `IDENTITY.md`、`USER.md`、`SOUL.md` プロファイルファイルをリアルタイムプロバイダーの指示に含めるため、高速な直接ターンでも、ルーティングされた OpenClaw エージェントと同じアイデンティティ、ユーザー基盤、ペルソナを維持できます。これをカスタマイズするには `voice.realtime.bootstrapContextFiles` をサブセットに設定し、無効にするには `[]` を設定します。サポートされるリアルタイムブートストラップファイルは、これらのプロファイルファイルに限定されます。`AGENTS.md` は通常のエージェントコンテキストに残ります。注入されるプロファイルコンテキストは、ワークスペース作業、現在の事実、メモリ検索、ツール支援アクションにおける `openclaw_agent_consult` を置き換えるものではありません。 - OpenAI `agent-proxy` リアルタイムモードでは、文字起こしがウェイク名で始まるか終わるまで Discord リアルタイム音声を無音に保つには、`voice.realtime.requireWakeName: true` を設定します。構成するウェイク名は 1 語または 2 語でなければなりません。`voice.realtime.wakeNames` が未設定の場合、OpenClaw はルーティングされたエージェントの `name` と `OpenClaw` を使用し、フォールバックとしてエージェント ID と `OpenClaw` を使用します。ウェイク名ゲーティングはリアルタイムプロバイダーの自動応答を無効にし、受け入れられたターンを OpenClaw エージェント相談パス経由でルーティングし、最終文字起こしの到着前に先頭のウェイク名が部分文字起こしから認識された場合は短い音声確認を返します。 - OpenAI リアルタイムプロバイダーは、現在の Realtime 2 イベント名と、出力音声および文字起こしイベント向けの従来の Codex 互換エイリアスを受け入れるため、互換プロバイダースナップショットが変化してもアシスタント音声を落としません。 - `voice.realtime.bargeIn` は、Discord の話者開始イベントがアクティブなリアルタイム再生を割り込むかどうかを制御します。未設定の場合は、リアルタイムプロバイダーの入力音声割り込み設定に従います。 - `voice.realtime.minBargeInAudioEndMs` は、OpenAI リアルタイムの割り込みが音声を切り詰める前に必要な最小アシスタント再生時間を制御します。デフォルト: `250`。エコーの少ない部屋で即時割り込みを行うには `0` を設定し、エコーの多いスピーカー構成では値を上げます。 - Discord 再生で OpenAI 音声を使うには、`voice.tts.provider: "openai"` を設定し、`voice.tts.providers.openai.speakerVoice` で Text-to-speech 音声を選択します。`cedar` は現在の OpenAI TTS モデルで男性的に聞こえる良い選択肢です。 - チャンネルごとの Discord `systemPrompt` 上書きは、その音声チャンネルの音声文字起こしターンに適用されます。 - 音声文字起こしターンは、オーナー制限付きコマンドとチャンネルアクション向けに、Discord `allowFrom` (または `dm.allowFrom`) からオーナー状態を導出します。エージェントツールの可視性は、ルーティングされたセッションに構成されたツールポリシーに従います。 - Discord 音声はテキストのみの構成ではオプトインです。`/vc` コマンド、音声ランタイム、`GuildVoiceStates` Gateway インテントを有効にするには、`channels.discord.voice.enabled=true` を設定します (または既存の `channels.discord.voice` ブロックを維持します)。 - `channels.discord.intents.voiceStates` は、音声状態インテントの購読を明示的に上書きできます。有効な音声有効化状態にインテントを従わせるには未設定のままにします。 - `voice.autoJoin` に同じギルドの複数エントリがある場合、OpenClaw はそのギルドで最後に構成されたチャンネルに参加します。 - `voice.allowedChannels` は任意の常駐許可リストです。認可済みの任意の Discord 音声チャンネルへ `/vc join` できるようにするには未設定のままにします。設定されている場合、`/vc join`、起動時自動参加、ボットの音声状態移動は、一覧にある `{ guildId, channelId }` エントリに制限されます。空配列に設定すると、すべての Discord 音声参加を拒否します。Discord がボットを許可リスト外へ移動した場合、OpenClaw はそのチャンネルから退出し、構成済みの自動参加先が利用可能なら再参加します。 - `voice.daveEncryption` と `voice.decryptionFailureTolerance` は、`@discordjs/voice` の参加オプションへそのまま渡されます。 - `@discordjs/voice` のデフォルトは、未設定の場合 `daveEncryption=true` と `decryptionFailureTolerance=24` です。 - OpenClaw は、Discord 音声受信とリアルタイム生 PCM 再生に、同梱の `libopus-wasm` コーデックを使用します。固定された libopus WebAssembly ビルドを同梱しており、ネイティブ opus アドオンは不要です。 - `voice.connectTimeoutMs` は、`/vc join` と自動参加試行の初期 `@discordjs/voice` Ready 待機を制御します。デフォルト: `30000`。 - `voice.reconnectGraceMs` は、切断された音声セッションの破棄前に、OpenClaw が再接続開始を待つ時間を制御します。デフォルト: `15000`。 - `stt-tts` モードでは、別のユーザーが話し始めただけでは音声再生は停止しません。フィードバックループを避けるため、OpenClaw は TTS の再生中に新しい音声キャプチャを無視します。次のターンでは再生完了後に話してください。リアルタイムモードは、話者開始を割り込みシグナルとしてリアルタイムプロバイダーへ転送します。 - リアルタイムモードでは、スピーカーから開いたマイクへ入るエコーが割り込みのように見え、再生を中断することがあります。エコーの多い Discord ルームでは、入力音声で OpenAI が自動割り込みしないように `voice.realtime.providers.openai.interruptResponseOnInputAudio: false` を設定します。それでも Discord の話者開始イベントでアクティブ再生を割り込みたい場合は、`voice.realtime.bargeIn: true` を追加します。OpenAI リアルタイムブリッジは、`voice.realtime.minBargeInAudioEndMs` より短い再生切り詰めをエコー/ノイズの可能性が高いものとして無視し、Discord 再生をクリアする代わりにスキップとしてログに記録します。 - `voice.captureSilenceGraceMs` は、Discord が話者の停止を報告した後、OpenClaw がその音声セグメントを STT 向けに確定するまで待つ時間を制御します。デフォルト: `2000`。Discord が通常のポーズを途切れ途切れの部分文字起こしに分割する場合は、この値を上げます。 - ElevenLabs が選択された TTS プロバイダーの場合、Discord 音声再生はストリーミング TTS を使用し、プロバイダー応答ストリームから開始します。ストリーミング対応のないプロバイダーは、合成済み一時ファイルのパスへフォールバックします。 - OpenClaw は受信復号失敗も監視し、短時間に失敗が繰り返された後、音声チャンネルを退出/再参加して自動回復します。 - 更新後に受信ログで `DecryptionFailed(UnencryptedWhenPassthroughDisabled)` が繰り返し表示される場合は、依存関係レポートとログを収集してください。同梱の `@discordjs/voice` ラインには、discord.js PR #11449 のアップストリーム padding 修正が含まれており、これは discord.js issue #11419 を解決したものです。 - `The operation was aborted` 受信イベントは、OpenClaw がキャプチャ済みの話者セグメントを確定するときに想定されるものです。これは詳細診断であり、警告ではありません。 - 詳細な Discord 音声ログには、受け入れられた各話者セグメントについて、境界付きの 1 行 STT 文字起こしプレビューが含まれるため、デバッグ時に無制限の文字起こしテキストを出力せずに、ユーザー側とエージェント返信側の両方を確認できます。 - `agent-proxy` モードでは、強制相談フォールバックは、`...` で終わるテキストや `and` のような末尾の接続語など、未完了の可能性が高い文字起こし断片に加え、「すぐ戻る」や「さようなら」のような明らかにアクション不要の締めをスキップします。これにより古いキュー済み回答を防いだ場合、ログには `forced agent consult skipped reason=...` が表示されます。 ### 音声でユーザーをフォロー 起動時に固定チャンネルへ参加したり `/vc join` を待ったりする代わりに、Discord 音声ボットを 1 人以上の既知の Discord ユーザーと一緒に留まらせたい場合は、`voice.followUsers` を使用します。 ```json5 { channels: { discord: { voice: { enabled: true, followUsersEnabled: true, followUsers: ["discord:123456789012345678"], allowedChannels: [ { guildId: "123456789012345678", channelId: "234567890123456789", }, ], }, }, }, } ``` 動作: - `followUsers` は、生の Discord ユーザー ID と `discord:` 値を受け入れます。OpenClaw は音声状態イベントとの照合前に両方の形式を正規化します。 - `followUsers` が構成されている場合、`followUsersEnabled` はデフォルトで `true` になります。保存済みリストを維持しつつ自動音声フォローを停止するには、`false` に設定します。 - フォロー対象ユーザーが許可済み音声チャンネルに参加すると、OpenClaw はそのチャンネルに参加します。ユーザーが移動すると、OpenClaw も一緒に移動します。アクティブなフォロー対象ユーザーが切断すると、OpenClaw は退出します。 - 同じギルドに複数のフォロー対象ユーザーがおり、アクティブなフォロー対象ユーザーが退出した場合、OpenClaw はギルドから退出する前に、別の追跡対象フォロー対象ユーザーのチャンネルへ移動します。複数のフォロー対象ユーザーが同時に移動した場合、最後に観測された音声状態イベントが優先されます。 - `allowedChannels` は引き続き適用されます。許可されていないチャンネル内のフォロー対象ユーザーは無視され、フォロー所有セッションは別のフォロー対象ユーザーへ移動するか退出します。 - OpenClaw は、起動時および境界付きの間隔で、見逃した音声状態イベントを調整します。調整は構成済みギルドをサンプリングし、1 回の実行あたりの REST 参照数に上限を設けるため、非常に大きな `followUsers` リストは収束まで複数間隔かかる場合があります。 - Discord または管理者が、ユーザーをフォロー中のボットを移動した場合、OpenClaw は音声セッションを再構築し、移動先が許可されていればフォロー所有権を保持します。ボットが `allowedChannels` 外へ移動された場合、OpenClaw は退出し、構成済みの対象が存在すれば再参加します。 - DAVE 受信回復は、復号失敗が繰り返された後、同じチャンネルを退出して再参加する場合があります。フォロー所有セッションはその回復パスを通じてフォロー所有権を保持するため、後でフォロー対象ユーザーが切断した場合もチャンネルから退出します。 参加モードの選択: - 自分が音声にいるときにボットも自動的に音声へ入ってほしい個人用またはオペレーター用の構成では、`followUsers` を使用します。 - 追跡対象ユーザーが音声にいない場合でも存在しているべき固定ルームボットには、`autoJoin` を使用します。 - 1 回限りの参加や、自動音声プレゼンスが意外に感じられる部屋では、`/vc join` を使用します。 Discord 音声コーデック: - 音声受信ログには `discord voice: opus decoder: libopus-wasm` と表示されます。 - リアルタイム再生では、パケットを `@discordjs/voice` に渡す前に、同じ同梱 `libopus-wasm` パッケージで生の 48 kHz ステレオ PCM を Opus にエンコードします。 - ファイルおよびプロバイダーのストリーム再生では、ffmpeg で生の 48 kHz ステレオ PCM にトランスコードし、その後 Discord に送信する Opus パケットストリームに `libopus-wasm` を使用します。 STT と TTS のパイプライン: - Discord PCM キャプチャは WAV 一時ファイルに変換されます。 - `tools.media.audio` が STT を処理します。例: `openai/gpt-4o-mini-transcribe`。 - トランスクリプトは Discord の入力とルーティングを通じて送信されます。一方、応答 LLM は、agent の `tts` ツールを隠し、返却テキストを求める音声出力ポリシーで実行されます。これは Discord 音声が最終的な TTS 再生を所有するためです。 - `voice.model` が設定されている場合、この音声チャンネルターンの応答 LLM だけを上書きします。 - `voice.tts` は `messages.tts` にマージされます。ストリーミング対応プロバイダーはプレイヤーに直接入力し、それ以外の場合は生成された音声ファイルが参加中のチャンネルで再生されます。 デフォルトの agent-proxy 音声チャンネルセッション例: ```json5 { channels: { discord: { voice: { enabled: true, model: "openai/gpt-5.5", followUsersEnabled: true, followUsers: ["123456789012345678"], realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", }, }, }, }, } ``` `voice.agentSession` ブロックがない場合、各音声チャンネルは独自にルーティングされた OpenClaw セッションを取得します。たとえば、`/vc join channel:234567890123456789` は、その Discord 音声チャンネル用のセッションと会話します。リアルタイムモデルは音声フロントエンドにすぎません。実質的なリクエストは、設定済みの OpenClaw agent に渡されます。リアルタイムモデルが consult ツールを呼び出さずに最終トランスクリプトを生成した場合、OpenClaw はフォールバックとして consult を強制するため、デフォルトでも agent と会話しているように動作します。 レガシー STT と TTS の例: ```json5 { channels: { discord: { voice: { enabled: true, mode: "stt-tts", model: "openai/gpt-5.4-mini", tts: { provider: "openai", providers: { openai: { model: "gpt-4o-mini-tts", speakerVoice: "cedar", }, }, }, }, }, }, } ``` リアルタイム bidi の例: ```json5 { channels: { discord: { voice: { enabled: true, mode: "bidi", model: "openai/gpt-5.5", realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", toolPolicy: "safe-read-only", consultPolicy: "always", }, }, }, }, } ``` 既存の Discord チャンネルセッションの拡張としての音声: ```json5 { channels: { discord: { voice: { enabled: true, mode: "agent-proxy", model: "openai/gpt-5.5", agentSession: { mode: "target", target: "channel:123456789012345678", }, realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", }, }, }, }, } ``` `agent-proxy` モードでは、bot は設定済みの音声チャンネルに参加しますが、OpenClaw agent のターンは対象チャンネルの通常のルーティング済みセッションと agent を使用します。リアルタイム音声セッションは、返された結果を音声チャンネルに話し返します。supervisor agent は引き続き、ツールポリシーに従って通常のメッセージツールを使用できます。適切なアクションであれば、別の Discord メッセージを送信することも含まれます。 委任された OpenClaw 実行がアクティブな間、新しい Discord 音声トランスクリプトは、別の agent ターンを開始する前にライブ実行制御として扱われます。「status」、「cancel that」、「use the smaller fix」、「when you're done also check tests」などのフレーズは、アクティブなセッションに対するステータス、キャンセル、誘導、またはフォローアップ入力として分類されます。ステータス、キャンセル、受け入れられた誘導、フォローアップの結果は音声チャンネルに話し返されるため、発信者は OpenClaw がリクエストを処理したかどうかを把握できます。 便利な対象形式: - `target: "channel:123456789012345678"` は Discord テキストチャンネルセッション経由でルーティングします。 - `target: "123456789012345678"` はチャンネル対象として扱われます。 - `target: "dm:123456789012345678"` または `target: "user:123456789012345678"` は、そのダイレクトメッセージセッション経由でルーティングします。 エコーが多い OpenAI Realtime の例: ```json5 { channels: { discord: { voice: { enabled: true, mode: "bidi", model: "openai/gpt-5.5", realtime: { provider: "openai", model: "gpt-realtime-2", speakerVoice: "cedar", bargeIn: true, minBargeInAudioEndMs: 500, consultPolicy: "always", providers: { openai: { interruptResponseOnInputAudio: false, }, }, }, }, }, }, } ``` モデルが開いたマイクを通じて自分自身の Discord 再生音を聞いてしまうが、話しかけて割り込みたい場合にこれを使用します。OpenClaw は生の入力音声で OpenAI が自動割り込みしないようにしつつ、`bargeIn: true` によって、次にキャプチャされたターンが OpenAI に到達する前に、Discord の発話開始イベントとすでにアクティブな発話者音声がアクティブなリアルタイム応答をキャンセルできるようにします。`audioEndMs` が `minBargeInAudioEndMs` 未満の非常に早い割り込みシグナルは、エコーやノイズの可能性が高いものとして扱われ、モデルが最初の再生フレームで途切れないように無視されます。 想定される音声ログ: - 参加時: `discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...` - リアルタイム開始時: `discord voice: realtime bridge starting ... autoRespond=false interruptResponse=false bargeIn=false minBargeInAudioEndMs=...` - 発話者音声時: `discord voice: realtime speaker turn opened ...`、`discord voice: realtime input audio started ... outputAudioMs=... outputActive=...`、および `discord voice: realtime speaker turn closed ... chunks=... discordBytes=... realtimeBytes=... interruptedPlayback=...` - 古い発話をスキップした時: `discord voice: realtime forced agent consult skipped reason=incomplete-transcript ...` または `reason=non-actionable-closing ...` - リアルタイム応答完了時: `discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...` - 再生停止/リセット時: `discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...` - リアルタイム consult 時: `discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...` - agent 回答時: `discord voice: agent turn answer ...` - 正確な発話のキュー投入時: `discord voice: realtime exact speech queued ... queued=... outputAudioMs=... outputActive=...`、続いて `discord voice: realtime exact speech dequeued reason=player-idle ...` - 割り込み検出時: `discord voice: realtime barge-in detected source=speaker-start ...` または `discord voice: realtime barge-in detected source=active-speaker-audio ...`、続いて `discord voice: realtime barge-in requested reason=... outputAudioMs=... outputActive=...` - リアルタイム割り込み時: `discord voice: realtime model interrupt requested client:response.cancel reason=barge-in`、続いて `discord voice: realtime model audio truncated client:conversation.item.truncate reason=barge-in audioEndMs=...` または `discord voice: realtime model interrupt confirmed server:response.done status=cancelled ...` - 無視されたエコー/ノイズ時: `discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250` - 割り込みが無効な場合: `discord voice: realtime capture ignored during playback (barge-in disabled) ...` - アイドル再生時: `discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0` 音声の途切れをデバッグするには、リアルタイム音声ログをタイムラインとして読みます。 1. `realtime audio playback started` は、Discord がアシスタント音声の再生を開始したことを意味します。ブリッジはこの時点から、アシスタント出力チャンク、Discord PCM バイト、プロバイダーのリアルタイムバイト、合成音声の長さのカウントを開始します。 2. `realtime speaker turn opened` は、Discord の発話者がアクティブになったことを示します。再生がすでにアクティブで `bargeIn` が有効な場合、これに続いて `barge-in detected source=speaker-start` が出ることがあります。 3. `realtime input audio started` は、その発話者ターンで最初の実際の音声フレームを受信したことを示します。ここで `outputActive=true` またはゼロでない `outputAudioMs` がある場合、アシスタント再生がまだアクティブな間にマイクが入力を送信していることを意味します。 4. `barge-in detected source=active-speaker-audio` は、アシスタント再生がアクティブな間に OpenClaw がライブ発話者音声を検出したことを意味します。これは、実際の割り込みと、有用な音声のない Discord の発話開始イベントを区別するのに役立ちます。 5. `barge-in requested reason=...` は、OpenClaw がリアルタイムプロバイダーにアクティブな応答のキャンセルまたは切り詰めを要求したことを意味します。`outputAudioMs`、`outputActive`、`playbackChunks` が含まれるため、割り込み前に実際にどれだけのアシスタント音声が再生されたかを確認できます。 6. `realtime audio playback stopped reason=...` は、ローカルの Discord 再生リセット地点です。理由は、再生を停止した主体を示します: `barge-in`、`player-idle`、`provider-clear-audio`、`forced-agent-consult`、`stream-close`、または `session-close`。 7. `realtime speaker turn closed` は、キャプチャされた入力ターンを要約します。`chunks=0` または `hasAudio=false` は、発話者ターンは開いたものの、使用可能な音声がリアルタイムブリッジに到達しなかったことを意味します。`interruptedPlayback=true` は、その入力ターンがアシスタント出力と重なり、割り込みロジックを起動したことを意味します。 便利なフィールド: - `outputAudioMs`: ログ行の前にリアルタイムプロバイダーが生成したアシスタント音声の長さ。 - `audioMs`: 再生停止前に OpenClaw がカウントしたアシスタント音声の長さ。 - `elapsedMs`: 再生ストリームまたは発話者ターンの開始から終了までの実時間。 - `discordBytes`: Discord 音声へ送信、または Discord 音声から受信した 48 kHz ステレオ PCM バイト。 - `realtimeBytes`: リアルタイムプロバイダーへ送信、またはリアルタイムプロバイダーから受信したプロバイダー形式の PCM バイト。 - `playbackChunks`: アクティブな応答のために Discord へ転送されたアシスタント音声チャンク。 - `sinceLastAudioMs`: 最後にキャプチャされた発話者音声フレームから発話者ターン終了までの間隔。 一般的なパターン: - `source=active-speaker-audio`、小さい `outputAudioMs`、近くに同じユーザーがある即時の途切れは、通常、スピーカーのエコーがマイクに入っていることを示します。`voice.realtime.minBargeInAudioEndMs` を上げる、スピーカー音量を下げる、ヘッドホンを使う、または `voice.realtime.providers.openai.interruptResponseOnInputAudio: false` を設定してください。 - `source=speaker-start` の後に `speaker turn closed ... hasAudio=false` が続く場合、Discord は発話開始を報告したものの、音声が OpenClaw に到達しなかったことを意味します。これは一時的な Discord 音声イベント、ノイズゲートの挙動、またはクライアントが短時間マイクを有効化したことが原因になり得ます。 - 近くに割り込みや `provider-clear-audio` がないのに `audio playback stopped reason=stream-close` がある場合、ローカルの Discord 再生ストリームが予期せず終了したことを意味します。直前のプロバイダーと Discord プレイヤーのログを確認してください。 - `capture ignored during playback (barge-in disabled)` は、アシスタント音声がアクティブな間、OpenClaw が意図的に入力を破棄したことを意味します。発話で再生に割り込みたい場合は `voice.realtime.bargeIn` を有効にしてください。 - `barge-in ignored ... outputActive=false` は、Discord またはプロバイダー VAD が発話を報告したものの、OpenClaw には割り込むべきアクティブな再生がなかったことを意味します。これは音声を途切れさせるべきではありません。 資格情報はコンポーネントごとに解決されます。`voice.model` には LLM ルート認証、`tools.media.audio` には STT 認証、`messages.tts`/`voice.tts` には TTS 認証、`voice.realtime.providers` またはプロバイダーの通常の認証設定にはリアルタイムプロバイダー認証が使われます。 ### 音声メッセージ Discord 音声メッセージは波形プレビューを表示し、OGG/Opus 音声を必要とします。OpenClaw は波形を自動生成しますが、検査と変換のために Gateway ホスト上の `ffmpeg` と `ffprobe` が必要です。 - **ローカルファイルパス**を指定します (URL は拒否されます)。 - テキスト内容は省略します (Discord は同じペイロード内のテキスト + ボイスメッセージを拒否します)。 - 任意の音声形式を受け付けます。OpenClaw は必要に応じて OGG/Opus に変換します。 ```bash message(action="send", channel="discord", target="channel:123", path="/path/to/audio.mp3", asVoice=true) ``` ## トラブルシューティング - Message Content Intent を有効にする - ユーザー/メンバー解決に依存する場合は Server Members Intent を有効にする - intent を変更した後に Gateway を再起動する - `groupPolicy` を確認する - `channels.discord.guilds` 配下のギルド許可リストを確認する - ギルドの `channels` マップが存在する場合、一覧にあるチャンネルのみが許可される - `requireMention` の動作とメンションパターンを確認する 便利な確認: ```bash openclaw doctor openclaw channels status --probe openclaw logs --follow ``` よくある原因: - 一致するギルド/チャンネル許可リストがない状態で `groupPolicy="allowlist"` になっている - `requireMention` が誤った場所に設定されている (`channels.discord.guilds` またはチャンネルエントリ配下である必要がある) - 送信者がギルド/チャンネルの `users` 許可リストによってブロックされている 典型的なログ: - `Slow listener detected ...` - `stuck session: sessionKey=agent:...:discord:... state=processing ...` Discord Gateway キューの調整項目: - 単一アカウント: `channels.discord.eventQueue.listenerTimeout` - 複数アカウント: `channels.discord.accounts..eventQueue.listenerTimeout` - これは Discord Gateway リスナーの処理だけを制御し、エージェントターンの寿命は制御しない Discord は、キューに入ったエージェントターンにチャンネル所有のタイムアウトを適用しません。メッセージリスナーは即座に引き渡し、キューに入った Discord 実行は、セッション/ツール/ランタイムのライフサイクルが完了するか処理を中止するまで、セッションごとの順序を保持します。 ```json5 { channels: { discord: { accounts: { default: { eventQueue: { listenerTimeout: 120000, }, }, }, }, }, } ``` OpenClaw は接続前に Discord `/gateway/bot` メタデータを取得します。一時的な失敗時は Discord のデフォルト Gateway URL にフォールバックし、ログではレート制限されます。 メタデータタイムアウトの調整項目: - 単一アカウント: `channels.discord.gatewayInfoTimeoutMs` - 複数アカウント: `channels.discord.accounts..gatewayInfoTimeoutMs` - config が未設定の場合の env フォールバック: `OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS` - デフォルト: `30000` (30 秒)、最大: `120000` OpenClaw は起動時およびランタイム再接続後に、Discord の Gateway `READY` イベントを待機します。起動の時間差を設けた複数アカウント構成では、デフォルトより長い起動時 READY ウィンドウが必要になることがあります。 READY タイムアウトの調整項目: - 起動時の単一アカウント: `channels.discord.gatewayReadyTimeoutMs` - 起動時の複数アカウント: `channels.discord.accounts..gatewayReadyTimeoutMs` - config が未設定の場合の起動時 env フォールバック: `OPENCLAW_DISCORD_READY_TIMEOUT_MS` - 起動時のデフォルト: `15000` (15 秒)、最大: `120000` - ランタイムの単一アカウント: `channels.discord.gatewayRuntimeReadyTimeoutMs` - ランタイムの複数アカウント: `channels.discord.accounts..gatewayRuntimeReadyTimeoutMs` - config が未設定の場合のランタイム env フォールバック: `OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS` - ランタイムのデフォルト: `30000` (30 秒)、最大: `120000` `channels status --probe` の権限チェックは、数値のチャンネル ID でのみ機能します。 slug キーを使用している場合、ランタイムのマッチングは引き続き機能することがありますが、probe は権限を完全には検証できません。 - DM が無効: `channels.discord.dm.enabled=false` - DM ポリシーが無効: `channels.discord.dmPolicy="disabled"` (レガシー: `channels.discord.dm.policy`) - `pairing` モードでペアリング承認を待機中 デフォルトでは、ボットが作成したメッセージは無視されます。 `channels.discord.allowBots=true` を設定する場合は、ループ動作を避けるために厳格なメンションと許可リストのルールを使用してください。 ボットにメンションしているボットメッセージのみを受け入れるには、`channels.discord.allowBots="mentions"` を推奨します。 OpenClaw には共有の [ボットループ保護](/ja-JP/channels/bot-loop-protection) も同梱されています。`allowBots` によってボット作成メッセージがディスパッチに到達できる場合、Discord は受信イベントを `(account, channel, bot pair)` ファクトにマッピングし、汎用ペアガードは設定されたイベント予算を超えた後にそのペアを抑制します。このガードは、以前は Discord のレート制限で止める必要があった制御不能な 2 ボットループを防ぎます。単一ボットのデプロイや、予算内に収まる単発のボット返信には影響しません。 デフォルト設定 (`allowBots` が設定されている場合に有効): - `maxEventsPerWindow: 20` -- ボットペアはスライディングウィンドウ内で 20 件のメッセージを交換できます - `windowSeconds: 60` -- スライディングウィンドウの長さ - `cooldownSeconds: 60` -- 予算に達すると、どちらの方向の追加のボット間メッセージも 1 分間ドロップされます 共有デフォルトは `channels.defaults.botLoopProtection` の下で一度設定し、正当なワークフローで余裕が必要な場合に Discord を上書きします。優先順位は次のとおりです。 - `channels.discord.accounts..botLoopProtection` - `channels.discord.botLoopProtection` - `channels.defaults.botLoopProtection` - 組み込みデフォルト Discord は汎用の `maxEventsPerWindow`、`windowSeconds`、`cooldownSeconds` キーを使用します。 ```json5 { channels: { defaults: { botLoopProtection: { maxEventsPerWindow: 20, windowSeconds: 60, cooldownSeconds: 60, }, }, discord: { // Optional Discord-wide override. Account blocks override individual // fields and inherit omitted fields from here. botLoopProtection: { maxEventsPerWindow: 4, }, accounts: { mantis: { // Mantis listens to other bots only when they mention her. allowBots: "mentions", }, molty: { // Molty listens to all bot-authored Discord messages. allowBots: true, mentionAliases: { // Lets Molty write a Mantis Discord mention with the configured user id. Mantis: "MANTIS_DISCORD_USER_ID", }, botLoopProtection: { // Allow up to five messages per minute before suppressing the pair. maxEventsPerWindow: 5, windowSeconds: 60, cooldownSeconds: 90, }, }, }, }, }, } ``` - Discord 音声受信の復旧ロジックが含まれるように、OpenClaw を最新に保ちます (`openclaw update`) - `channels.discord.voice.daveEncryption=true` (デフォルト) を確認します - `channels.discord.voice.decryptionFailureTolerance=24` (アップストリームのデフォルト) から開始し、必要な場合のみ調整します - ログで次を確認します: - `discord voice: DAVE decrypt failures detected` - `discord voice: repeated decrypt failures; attempting rejoin` - 自動再参加後も失敗が続く場合は、ログを収集し、[discord.js #11419](https://github.com/discordjs/discord.js/issues/11419) と [discord.js #11449](https://github.com/discordjs/discord.js/pull/11449) のアップストリーム DAVE 受信履歴と比較します ## 設定リファレンス 主要リファレンス: [設定リファレンス - Discord](/ja-JP/gateway/config-channels#discord)。 - 起動/認証: `enabled`, `token`, `accounts.*`, `allowBots` - ポリシー: `groupPolicy`, `dm.*`, `guilds.*`, `guilds.*.channels.*` - コマンド: `commands.native`, `commands.useAccessGroups`, `configWrites`, `slashCommand.*` - イベントキュー: `eventQueue.listenerTimeout` (リスナー予算), `eventQueue.maxQueueSize`, `eventQueue.maxConcurrency` - Gateway: `gatewayInfoTimeoutMs`, `gatewayReadyTimeoutMs`, `gatewayRuntimeReadyTimeoutMs` - 返信/履歴: `replyToMode`, `historyLimit`, `dmHistoryLimit`, `dms.*.historyLimit` - 配信: `textChunkLimit`, `chunkMode`, `maxLinesPerMessage` - ストリーミング: `streaming` (レガシーエイリアス: `streamMode`), `streaming.preview.toolProgress`, `draftChunk`, `blockStreaming`, `blockStreamingCoalesce` - メディア/再試行: `mediaMaxMb` (送信 Discord アップロードを制限、デフォルト `100MB`), `retry` - アクション: `actions.*` - プレゼンス: `activity`, `status`, `activityType`, `activityUrl` - UI: `ui.components.accentColor` - 機能: `threadBindings`, トップレベル `bindings[]` (`type: "acp"`), `pluralkit`, `execApprovals`, `intents`, `agentComponents.enabled`, `agentComponents.ttlMs`, `heartbeat`, `responsePrefix` ## 安全性と運用 - ボットトークンはシークレットとして扱います (管理された環境では `DISCORD_BOT_TOKEN` を推奨)。 - Discord 権限は最小権限で付与します。 - コマンドのデプロイ/状態が古い場合は、gateway を再起動し、`openclaw channels status --probe` で再確認します。 ## 関連 Discord ユーザーを gateway にペアリングします。 グループチャットと許可リストの動作。 受信メッセージをエージェントにルーティングします。 脅威モデルと強化。 guild とチャンネルをエージェントにマッピングします。 ネイティブコマンドの動作。