Discord

​

クイックセットアップ

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

{
  channels: {
    discord: {
      enabled: true,
      token: {
        source: "env",
        provider: "default",
        id: "DISCORD_BOT_TOKEN",
      },
    },
  },
}

DISCORD_BOT_TOKEN=...

{
  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",
        },
      },
    },
  },
}

openclaw pairing list discord
openclaw pairing approve discord <CODE>

​

推奨: ギルドワークスペースをセットアップする

{
  channels: {
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: true,
          users: ["YOUR_USER_ID"],
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      guilds: {
        YOUR_SERVER_ID: {
          requireMention: false,
        },
      },
    },
  },
}

​

ランタイムモデル

• Gateway が Discord 接続を所有します。
• 返信ルーティングは決定的です。Discord からのインバウンドには Discord へ返信します。
• Discord のギルド/チャンネルメタデータは、ユーザーに見える返信プレフィックスとしてではなく、信頼できないコンテキストとしてモデルプロンプトに追加されます。モデルがそのエンベロープをコピーして返した場合、OpenClaw はコピーされたメタデータをアウトバウンド返信と今後のリプレイコンテキストから取り除きます。
• デフォルトでは（session.dmScope=main）、直接チャットはエージェントのメインセッション（agent:main:main）を共有します。
• ギルドチャンネルは分離されたセッションキー（agent:<agentId>:discord:channel:<channelId>）です。
• グループ DM はデフォルトで無視されます（channels.discord.dm.groupEnabled=false）。
• ネイティブスラッシュコマンドは分離されたコマンドセッション（agent:<agentId>:discord:slash:<userId>）で実行されますが、ルーティングされた会話セッションへ CommandTargetSessionKey も引き続き渡します。
• Discord へのテキストのみの Cron/Heartbeat アナウンス配信は、最後のアシスタント可視回答にまとめられ、1 回送信されます。メディアおよび構造化コンポーネントペイロードは、エージェントが複数の配信可能ペイロードを出力した場合、複数メッセージのままになります。

​

フォーラムチャンネル

• フォーラムの親 (channel:<forumId>) にメッセージを送信すると、スレッドが自動作成されます。スレッドタイトルは、メッセージの最初の空でない行です（Discord の 100 文字のスレッド名上限まで切り詰められます）。
• スレッドを直接作成するには openclaw message thread create を使用します。フォーラムチャンネルでは --message-id を渡さないでください。

openclaw message send --channel discord --target channel:<forumId> \
  --message "Topic title\nBody of the post"

openclaw message thread create --channel discord --target channel:<forumId> \
  --thread-name "Topic title" --message "Body of the post"

​

インタラクティブコンポーネント

• text、section、separator、actions、media-gallery、file
• アクション行では最大 5 個のボタン、または単一の選択メニューを使用できます
• 選択タイプ: string、user、role、mentionable、channel

• file ブロックは添付参照 (attachment://<filename>) を指している必要があります
• 添付は media/path/filePath（単一ファイル）で指定します。複数ファイルには media-gallery を使用します
• アップロード名を添付参照と一致させる必要がある場合は、filename を使用して上書きします

• 最大 5 個のフィールドを持つ components.modal を追加します
• フィールドタイプ: text、checkbox、radio、select、role-select、user-select
• OpenClaw はトリガーボタンを自動的に追加します

{
  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" },
          ],
        },
      ],
    },
  },
}

​

アクセス制御とルーティング

{
  accessGroups: {
    operators: {
      type: "message.senders",
      members: {
        "*": ["global-owner-id"],
        discord: ["discord:123456789012345678"],
        telegram: ["987654321"],
      },
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:operators"],
    },
  },
}

{
  accessGroups: {
    maintainers: {
      type: "discord.channelAudience",
      guildId: "1456350064065904867",
      channelId: "1456744319972282449",
      membership: "canViewChannel",
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:maintainers"],
    },
  },
}

