Discord

Documentation Index

Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt

Use this file to discover all available pages before exploring further.

​

快速設定

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>

​

建議：設定 guild 工作區

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

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

​

Runtime model

• Gateway 擁有 Discord 連線。
• 回覆路由是確定性的：Discord 傳入回覆會回到 Discord。
• Discord 伺服器／頻道中繼資料會作為不受信任的 情境加入模型提示，而不是作為使用者可見的回覆前綴。如果模型把該外層資訊 複製回來，OpenClaw 會從傳出回覆和 未來重播情境中移除複製的中繼資料。
• 預設情況下（session.dmScope=main），直接聊天會共用代理主工作階段（agent:main:main）。
• 伺服器頻道是隔離的工作階段鍵（agent:<agentId>:discord:channel:<channelId>）。
• 群組私訊預設會被忽略（channels.discord.dm.groupEnabled=false）。
• 原生斜線命令會在隔離的命令工作階段中執行（agent:<agentId>:discord:slash:<userId>），同時仍攜帶 CommandTargetSessionKey 到已路由的對話工作階段。
• 傳送到 Discord 的純文字 cron/heartbeat 公告會使用最終的 助理可見答案一次。當代理發出多個可傳遞承載時，媒體和結構化元件承載仍會保持 多訊息形式。

​

論壇頻道

• 傳送訊息到論壇父頻道（channel:<forumId>）以自動建立討論串。討論串標題會使用訊息中的第一個非空行。
• 使用 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: { allow: true },
            help: { allow: 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: {
      streaming: {
        mode: "progress",
        progress: {
          label: "auto",
          maxLines: 8,
          toolProgress: true,
        },
      },
    },
  },
}

{
  "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: {
        Vladislava: "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
• presence：setPresence

​

Components v2 UI

• channels.discord.ui.components.accentColor 設定 Discord component 容器使用的強調色（十六進位）。
• 使用 channels.discord.accounts.<id>.ui.components.accentColor 依帳戶設定。
• 當 components v2 存在時，embeds 會被忽略。

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

​

語音

​

語音頻道

1. 在 Discord Developer Portal 啟用 Message Content Intent。
2. 使用角色/使用者允許清單時，啟用 Server Members Intent。
3. 使用 bot 和 applications.commands 範圍邀請機器人。
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-codex/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",
          voice: "cedar",
        },
      },
    },
  },
}

