Discord

Discord'un resmi Gateway'i üzerinden DM'ler ve guild kanalları için hazır.

Hızlı kurulum

Bot içeren yeni bir uygulama oluşturmanız, botu sunucunuza eklemeniz ve OpenClaw ile eşleştirmeniz gerekir. Botunuzu kendi özel sunucunuza eklemenizi öneririz. Henüz bir sunucunuz yoksa, önce bir tane oluşturun (Create My Own > For me and my friends seçin).

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" },},},}JSON5openclaw config patch --file ./discord.patch.json5 --dry-runopenclaw config patch --file ./discord.patch.json5openclaw 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 discordopenclaw pairing approve discord <CODE>

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

DM'ler çalıştıktan sonra, Discord sunucunuzu her kanalın kendi bağlamına sahip ayrı bir ajan oturumu aldığı tam bir çalışma alanı olarak kurabilirsiniz. Bu, yalnızca sizin ve botunuzun bulunduğu özel sunucular için önerilir.

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

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

Şimdi Discord sunucunuzda birkaç kanal oluşturun ve sohbete başlayın. Ajanınız kanal adını görebilir ve her kanal kendi yalıtılmış oturumunu alır; böylece #coding, #home, #research veya iş akışınıza uyan başka herhangi bir şeyi kurabilirsiniz.

Ç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ı

Discord forum ve medya kanalları yalnızca iş parçacığı gönderilerini kabul eder. OpenClaw bunları oluşturmak için iki yolu destekler:

• 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.

Örnek: iş parçacığı oluşturmak için forum üst öğesine gönderin

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

Örnek: bir forum iş parçacığını açıkça oluşturun

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

Forum üst öğeleri Discord bileşenlerini kabul etmez. Bileşenlere ihtiyacınız varsa, iş parçacığının kendisine gönderin (channel:<threadId>).

Etkileşimli bileşenler

OpenClaw, ajan mesajları için Discord components v2 kapsayıcılarını destekler. components yüküyle mesaj aracını kullanın. Etkileşim sonuçları normal gelen mesajlar olarak ajana geri yönlendirilir ve mevcut Discord replyToMode ayarlarını izler.

Desteklenen bloklar:

• 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

Varsayılan olarak bileşenler tek kullanımlıktır. Düğmelerin, seçimlerin ve formların süreleri dolana kadar birden çok kez kullanılmasına izin vermek için components.reusable=true ayarlayın.

Bir düğmeye kimin tıklayabileceğini kısıtlamak için, o düğmede allowedUsers ayarlayın (Discord kullanıcı kimlikleri, etiketler veya *). Yapılandırıldığında, eşleşmeyen kullanıcılar geçici bir ret alır.