{
  accessGroups: {
    maintainers: {
      type: "discord.channelAudience",
      guildId: "1456350064065904867",
      channelId: "1456744319972282449",
    },
  },
  channels: {
    discord: {
      dmPolicy: "allowlist",
      allowFrom: ["accessGroup:maintainers", "discord:123456789012345678"],
    },
  },
}

{
  channels: {
    discord: {
      groupPolicy: "allowlist",
      guilds: {
        "123456789012345678": {
          requireMention: true,
          ignoreOtherMentions: true,
          users: ["987654321098765432"],
          roles: ["123456789012345678"],
          channels: {
            general: { enabled: true },
            help: { enabled: true, requireMention: true },
          },
        },
      },
    },
  },
}

​

ロールベースのエージェントルーティング

{
  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 の認可が適用され、「認可されていません」と返信されます。
• 既定のスラッシュコマンド設定: ephemeral: true (channels.discord.slashCommand.ephemeral)。

​

機能の詳細

{
  channels: {
    discord: {
      suppressEmbeds: false,
    },
  },
}

{
  channels: {
    discord: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          maxLines: 8,
          maxLineChars: 120,
          toolProgress: true,
          commentary: false,
        },
      },
    },
  },
}

{
  "channels": {
    "discord": {
      "streaming": {
        "mode": "progress",
        "progress": {
          "toolProgress": true,
          "commandText": "status"
        }
      }
    }
  }
}

{
  session: {
    threadBindings: {
      enabled: true,
      idleHours: 24,
      maxAgeHours: 0,
    },
  },
  channels: {
    discord: {
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSessions: true,
        defaultSpawnContext: "fork",
      },
    },
  },
}

{
  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,
            },
          },
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      configWrites: false,
    },
  },
}

{
  channels: {
    discord: {
      proxy: "http://proxy.example:8080",
    },
  },
}

{
  channels: {
    discord: {
      accounts: {
        primary: {
          proxy: "http://proxy.example:8080",
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      pluralkit: {
        enabled: true,
        token: "pk_live_...", // optional; needed for private systems
      },
    },
  },
}

{
  channels: {
    discord: {
      mentionAliases: {
        SupportLead: "123456789012345678",
      },
      accounts: {
        ops: {
          mentionAliases: {
            OpsLead: "234567890123456789",
          },
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      status: "idle",
    },
  },
}

{
  channels: {
    discord: {
      activity: "Focus time",
      activityType: 4,
    },
  },
}

{
  channels: {
    discord: {
      activity: "Live coding",
      activityType: 1,
      activityUrl: "https://twitch.tv/openclaw",
    },
  },
}

{
  channels: {
    discord: {
      autoPresence: {
        enabled: true,
        intervalMs: 30000,
        minUpdateIntervalMs: 15000,
        exhaustedText: "token exhausted",
      },
    },
  },
}

​

ツールとアクションゲート

• メッセージング: sendMessage、readMessages、editMessage、deleteMessage、threadReply
• リアクション: react、reactions、emojiList
• モデレーション: timeout、kick、ban
• プレゼンス: setPresence

​

Components v2 UI

• channels.discord.ui.components.accentColor は、Discord コンポーネントコンテナーで使用されるアクセントカラー（16 進数）を設定する。アカウント別: channels.discord.accounts.<id>.ui.components.accentColor。
• channels.discord.agentComponents.ttlMs は、送信済み Discord コンポーネントコールバックの登録が保持される時間を制御する（デフォルト 1800000、最大 86400000）。アカウント別: channels.discord.accounts.<id>.agentComponents.ttlMs。
• components v2 が存在する場合、embeds は無視される。
• プレーン URL プレビューはデフォルトで抑制される。単一の送信リンクを展開したい場合は、メッセージアクションで suppressEmbeds: false を設定する。

{
  channels: {
    discord: {
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
    },
  },
}

​

音声

​

ボイスチャンネル

1. Discord Developer Portal で Message Content Intent を有効にする。
2. ロール/ユーザー allowlist を使用する場合は 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 channel:<voice-channel-id>
/vc status
/vc leave

openclaw channels capabilities --channel discord --target channel:<voice-channel-id>

{
  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",
        },
      },
    },
  },
}