• voice.tts 只會針對 stt-tts 語音播放覆寫 messages.tts。即時模式會使用 voice.realtime.voice。
• voice.mode 控制對話路徑。預設值是 agent-proxy：即時語音前端會處理回合時機、中斷與播放，透過 openclaw_agent_consult 將實質工作委派給路由後的 OpenClaw 代理，並把結果視為該說話者輸入的 Discord 文字提示。stt-tts 會保留較舊的批次 STT 加 TTS 流程。bidi 讓即時模型直接對話，同時公開 openclaw_agent_consult 給 OpenClaw 大腦使用。
• voice.agentSession 控制哪個 OpenClaw 對話接收語音回合。若要使用語音頻道自己的工作階段，請保持未設定；或設定 { mode: "target", target: "channel:<text-channel-id>" }，讓語音頻道作為既有 Discord 文字頻道工作階段（例如 #maintainers）的麥克風／喇叭延伸。
• voice.model 會覆寫用於 Discord 語音回應與即時諮詢的 OpenClaw 代理大腦。若要繼承路由後的代理模型，請保持未設定。它與 voice.realtime.model 是分開的。
• agent-proxy 會透過 discord-voice 路由語音；這會為說話者與目標工作階段保留一般的擁有者／工具授權，但會隱藏代理的 tts 工具，因為 Discord 語音負責播放。預設情況下，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.voice 會設定即時音訊工作階段。若要搭配 Codex 大腦使用 OpenAI Realtime 2，請使用 voice.realtime.model: "gpt-realtime-2" 與 voice.model: "openai-codex/gpt-5.5"。
• OpenAI 即時提供者接受目前的 Realtime 2 事件名稱，以及舊版 Codex 相容的輸出音訊與轉錄事件別名，因此相容的提供者快照可以漂移，而不會遺失助理音訊。
• voice.realtime.bargeIn 控制 Discord 說話者開始事件是否會中斷作用中的即時播放。若未設定，它會跟隨即時提供者的輸入音訊中斷設定。
• voice.realtime.minBargeInAudioEndMs 控制 OpenAI 即時插話截斷音訊前的最短助理播放時間。預設值：250。在低回音房間中可設為 0 以立即中斷，或在回音較重的喇叭設定中提高此值。
• 若要在 Discord 播放中使用 OpenAI 語音，請設定 voice.tts.provider: "openai"，並在 voice.tts.openai.voice 或 voice.tts.providers.openai.voice 下選擇文字轉語音語音。cedar 在目前的 OpenAI TTS 模型上是很好的男性聲音選擇。
• 每個頻道的 Discord systemPrompt 覆寫會套用到該語音頻道的語音轉錄回合。
• 語音轉錄回合會從 Discord allowFrom（或 dm.allowFrom）衍生擁有者狀態；非擁有者說話者無法存取僅限擁有者的工具（例如 gateway 和 cron）。
• Discord 語音對純文字設定是選用功能；設定 channels.discord.voice.enabled=true（或保留既有的 channels.discord.voice 區塊）即可啟用 /vc 指令、語音執行階段，以及 GuildVoiceStates Gateway 意圖。
• channels.discord.intents.voiceStates 可以明確覆寫語音狀態意圖訂閱。保持未設定時，該意圖會跟隨有效的語音啟用狀態。
• 如果 voice.autoJoin 對同一個伺服器有多個項目，OpenClaw 會加入該伺服器最後設定的頻道。
• voice.allowedChannels 是選用的駐留允許清單。保持未設定可允許 /vc join 加入任何已授權的 Discord 語音頻道。設定後，/vc join、啟動時自動加入，以及機器人的語音狀態移動都會限制在列出的 { guildId, channelId } 項目中。將它設定為空陣列可拒絕所有 Discord 語音加入。如果 Discord 將機器人移到允許清單之外，OpenClaw 會離開該頻道，並在有可用的已設定自動加入目標時重新加入。
• voice.daveEncryption 與 voice.decryptionFailureTolerance 會傳遞至 @discordjs/voice 加入選項。
• 如果未設定，@discordjs/voice 預設值為 daveEncryption=true 與 decryptionFailureTolerance=24。
• OpenClaw 預設使用純 JS opusscript 解碼器接收 Discord 語音。選用的原生 @discordjs/opus 套件會被儲存庫的 pnpm 安裝政策忽略，因此一般安裝、Docker 跑道與無關測試不會編譯原生附加元件。專用的語音效能主機可以在安裝原生附加元件後，以 OPENCLAW_DISCORD_OPUS_DECODER=native 選用加入。
• voice.connectTimeoutMs 控制 /vc join 與自動加入嘗試的初始 @discordjs/voice Ready 等待時間。預設值：30000。
• voice.reconnectGraceMs 控制 OpenClaw 在銷毀已中斷連線的語音工作階段前，等待其開始重新連線的時間。預設值：15000。
• 在 stt-tts 模式中，語音播放不會只因為另一位使用者開始說話而停止。為避免回授迴圈，OpenClaw 會在 TTS 播放時忽略新的語音擷取；請在播放完成後再說下一回合。即時模式會將說話者開始事件作為插話訊號轉送給即時提供者。
• 在即時模式中，喇叭回音進入開啟的麥克風，可能看起來像插話並中斷播放。對回音較重的 Discord 房間，設定 voice.realtime.providers.openai.interruptResponseOnInputAudio: false，可避免 OpenAI 在輸入音訊上自動中斷。如果仍想讓 Discord 說話者開始事件中斷作用中的播放，請加入 voice.realtime.bargeIn: true。OpenAI 即時橋接器會將短於 voice.realtime.minBargeInAudioEndMs 的播放截斷視為可能的回音／雜訊而忽略，並記錄為已略過，而不是清除 Discord 播放。
• voice.captureSilenceGraceMs 控制 OpenClaw 在 Discord 回報說話者已停止後，等待多久才將該音訊片段定稿給 STT。預設值：2500；如果 Discord 將正常停頓切成零碎的部分轉錄，請提高此值。
• 當 ElevenLabs 是選取的 TTS 提供者時，Discord 語音播放會使用串流 TTS，並從提供者回應串流開始。不支援串流的提供者會退回合成暫存檔路徑。
• OpenClaw 也會監看接收解密失敗，並在短時間內重複失敗後，透過離開／重新加入語音頻道自動復原。
• 如果更新後接收日誌反覆顯示 DecryptionFailed(UnencryptedWhenPassthroughDisabled)，請收集相依性報告與日誌。隨附的 @discordjs/voice 系列包含來自 discord.js PR #11449 的上游填補修正，該修正關閉了 discord.js issue #11419。
• The operation was aborted 接收事件是 OpenClaw 定稿已擷取說話者片段時的預期情況；它們是詳細診斷，不是警告。
• 詳細 Discord 語音日誌會為每個已接受的說話者片段包含有界的一行 STT 轉錄預覽，因此偵錯時可同時看到使用者端與代理回覆端，而不會傾印無界的轉錄文字。
• 在 agent-proxy 模式中，強制諮詢備援會略過可能不完整的轉錄片段，例如以 ... 結尾的文字，或像 and 這類結尾連接詞，以及明顯不可操作的結語，例如「馬上回來」或「再見」。當這防止陳舊的佇列答案時，日誌會顯示 forced agent consult skipped reason=...。

