Discord

Documentation Index

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

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

​

Hızlı kurulum

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>

​

Önerilen: Bir guild çalışma alanı kurun

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

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

​

Çalışma zamanı modeli

• Gateway, Discord bağlantısının sahibidir.
• Yanıt yönlendirme deterministiktir: Discord gelen yanıtları tekrar Discord’a döner.
• Discord sunucu/kanal meta verileri, kullanıcıya görünen bir yanıt ön eki olarak değil, güvenilmeyen bağlam olarak model istemine eklenir. Bir model bu zarfı geri kopyalarsa, OpenClaw kopyalanan meta verileri giden yanıtlardan ve gelecekteki yeniden oynatma bağlamından çıkarır.
• Varsayılan olarak (session.dmScope=main), doğrudan sohbetler ajanın ana oturumunu paylaşır (agent:main:main).
• Sunucu kanalları yalıtılmış oturum anahtarlarıdır (agent:<agentId>:discord:channel:<channelId>).
• Grup DM’leri varsayılan olarak yok sayılır (channels.discord.dm.groupEnabled=false).
• Yerel slash komutları yalıtılmış komut oturumlarında çalışır (agent:<agentId>:discord:slash:<userId>), ancak yönlendirilmiş konuşma oturumuna CommandTargetSessionKey taşımaya devam eder.
• Discord’a metin tabanlı cron/heartbeat duyuru teslimi, son asistan tarafından görülebilen yanıtı bir kez kullanır. Medya ve yapılandırılmış bileşen yükleri, ajan birden fazla teslim edilebilir yük ürettiğinde çok mesajlı kalır.

​

Forum kanalları

• Otomatik olarak bir iş parçacığı oluşturmak için forum üst öğesine (channel:<forumId>) bir mesaj gönderin. İş parçacığı başlığı, mesajınızın ilk boş olmayan satırını kullanır.
• Doğrudan bir iş parçacığı oluşturmak için openclaw message thread create kullanın. Forum kanalları için --message-id geçmeyin.

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"

​

Etkileşimli bileşenler

• text, section, separator, actions, media-gallery, file
• Eylem satırları en fazla 5 düğmeye veya tek bir seçim menüsüne izin verir
• Seçim türleri: string, user, role, mentionable, channel