• Discord 音声はテキスト専用設定ではオプトインです。channels.discord.voice.enabled=true を設定するか、既存の channels.discord.voice ブロックを維持すると、/vc コマンド、音声ランタイム、GuildVoiceStates Gateway インテントが有効になります。channels.discord.intents.voiceStates でインテント購読を明示的に上書きできます。未設定のままにすると、有効な音声有効化状態に従います。
• 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:<text-channel-id>" } を設定すると、音声チャンネルを #maintainers など既存の Discord テキストチャンネルセッションのマイク/スピーカー拡張として動作させます。
• voice.model は、Discord 音声応答とリアルタイム consult に使う OpenClaw エージェントの頭脳を上書きします。未設定のままにすると、ルーティング済みエージェントモデルを継承します。これは voice.realtime.model とは別です。
• voice.followUsers により、ボットは選択したユーザーに合わせて Discord 音声に参加、移動、退出できます。音声でユーザーをフォローするを参照してください。
• agent-proxy は音声を discord-voice 経由でルーティングします。これにより、話者と対象セッションに対する通常のオーナー/ツール認可は維持されますが、Discord 音声が再生を所有するため、エージェントの tts ツールは隠されます。デフォルトでは、agent-proxy はオーナー話者に対して consult にオーナー相当の完全なツールアクセスを与え（voice.realtime.toolPolicy: "owner"）、実質的な回答の前に OpenClaw エージェントへの consult を強く優先します（voice.realtime.consultPolicy: "always"）。そのデフォルトの always モードでは、リアルタイム層は consult 回答の前にフィラーを自動発話しません。発話をキャプチャして文字起こしし、その後ルーティング済みの OpenClaw 回答を発話します。Discord が最初の回答をまだ再生している間に複数の強制 consult 回答が完了した場合、後続の exact-speech 回答は文の途中で発話を置き換えるのではなく、再生がアイドルになるまでキューに入れられます。
• 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 リアルタイムモードでは、voice.realtime.requireWakeName: true を設定すると、文字起こしがウェイク名で始まるか終わるまで Discord リアルタイム音声を無音のままにできます。設定するウェイク名は 1 語または 2 語でなければなりません。voice.realtime.wakeNames が未設定の場合、OpenClaw はルーティング済みエージェントの name と OpenClaw を使用し、フォールバックとしてエージェント ID と OpenClaw を使用します。ウェイク名ゲーティングは、リアルタイムプロバイダーの自動応答を無効化し、受け入れたターンを OpenClaw エージェント consult パス経由でルーティングし、最終文字起こしが届く前に部分文字起こしから先頭のウェイク名が認識された場合に短い音声確認を返します。
• OpenAI リアルタイムプロバイダーは、現在の Realtime 2 イベント名と、出力音声および文字起こしイベント向けの従来の Codex 互換エイリアスを受け入れるため、互換プロバイダースナップショットが変化してもアシスタント音声を落としません。
• voice.realtime.bargeIn は、Discord の話者開始イベントがアクティブなリアルタイム再生に割り込むかどうかを制御します。未設定の場合、リアルタイムプロバイダーの入力音声割り込み設定に従います。
• voice.realtime.minBargeInAudioEndMs は、OpenAI リアルタイム barge-in が音声を切り詰める前の最小アシスタント再生時間を制御します。デフォルト: 250。エコーの少ない部屋では即時割り込みのために 0 を設定し、エコーの多いスピーカー構成では値を上げます。
• voice.tts は stt-tts 音声再生の場合のみ messages.tts を上書きします。リアルタイムモードでは代わりに voice.realtime.speakerVoice を使用します。Discord 再生で OpenAI 音声を使うには、voice.tts.provider: "openai" を設定し、voice.tts.providers.openai.speakerVoice 配下で Text-to-speech 音声を選択します。現在の OpenAI TTS モデルでは、cedar は男性的に聞こえる選択肢として適しています。
• チャンネルごとの Discord systemPrompt 上書きは、その音声チャンネルの音声文字起こしターンに適用されます。
• 音声文字起こしターンは、オーナー制限付きコマンドとチャンネルアクションのために、Discord allowFrom（または dm.allowFrom）からオーナーステータスを導出します。エージェントツールの可視性は、ルーティング済みセッションに設定されたツールポリシーに従います。
• voice.autoJoin に同じギルドのエントリが複数ある場合、OpenClaw はそのギルドで最後に設定されたチャンネルに参加します。
• voice.allowedChannels は任意の常駐許可リストです。未設定のままにすると、認可済みの任意の Discord 音声チャンネルへの /vc join を許可します。設定した場合、/vc join、起動時の自動参加、ボットの音声状態移動は、一覧の { guildId, channelId } エントリに制限されます。空配列に設定すると、すべての Discord 音声参加を拒否します。Discord がボットを許可リスト外へ移動した場合、OpenClaw はそのチャンネルから退出し、利用可能なら設定済みの自動参加ターゲットに再参加します。
• voice.daveEncryption と voice.decryptionFailureTolerance は @discordjs/voice の参加オプションへそのまま渡されます。アップストリームのデフォルトは daveEncryption=true と decryptionFailureTolerance=24 です。
• OpenClaw は、Discord 音声受信とリアルタイム raw PCM 再生に、同梱の libopus-wasm コーデックを使用します。これは固定された libopus WebAssembly ビルドを同梱しており、ネイティブ opus アドオンを必要としません。
• voice.connectTimeoutMs は、/vc join と自動参加試行における最初の @discordjs/voice Ready 待機を制御します。デフォルト: 30000。
• voice.reconnectGraceMs は、切断された音声セッションが再接続を開始するまで OpenClaw が待つ時間を制御します。デフォルト: 15000。
• stt-tts モードでは、別のユーザーが話し始めただけでは音声再生は停止しません。フィードバックループを避けるため、OpenClaw は TTS の再生中に新しい音声キャプチャを無視します。次のターンでは再生完了後に話してください。リアルタイムモードでは、話者開始を barge-in シグナルとしてリアルタイムプロバイダーに転送します。
• リアルタイムモードでは、スピーカーから開いたマイクに入るエコーが barge-in のように見え、再生を中断することがあります。エコーの多い Discord ルームでは、voice.realtime.providers.openai.interruptResponseOnInputAudio: false を設定して、OpenAI が入力音声で自動割り込みしないようにします。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 モードでは、強制 consult フォールバックは、... で終わるテキストや “and” のような末尾の接続語など、未完了の可能性が高い文字起こし断片に加えて、“be right back” や “bye” のような明らかにアクション不能な締めの言葉をスキップします。これにより古いキュー済み回答が防止された場合、ログには forced agent consult skipped reason=... と表示されます。