pnpm install
mise exec node@22 -- pnpm discord:opus:install

OPENCLAW_DISCORD_OPUS_DECODER=native pnpm gateway:watch

• Discord PCM 擷取會轉換成 WAV 暫存檔。
• tools.media.audio 處理 STT，例如 openai/gpt-4o-mini-transcribe。
• 轉錄會透過 Discord 進入與路由傳送，而回應 LLM 會以語音輸出政策執行；該政策會隱藏代理的 tts 工具並要求回傳文字，因為 Discord 語音負責最終 TTS 播放。
• 設定 voice.model 時，只會覆寫此語音頻道回合的回應 LLM。
• voice.tts 會合併覆蓋 messages.tts；支援串流的提供者會直接餵給播放器，否則會在已加入的頻道中播放產生的音訊檔案。

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        model: "openai-codex/gpt-5.5",
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          voice: "cedar",
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        mode: "stt-tts",
        model: "openai/gpt-5.4-mini",
        tts: {
          provider: "openai",
          openai: {
            model: "gpt-4o-mini-tts",
            voice: "cedar",
          },
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        mode: "bidi",
        model: "openai-codex/gpt-5.5",
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          voice: "cedar",
          toolPolicy: "safe-read-only",
          consultPolicy: "always",
        },
      },
    },
  },
}

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        mode: "agent-proxy",
        model: "openai-codex/gpt-5.5",
        agentSession: {
          mode: "target",
          target: "channel:123456789012345678",
        },
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          voice: "cedar",
        },
      },
    },
  },
}

• target: "channel:123456789012345678" 透過 Discord 文字頻道工作階段路由。
• target: "123456789012345678" 會被視為頻道目標。
• target: "dm:123456789012345678" 或 target: "user:123456789012345678" 透過該直接訊息工作階段路由。

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        mode: "bidi",
        model: "openai-codex/gpt-5.5",
        realtime: {
          provider: "openai",
          model: "gpt-realtime-2",
          voice: "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=...
• 即時諮詢時：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 語音事件、雜訊閘行為，或用戶端短暫按下麥克風。
• 若 audio playback stopped reason=stream-close 附近沒有插話或 provider-clear-audio，表示本機 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: {
    discord: {
      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 "@Mantis" and send a real Discord mention.
            Mantis: "MANTIS_DISCORD_USER_ID",
          },
        },
      },
    },
  },
}

​

設定參考

​

安全性與操作

• 將機器人 token 視為機密（受監督環境建議使用 DISCORD_BOT_TOKEN）。
• 授予最低權限的 Discord 權限。
• 如果命令部署/狀態過期，請重新啟動 gateway，並使用 openclaw channels status --probe 重新檢查。

​

相關