• file blokları bir ek başvurusuna işaret etmelidir (attachment://<filename>)
• Eki media/path/filePath üzerinden sağlayın (tek dosya); birden fazla dosya için media-gallery kullanın
• Yükleme adının ek başvurusuyla eşleşmesi gerektiğinde geçersiz kılmak için filename kullanın

• En fazla 5 alanla components.modal ekleyin
• Alan türleri: text, checkbox, radio, select, role-select, user-select
• OpenClaw otomatik olarak bir tetikleyici düğmesi ekler

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

​

Erişim denetimi ve yönlendirme

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

​

Rol tabanlı ajan yönlendirmesi

{
  bindings: [
    {
      agentId: "opus",
      match: {
        channel: "discord",
        guildId: "123456789012345678",
        roles: ["111111111111111111"],
      },
    },
    {
      agentId: "sonnet",
      match: {
        channel: "discord",
        guildId: "123456789012345678",
      },
    },
  ],
}

​

Yerel komutlar ve komut kimlik doğrulaması

• commands.native varsayılan olarak "auto" değerine ayarlanır ve Discord için etkindir.
• Kanal başına geçersiz kılma: channels.discord.commands.native.
• commands.native=false, başlangıç sırasında Discord eğik çizgi komutu kaydını ve temizliğini atlar. Daha önce kaydedilmiş komutlar, siz bunları Discord uygulamasından kaldırana kadar Discord içinde görünür kalabilir.
• Yerel komut kimlik doğrulaması, normal mesaj işleme ile aynı Discord izin listelerini/ilkelerini kullanır.
• Komutlar, yetkili olmayan kullanıcılar için Discord kullanıcı arayüzünde hâlâ görünebilir; yürütme yine de OpenClaw kimlik doğrulamasını uygular ve “yetkili değil” döndürür.

• ephemeral: true

​

Özellik ayrıntıları

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

​

Araçlar ve eylem kapıları

• mesajlaşma: sendMessage, readMessages, editMessage, deleteMessage, threadReply
• tepkiler: react, reactions, emojiList
• moderasyon: timeout, kick, ban
• durum: setPresence

​

Bileşenler v2 kullanıcı arayüzü

• channels.discord.ui.components.accentColor, Discord bileşen kapsayıcıları tarafından kullanılan vurgu rengini ayarlar (hex).
• Hesap başına channels.discord.accounts.<id>.ui.components.accentColor ile ayarlayın.
• Bileşenler v2 mevcut olduğunda embeds yok sayılır.

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

​

Ses

​

Ses kanalları

1. Discord Developer Portal’da Message Content Intent’i etkinleştirin.
2. Rol/kullanıcı izin listeleri kullanıldığında Server Members Intent’i etkinleştirin.
3. Botu bot ve applications.commands kapsamlarıyla davet edin.
4. Hedef ses kanalında Connect, Speak, Send Messages ve Read Message History izinlerini verin.
5. Yerel komutları etkinleştirin (commands.native veya channels.discord.commands.native).
6. channels.discord.voice öğesini yapılandırın.

/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, yalnızca stt-tts ses çalma için messages.tts değerini geçersiz kılar. Realtime modları voice.realtime.voice kullanır.
• voice.mode, konuşma yolunu kontrol eder. Varsayılan agent-proxy değeridir: bir realtime ses ön ucu sıra zamanlamasını, kesintiyi ve oynatmayı yönetir, asıl işi openclaw_agent_consult üzerinden yönlendirilen OpenClaw ajanına devreder ve sonucu o konuşmacıdan gelen yazılı bir Discord istemi gibi ele alır. stt-tts, eski toplu STT artı TTS akışını korur. bidi, OpenClaw beyni için openclaw_agent_consult sunarken realtime modelin doğrudan sohbet etmesine izin verir.
• voice.agentSession, ses sıralarını hangi OpenClaw konuşmasının alacağını kontrol eder. Ses kanalının kendi oturumu için ayarsız bırakın veya ses kanalının #maintainers gibi mevcut bir Discord metin kanalı oturumunun mikrofon/hoparlör uzantısı gibi davranmasını sağlamak için { mode: "target", target: "channel:<text-channel-id>" } olarak ayarlayın.
• voice.model, Discord ses yanıtları ve realtime danışmaları için OpenClaw ajan beynini geçersiz kılar. Yönlendirilen ajan modelini devralmak için ayarsız bırakın. voice.realtime.model değerinden ayrıdır.
• agent-proxy, konuşmayı discord-voice üzerinden yönlendirir; bu, konuşmacı ve hedef oturum için normal sahip/araç yetkilendirmesini korur ancak Discord ses oynatmayı üstlendiği için ajanın tts aracını gizler. Varsayılan olarak agent-proxy, sahip konuşmacılar için danışmaya tam sahip eşdeğeri araç erişimi verir (voice.realtime.toolPolicy: "owner") ve asıl yanıtlardan önce OpenClaw ajanına danışmayı güçlü biçimde tercih eder (voice.realtime.consultPolicy: "always"). Bu varsayılan always modunda realtime katmanı danışma yanıtından önce otomatik olarak dolgu konuşması yapmaz; konuşmayı yakalar ve yazıya döker, ardından yönlendirilen OpenClaw yanıtını seslendirir. Discord ilk yanıtı hâlâ oynatırken birden fazla zorunlu danışma yanıtı tamamlanırsa, sonraki birebir konuşma yanıtları konuşmayı cümlenin ortasında değiştirmek yerine oynatma boşa çıkana kadar kuyruğa alınır.
• stt-tts modunda STT, tools.media.audio kullanır; voice.model yazıya dökmeyi etkilemez.
• Realtime modlarında voice.realtime.provider, voice.realtime.model ve voice.realtime.voice, realtime ses oturumunu yapılandırır. OpenAI Realtime 2 ve Codex beyni için voice.realtime.model: "gpt-realtime-2" ve voice.model: "openai-codex/gpt-5.5" kullanın.
• OpenAI realtime sağlayıcısı, geçerli Realtime 2 olay adlarını ve çıktı sesi ile transkript olayları için eski Codex uyumlu takma adları kabul eder; böylece uyumlu sağlayıcı anlık görüntüleri asistan sesini düşürmeden kayabilir.
• voice.realtime.bargeIn, Discord konuşmacı başlama olaylarının etkin realtime oynatmayı kesip kesmeyeceğini kontrol eder. Ayarsızsa realtime sağlayıcının giriş-sesi kesinti ayarını izler.
• voice.realtime.minBargeInAudioEndMs, bir OpenAI realtime araya girme işlemi sesi kısaltmadan önceki minimum asistan oynatma süresini kontrol eder. Varsayılan: 250. Düşük yankılı odalarda anında kesinti için 0 ayarlayın veya yankısı yoğun hoparlör kurulumları için yükseltin.
• Discord oynatmada OpenAI sesi için voice.tts.provider: "openai" ayarlayın ve voice.tts.openai.voice ya da voice.tts.providers.openai.voice altında bir Text-to-speech sesi seçin. cedar, geçerli OpenAI TTS modelinde erkeksi tınlayan iyi bir seçimdir.
• Kanal başına Discord systemPrompt geçersiz kılmaları, o ses kanalı için ses transkripti sıralarına uygulanır.
• Ses transkripti sıraları sahip durumunu Discord allowFrom (veya dm.allowFrom) üzerinden türetir; sahip olmayan konuşmacılar yalnızca sahiplere açık araçlara erişemez (örneğin gateway ve cron).
• Discord sesi, yalnızca metin yapılandırmaları için isteğe bağlıdır; /vc komutlarını, ses çalışma zamanını ve GuildVoiceStates Gateway intent’ini etkinleştirmek için channels.discord.voice.enabled=true ayarlayın (veya mevcut bir channels.discord.voice bloğunu koruyun).
• channels.discord.intents.voiceStates, ses durumu intent aboneliğini açıkça geçersiz kılabilir. Intent’in etkili ses etkinleştirmesini izlemesi için ayarsız bırakın.
• voice.autoJoin aynı guild için birden fazla giriş içeriyorsa OpenClaw, o guild için son yapılandırılan kanala katılır.
• voice.allowedChannels, isteğe bağlı bir ikamet izin listesidir. /vc join komutunun yetkili herhangi bir Discord ses kanalına girmesine izin vermek için ayarsız bırakın. Ayarlandığında /vc join, başlangıçta otomatik katılma ve bot ses durumu taşımaları listelenen { guildId, channelId } girişleriyle sınırlanır. Tüm Discord ses katılımlarını reddetmek için boş diziye ayarlayın. Discord botu izin listesinin dışına taşırsa OpenClaw o kanaldan ayrılır ve kullanılabilir olduğunda yapılandırılmış otomatik katılma hedefine yeniden katılır.
• voice.daveEncryption ve voice.decryptionFailureTolerance, @discordjs/voice katılma seçeneklerine aktarılır.
• Ayarsızsa @discordjs/voice varsayılanları daveEncryption=true ve decryptionFailureTolerance=24 değerleridir.
• OpenClaw, Discord ses alımı için varsayılan olarak saf JS opusscript çözücüsünü kullanır. İsteğe bağlı yerel @discordjs/opus paketi repo pnpm kurulum politikası tarafından yok sayılır; böylece normal kurulumlar, Docker hatları ve ilgisiz testler yerel bir eklenti derlemez. Özel ses performansı ana makineleri, yerel eklentiyi kurduktan sonra OPENCLAW_DISCORD_OPUS_DECODER=native ile bunu seçebilir.
• voice.connectTimeoutMs, /vc join ve otomatik katılma denemeleri için ilk @discordjs/voice Ready beklemesini kontrol eder. Varsayılan: 30000.
• voice.reconnectGraceMs, OpenClaw’ın bağlantısı kesilmiş bir ses oturumunu yok etmeden önce yeniden bağlanmaya başlamasını ne kadar bekleyeceğini kontrol eder. Varsayılan: 15000.
• stt-tts modunda, başka bir kullanıcı konuşmaya başladı diye ses oynatma durmaz. Geri besleme döngülerini önlemek için OpenClaw, TTS oynatılırken yeni ses yakalamayı yok sayar; sonraki sıra için oynatma bittikten sonra konuşun. Realtime modları konuşmacı başlangıçlarını araya girme sinyalleri olarak realtime sağlayıcıya iletir.
• Realtime modlarında, hoparlörlerden açık mikrofona gelen yankı araya girme gibi görünebilir ve oynatmayı kesebilir. Yankısı yoğun Discord odalarında OpenAI’nin giriş sesiyle otomatik kesinti yapmasını engellemek için voice.realtime.providers.openai.interruptResponseOnInputAudio: false ayarlayın. Discord konuşmacı başlama olaylarının etkin oynatmayı kesmesini hâlâ istiyorsanız voice.realtime.bargeIn: true ekleyin. OpenAI realtime köprüsü, voice.realtime.minBargeInAudioEndMs değerinden kısa oynatma kısaltmalarını olası yankı/gürültü olarak yok sayar ve Discord oynatmasını temizlemek yerine atlandı olarak günlüğe kaydeder.
• voice.captureSilenceGraceMs, Discord bir konuşmacının durduğunu bildirdikten sonra OpenClaw’ın o ses segmentini STT için sonlandırmadan önce ne kadar bekleyeceğini kontrol eder. Varsayılan: 2500; Discord normal duraklamaları kesik kesik kısmi transkriptlere bölüyorsa bunu yükseltin.
• ElevenLabs seçili TTS sağlayıcısı olduğunda Discord ses oynatma, streaming TTS kullanır ve sağlayıcı yanıt akışından başlar. Streaming desteği olmayan sağlayıcılar sentezlenmiş geçici dosya yoluna geri döner.
• OpenClaw ayrıca alma şifre çözme hatalarını izler ve kısa bir zaman aralığında tekrarlanan hatalardan sonra ses kanalından ayrılıp yeniden katılarak otomatik kurtarma yapar.
• Güncellemeden sonra alma günlükleri tekrar tekrar DecryptionFailed(UnencryptedWhenPassthroughDisabled) gösteriyorsa bir bağımlılık raporu ve günlükler toplayın. Paketlenen @discordjs/voice hattı, discord.js PR #11449’dan gelen upstream padding düzeltmesini içerir; bu düzeltme discord.js issue #11419’u kapatmıştır.
• The operation was aborted alma olayları, OpenClaw yakalanmış bir konuşmacı segmentini sonlandırdığında beklenir; bunlar ayrıntılı tanılardır, uyarı değildir.
• Ayrıntılı Discord ses günlükleri, kabul edilen her konuşmacı segmenti için sınırlandırılmış tek satırlık bir STT transkript önizlemesi içerir; böylece hata ayıklama, sınırsız transkript metni dökmeden hem kullanıcı tarafını hem de ajan yanıt tarafını gösterir.
• agent-proxy modunda zorunlu danışma geri dönüşü, ... ile biten metin veya and gibi sondaki bağlaçlar dahil muhtemelen eksik transkript parçalarını ve “be right back” ya da “bye” gibi açıkça eyleme geçirilemeyen kapanışları atlar. Bu, eski bir kuyruklanmış yanıtı önlediğinde günlükler forced agent consult skipped reason=... gösterir.

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

OPENCLAW_DISCORD_OPUS_DECODER=native pnpm gateway:watch

• Discord PCM yakalaması bir WAV geçici dosyasına dönüştürülür.
• tools.media.audio, STT’yi işler; örneğin openai/gpt-4o-mini-transcribe.
• Transkript, Discord girişi ve yönlendirmesi üzerinden gönderilir; yanıt LLM’i ise ajanın tts aracını gizleyen ve döndürülen metni isteyen bir ses-çıkışı politikasıyla çalışır, çünkü son TTS oynatmayı Discord sesi üstlenir.
• voice.model ayarlandığında, yalnızca bu ses kanalı sırası için yanıt LLM’ini geçersiz kılar.
• voice.tts, messages.tts üzerine birleştirilir; streaming yeteneği olan sağlayıcılar oynatıcıyı doğrudan besler, aksi halde ortaya çıkan ses dosyası katılınan kanalda oynatılır.

{
  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", bir Discord metin kanalı oturumu üzerinden yönlendirir.
• target: "123456789012345678", kanal hedefi olarak ele alınır.
• target: "dm:123456789012345678" veya target: "user:123456789012345678", o doğrudan mesaj oturumu üzerinden yönlendirir.

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

• Katılımda: discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...
• Realtime başlangıcında: discord voice: realtime bridge starting ... autoRespond=false interruptResponse=false bargeIn=false minBargeInAudioEndMs=...
• Konuşmacı sesinde: discord voice: realtime speaker turn opened ..., discord voice: realtime input audio started ... outputAudioMs=... outputActive=... ve discord voice: realtime speaker turn closed ... chunks=... discordBytes=... realtimeBytes=... interruptedPlayback=...
• Eski konuşma atlandığında: discord voice: realtime forced agent consult skipped reason=incomplete-transcript ... veya reason=non-actionable-closing ...
• Realtime yanıtı tamamlandığında: discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...
• Oynatma durduğunda/sıfırlandığında: discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...
• Realtime danışmada: discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...
• Agent yanıtında: discord voice: agent turn answer ...
• Kuyruğa alınan tam konuşmada: discord voice: realtime exact speech queued ... queued=... outputAudioMs=... outputActive=..., ardından discord voice: realtime exact speech dequeued reason=player-idle ...
• Araya girme algılandığında: discord voice: realtime barge-in detected source=speaker-start ... veya discord voice: realtime barge-in detected source=active-speaker-audio ..., ardından discord voice: realtime barge-in requested reason=... outputAudioMs=... outputActive=...
• Realtime kesintisinde: discord voice: realtime model interrupt requested client:response.cancel reason=barge-in, ardından discord voice: realtime model audio truncated client:conversation.item.truncate reason=barge-in audioEndMs=... veya discord voice: realtime model interrupt confirmed server:response.done status=cancelled ...
• Yok sayılan yankı/gürültüde: discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250
• Araya girme devre dışı olduğunda: discord voice: realtime capture ignored during playback (barge-in disabled) ...
• Boştaki oynatmada: discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0

1. realtime audio playback started, Discord’un asistan sesini oynatmaya başladığı anlamına gelir. Bridge, bu noktadan itibaren asistan çıktı parçalarını, Discord PCM baytlarını, sağlayıcı realtime baytlarını ve sentezlenen ses süresini saymaya başlar.
2. realtime speaker turn opened, bir Discord konuşmacısının etkin hale geldiğini belirtir. Oynatma zaten etkinse ve bargeIn etkinleştirilmişse, bunu barge-in detected source=speaker-start izleyebilir.
3. realtime input audio started, o konuşmacı sırası için alınan ilk gerçek ses karesini belirtir. Burada outputActive=true veya sıfır olmayan bir outputAudioMs, mikrofonun asistan oynatımı hâlâ etkinken giriş gönderdiği anlamına gelir.
4. barge-in detected source=active-speaker-audio, OpenClaw’un asistan oynatımı etkinken canlı konuşmacı sesi gördüğü anlamına gelir. Bu, gerçek bir kesintiyi işe yarar ses içermeyen bir Discord konuşmacı başlatma olayından ayırmak için yararlıdır.
5. barge-in requested reason=..., OpenClaw’un realtime sağlayıcıdan etkin yanıtı iptal etmesini veya kesmesini istediği anlamına gelir. Kesintiden önce gerçekte ne kadar asistan sesi oynatıldığını görebilmeniz için outputAudioMs, outputActive ve playbackChunks içerir.
6. realtime audio playback stopped reason=..., yerel Discord oynatma sıfırlama noktasıdır. Neden, oynatmayı kimin durdurduğunu söyler: barge-in, player-idle, provider-clear-audio, forced-agent-consult, stream-close veya session-close.
7. realtime speaker turn closed, yakalanan giriş sırasını özetler. chunks=0 veya hasAudio=false, konuşmacı sırasının açıldığını ama realtime bridge’e kullanılabilir ses ulaşmadığını gösterir. interruptedPlayback=true, bu giriş sırasının asistan çıktısıyla çakıştığını ve araya girme mantığını tetiklediğini gösterir.

• outputAudioMs: günlük satırından önce realtime sağlayıcı tarafından üretilen asistan ses süresi.
• audioMs: oynatma durmadan önce OpenClaw’un saydığı asistan ses süresi.
• elapsedMs: oynatma akışının veya konuşmacı sırasının açılması ile kapanması arasındaki duvar saati süresi.
• discordBytes: Discord voice’a gönderilen veya Discord voice’tan alınan 48 kHz stereo PCM baytları.
• realtimeBytes: realtime sağlayıcıya gönderilen veya sağlayıcıdan alınan sağlayıcı formatındaki PCM baytları.
• playbackChunks: etkin yanıt için Discord’a iletilen asistan ses parçaları.
• sinceLastAudioMs: yakalanan son konuşmacı ses karesi ile konuşmacı sırasının kapanması arasındaki boşluk.

• source=active-speaker-audio, küçük outputAudioMs ve yakında aynı kullanıcı ile anında kesilme, genellikle hoparlör yankısının mikrofona girdiğini gösterir. voice.realtime.minBargeInAudioEndMs değerini yükseltin, hoparlör sesini azaltın, kulaklık kullanın veya voice.realtime.providers.openai.interruptResponseOnInputAudio: false ayarlayın.
• source=speaker-start ardından speaker turn closed ... hasAudio=false, Discord’un bir konuşmacı başlangıcı bildirdiği ancak OpenClaw’a ses ulaşmadığı anlamına gelir. Bu geçici bir Discord voice olayı, gürültü kapısı davranışı veya istemcinin mikrofonu kısa süreliğine tetiklemesi olabilir.
• Yakınında araya girme veya provider-clear-audio olmadan audio playback stopped reason=stream-close, yerel Discord oynatma akışının beklenmedik şekilde sona erdiği anlamına gelir. Öncesindeki sağlayıcı ve Discord oynatıcı günlüklerini kontrol edin.
• capture ignored during playback (barge-in disabled), OpenClaw’un asistan sesi etkinken girişi bilerek attığı anlamına gelir. Konuşmanın oynatmayı kesmesini istiyorsanız voice.realtime.bargeIn seçeneğini etkinleştirin.
• barge-in ignored ... outputActive=false, Discord veya sağlayıcı VAD’nin konuşma bildirdiği ama OpenClaw’un kesilecek etkin oynatması olmadığı anlamına gelir. Bu, sesi kesmemelidir.

​

Sesli mesajlar

• Bir yerel dosya yolu sağlayın (URL’ler reddedilir).
• Metin içeriğini atlayın (Discord aynı payload içinde metin + sesli mesajı reddeder).
• Herhangi bir ses formatı kabul edilir; OpenClaw gerektiğinde OGG/Opus’a dönüştürür.

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

​

Sorun giderme

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

​

Yapılandırma referansı

​

Güvenlik ve işlemler

• Bot token’larını sır olarak ele alın (denetimli ortamlarda DISCORD_BOT_TOKEN tercih edilir).
• En az ayrıcalıklı Discord izinleri verin.
• Komut dağıtımı/durumu güncel değilse gateway’i yeniden başlatın ve openclaw channels status --probe ile yeniden kontrol edin.

​

İlgili