​

音声でユーザーをフォローする

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        followUsersEnabled: true,
        followUsers: ["discord:123456789012345678"],
        allowedChannels: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
      },
    },
  },
}

• followUsers は raw Discord ユーザー ID と discord:<id> 値を受け入れます。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 voice: opus decoder: libopus-wasm と表示されます。
• リアルタイム再生では、raw 48 kHz ステレオ PCM を、同じ同梱 libopus-wasm パッケージで Opus にエンコードしてから、パケットを @discordjs/voice に渡します。
• ファイル再生とプロバイダーストリーム再生では、ffmpeg で raw 48 kHz ステレオ PCM にトランスコードし、その後 Discord に送信する Opus パケットストリームに libopus-wasm を使用します。

• Discord PCM キャプチャは WAV 一時ファイルに変換されます。
• tools.media.audio は STT を処理します。例: openai/gpt-4o-mini-transcribe。
• トランスクリプトは Discord の ingress とルーティングを通じて送信され、応答 LLM は、agent の tts ツールを隠して返却テキストを求める音声出力ポリシーで実行されます。最終的な TTS 再生は Discord voice が担うためです。
• voice.model が設定されている場合、この音声チャネルターンの応答 LLM のみを上書きします。
• voice.tts は messages.tts にマージされます。ストリーミング対応プロバイダーはプレイヤーへ直接供給し、それ以外の場合は生成された音声ファイルが参加中のチャネルで再生されます。

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        model: "openai/gpt-5.5",
        followUsersEnabled: true,
        followUsers: ["123456789012345678"],
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          speakerVoice: "cedar",
        },
      },
    },
  },
}