/model ve /models slash komutları; sağlayıcı, model ve uyumlu çalışma zamanı açılır menülerinin yanı sıra bir Gönder adımı içeren etkileşimli bir model seçici açar. /models add kullanımdan kaldırılmıştır ve artık sohbetten model kaydetmek yerine bir kullanımdan kaldırma mesajı döndürür. Seçici yanıtı geçicidir ve yalnızca komutu çağıran kullanıcı bunu kullanabilir. Discord seçim menüleri 25 seçenekle sınırlıdır, bu nedenle seçicinin dinamik olarak keşfedilen modelleri yalnızca openai-codex veya vllm gibi seçili sağlayıcılar için göstermesini istediğinizde agents.defaults.models içine provider/* girdileri ekleyin.

Dosya ekleri:

• 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

Modal formlar:

• 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

Örnek:

{  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

Discord sunucu üyelerini rol kimliğine göre farklı ajanlara yönlendirmek için bindings[].match.roles kullanın. Rol tabanlı bağlamalar yalnızca rol kimliklerini kabul eder ve eş ya da üst-eş bağlamalardan sonra, yalnızca sunucu bağlamalarından önce değerlendirilir. Bir bağlama başka eşleşme alanları da ayarlıyorsa (örneğin peer + guildId + roles), yapılandırılmış tüm alanlar eşleşmelidir.

{  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.

Komut kataloğu ve davranış için Eğik çizgi komutları bölümüne bakın.

Varsayılan eğik çizgi komutu ayarları:

• 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ı

Discord mesaj eylemleri mesajlaşma, kanal yöneticisi, moderasyon, durum ve meta veri eylemlerini içerir.

Temel örnekler:

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

event-create eylemi, planlanmış etkinlik kapak görselini ayarlamak için isteğe bağlı bir image parametresini (URL veya yerel dosya yolu) kabul eder.

Eylem kapıları channels.discord.actions.* altında bulunur.

Varsayılan kapı davranışı:

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

OpenClaw, exec onayları ve bağlamlar arası işaretleyiciler için Discord bileşenleri v2'yi kullanır. Discord mesaj eylemleri özel kullanıcı arayüzü için components da kabul edebilir (ileri düzey; discord aracıyla bir bileşen yükü oluşturmayı gerektirir), eski embeds ise kullanılabilir kalır ancak önerilmez.

• 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.

Örnek:

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

Ses

Discord'un iki ayrı ses yüzeyi vardır: gerçek zamanlı ses kanalları (sürekli konuşmalar) ve sesli mesaj ekleri (dalga formu önizleme biçimi). Gateway her ikisini de destekler.

Ses kanalları

Kurulum kontrol listesi:

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.

Oturumları kontrol etmek için /vc join|leave|status kullanın. Komut, hesabın varsayılan aracısını kullanır ve diğer Discord komutlarıyla aynı izin listesi ve grup ilkesi kurallarını izler.

/vc join channel:<voice-channel-id>/vc status/vc leave

Katılmadan önce botun etkin izinlerini incelemek için şunu çalıştırın:

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

Otomatik katılma örneği:

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

Notlar:

• 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.

Kaynak checkout'ları için yerel opus kurulumu:

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

Upstream macOS arm64 önceden derlenmiş yerel eklentiyi istediğinizde Gateway için Node 22 kullanın. Başka bir Node çalışma zamanı kullanırsanız isteğe bağlı kurucunun yerel bir node-gyp kaynak derleme araç zincirine ihtiyacı olabilir.

Yerel eklentiyi kurduktan sonra Gateway'i şununla başlatın:

OPENCLAW_DISCORD_OPUS_DECODER=native pnpm gateway:watch

Ayrıntılı ses günlükleri discord voice: opus decoder: @discordjs/opus göstermelidir. Env seçimi olmadan veya yerel eklenti eksikse ya da ana makinede yüklenemiyorsa OpenClaw discord voice: opus decoder: opusscript günlüğünü yazar ve saf JS geri dönüşü üzerinden ses almaya devam eder.

STT artı TTS pipeline'ı:

• 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.

Varsayılan agent-proxy ses kanalı oturumu örneği:

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

voice.agentSession bloğu olmadığında her ses kanalı kendi yönlendirilmiş OpenClaw oturumunu alır. Örneğin /vc join channel:234567890123456789, o Discord ses kanalının oturumuyla konuşur. Realtime model yalnızca ses ön ucudur; asıl istekler yapılandırılmış OpenClaw ajanına aktarılır. Realtime model danışma aracını çağırmadan nihai bir transkript üretirse OpenClaw, varsayılanın hâlâ ajanla konuşmak gibi davranması için danışmayı geri dönüş olarak zorlar.

Eski STT artı TTS örneği:

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

Realtime bidi örneği:

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

Mevcut bir Discord kanal oturumunun uzantısı olarak ses:

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

agent-proxy modunda bot yapılandırılmış ses kanalına katılır, ancak OpenClaw ajan sıraları hedef kanalın normal yönlendirilmiş oturumunu ve ajanını kullanır. Realtime ses oturumu döndürülen sonucu ses kanalına geri seslendirir. Supervisor ajan, doğru eylem buysa ayrı bir Discord mesajı göndermek dahil olmak üzere araç politikasına göre normal mesaj araçlarını hâlâ kullanabilir.

Yararlı hedef biçimleri:

• 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.

Yankısı yoğun OpenAI Realtime örneği:

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

Model kendi Discord oynatımını açık bir mikrofon üzerinden duyduğunda, ama yine de konuşarak onu kesmek istediğinizde bunu kullanın. OpenClaw, OpenAI'ın ham giriş sesinde otomatik kesinti yapmasını engellerken, bargeIn: true Discord konuşmacı başlatma olaylarının ve zaten etkin olan konuşmacı sesinin, bir sonraki yakalanan sıra OpenAI'a ulaşmadan önce etkin realtime yanıtlarını iptal etmesine izin verir. audioEndMs değeri minBargeInAudioEndMs altında olan çok erken araya girme sinyalleri olası yankı/gürültü olarak değerlendirilir ve yok sayılır; böylece model ilk oynatma karesinde kesilmez.

Beklenen ses günlükleri:

• 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

Kesilen sesi hata ayıklamak için realtime ses günlüklerini bir zaman çizelgesi olarak okuyun:

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.

Yararlı alanlar:

• 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.

Yaygın örüntüler:

• 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.

Kimlik bilgileri bileşen başına çözümlenir: voice.model için LLM rota kimlik doğrulaması, tools.media.audio için STT kimlik doğrulaması, messages.tts/voice.tts için TTS kimlik doğrulaması ve voice.realtime.providers veya sağlayıcının normal kimlik doğrulama yapılandırması için realtime sağlayıcı kimlik doğrulaması.

Sesli mesajlar

Discord sesli mesajları bir dalga formu önizlemesi gösterir ve OGG/Opus ses gerektirir. OpenClaw dalga formunu otomatik olarak üretir, ancak incelemek ve dönüştürmek için gateway ana makinesinde ffmpeg ve ffprobe gerekir.

• 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 doctoropenclaw channels status --probeopenclaw 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ı

Birincil referans: Yapılandırma referansı - Discord.

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