{
  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",
            },
          },
        },
      },
    },
  },
}

{
  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",
        },
      },
    },
  },
}

{
  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",
        },
      },
    },
  },
}

• target: "channel:123456789012345678" は Discord テキストチャネルセッション経由でルーティングします。
• target: "123456789012345678" はチャネルターゲットとして扱われます。
• target: "dm:123456789012345678" または target: "user:123456789012345678" はそのダイレクトメッセージセッション経由でルーティングします。

{
  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 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 ...
• barge-in 検出時: 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
• 無効化された barge-in 時: 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 がアシスタント音声の再生を開始したことを意味します。bridge はこの時点から、アシスタント出力チャンク、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 は、話者ターンは開いたものの使用可能な音声がリアルタイム bridge に到達しなかったことを意味します。interruptedPlayback=true は、その入力ターンがアシスタント出力と重なり、barge-in ロジックをトリガーしたことを意味します。

• outputAudioMs: ログ行の前にリアルタイムプロバイダーが生成したアシスタント音声の長さ。
• audioMs: 再生停止前に OpenClaw がカウントしたアシスタント音声の長さ。
• elapsedMs: 再生ストリームまたは話者ターンを開いてから閉じるまでの実時間。
• discordBytes: Discord voice に送信、または Discord voice から受信した 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 voice イベント、ノイズゲート動作、またはクライアントが一瞬マイクを有効にしたことが原因の場合があります。
• 近くに barge-in や 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 に割り込む対象のアクティブな再生がなかったことを意味します。これで音声が途切れることはありません。

​

音声メッセージ

• ローカルファイルパスを指定します (URL は拒否されます)。
• テキスト内容は省略します (Discord は同じペイロード内のテキスト + 音声メッセージを拒否します)。
• どの音声形式でも受け付けます。OpenClaw は必要に応じて OGG/Opus に変換します。

message(action="send", channel="discord", target="channel:123", path="/path/to/audio.mp3", asVoice=true)

​

トラブルシューティング

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

{
  channels: {
    discord: {
      accounts: {
        default: {
          eventQueue: {
            listenerTimeout: 120000,
          },
        },
      },
    },
  },
}

{
  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: {
        alpha: {
          // Alpha listens to other bots only when they mention it.
          allowBots: "mentions",
        },
        bravo: {
          // Bravo listens to all bot-authored Discord messages.
          allowBots: true,
          mentionAliases: {
            // Lets Bravo write an Alpha Discord mention with the configured user id.
            Alpha: "ALPHA_DISCORD_USER_ID",
          },
          botLoopProtection: {
            // Allow up to five messages per minute before suppressing the pair.
            maxEventsPerWindow: 5,
            windowSeconds: 60,
            cooldownSeconds: 90,
          },
        },
      },
    },
  },
}

​

Configuration reference

​

安全性と運用

• bot token は secret として扱う（supervised environment では DISCORD_BOT_TOKEN を推奨）。
• least-privilege Discord permissions を付与する。
• command deploy/state が stale の場合、gateway を再起動し、openclaw channels status --probe で再確認する。

​

関連