Discord

OpenClaw, resmi Discord gateway üzerinden bir bot olarak Discord'a bağlanır. DM'ler ve sunucu kanalları desteklenir.

Hızlı kurulum

Bot içeren bir Discord uygulaması oluşturun, botu sunucunuza ekleyin ve OpenClaw ile eşleştirin. Mümkünse özel bir sunucu kullanın; gerekirse önce bir tane oluşturun (Create My Own > For me and my friends).

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 sunucu çalışma alanı kurun

DM'ler çalışmaya başladıktan sonra sunucunuzu, her kanalın kendi bağlamıyla birlikte kendi agent oturumunu aldığı tam bir çalışma alanına dönüştürebilirsiniz. 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 kanallar oluşturun ve sohbet etmeye başlayın. Agent kanal adını görür ve her kanal yalıtılmış bir oturumdur; iş akışınıza uygun olarak #coding, #home, #research veya başka kanallar oluşturun.

Çalışma zamanı modeli

• Gateway, Discord bağlantısının sahibidir.
• Yanıt yönlendirmesi belirlenimseldir: Discord'dan gelen iletilerin yanıtları Discord'a geri gönderilir.
• Discord sunucu/kanal meta verileri, kullanıcıya görünür yanıt ön eki olarak değil, güvenilmeyen bağlam olarak model istemine eklenir. Bir model bu zarfı yanıta kopyalarsa OpenClaw, kopyalanan meta verileri giden yanıtlardan ve gelecekte yeniden oynatılacak bağlamdan kaldırır.
• Varsayılan olarak (session.dmScope=main), doğrudan sohbetler agent'ın ana oturumunu (agent:main:main) paylaşır.
• 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 eğik çizgi komutları yalıtılmış komut oturumlarında (agent:<agentId>:discord:slash:<userId>) çalışırken CommandTargetSessionKey değerini yönlendirilen konuşma oturumuna taşımaya devam eder.
• Discord'a yalnızca metin içeren Cron/Heartbeat duyurularının teslimi, bir kez gönderilen ve asistana görünür olan son yanıta indirgenir. Agent birden fazla teslim edilebilir yük oluşturduğunda medya ve yapılandırılmış bileşen yükleri birden fazla mesaj olarak kalır.

Forum kanalları

Discord forum ve medya kanalları yalnızca ileti dizisi gönderilerini kabul eder. OpenClaw bunları oluşturmak için iki yöntem destekler:

• Bir ileti dizisini otomatik olarak oluşturmak için forum üst kanalına (channel:<forumId>) mesaj gönderin. İleti dizisi başlığı, mesajın boş olmayan ilk satırıdır (Discord'un 100 karakterlik ileti dizisi adı sınırına göre kısaltılır).
• Doğrudan bir ileti dizisi oluşturmak için openclaw message thread create kullanın. Forum kanalları için --message-id iletmeyin.

Bir ileti dizisi oluşturmak için forum üst kanalına gönderin:

openclaw message send --channel discord --target channel:<forumId> \  --message "Konu başlığı\nGönderinin içeriği"

Açıkça bir forum ileti dizisi oluşturun:

openclaw message thread create --channel discord --target channel:<forumId> \  --thread-name "Konu başlığı" --message "Gönderinin içeriği"

Forum üst kanalları Discord bileşenlerini kabul etmez. Bileşenlere ihtiyacınız varsa doğrudan ileti dizisine (channel:<threadId>) gönderin.

Etkileşimli bileşenler

OpenClaw, ajan mesajları için Discord bileşenleri v2 kapsayıcılarını destekler. Mesaj aracını bir components yüküyle 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

Bileşenler varsayılan olarak 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 ayarını yapın.

Bir düğmeye kimlerin tıklayabileceğini kısıtlamak için o düğmede allowedUsers ayarını yapın (Discord kullanıcı kimlikleri, etiketleri veya *). Eşleşmeyen kullanıcılar yalnızca kendilerine görünen bir ret bildirimi alır.

Bileşen geri çağrılarının süresi varsayılan olarak 30 dakika sonra dolar. Varsayılan hesabın geri çağrı kayıt defteri ömrünü değiştirmek için channels.discord.agentComponents.ttlMs, hesap başına değiştirmek için ise channels.discord.accounts.<accountId>.agentComponents.ttlMs ayarını yapın. Değer milisaniye cinsindedir, pozitif bir tam sayı olmalıdır ve 86400000 (24 saat) ile sınırlandırılmıştır. Daha uzun TTL'ler, düğmelerin kullanılabilir kalmasını gerektiren inceleme/onay iş akışlarına uygundur; ancak eski bir Discord mesajının hâlâ bir eylemi tetikleyebileceği süreyi uzatırlar. İhtiyacı karşılayan en kısa TTL'yi tercih edin ve eski geri çağrıların beklenmedik olacağı durumlarda varsayılanı koruyun.

/model ve /models eğik çizgi komutları; sağlayıcı, model ve uyumlu çalışma zamanı açılır listelerinin yanı sıra bir Gönder adımı içeren etkileşimli bir model seçici açar. /models add kullanım dışıdır ve modelleri sohbetten kaydetmek yerine kullanımdan kaldırma mesajı döndürür. Seçici yanıtı yalnızca çağıran kullanıcı tarafından görülebilir ve kullanılabilir. 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 veya vllm gibi seçili sağlayıcılar için göstermesini istediğinizde agents.defaults.modelPolicy.allow içine provider/* girdileri ekleyin.

Dosya ekleri:

• file blokları bir ek referansını (attachment://<filename>) göstermelidir
• Eki media/path/filePath üzerinden sağlayın (tek dosya); birden çok dosya için media-gallery kullanın
• Yükleme adının ek referansıyla eşleşmesi gerektiğinde adı geçersiz kılmak için filename kullanın

Kalıcı pencere formları:

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

Örnek:

{  channel: "discord",  action: "send",  to: "channel:123456789012345678",  message: "İsteğe bağlı yedek metin",  components: {    reusable: true,    text: "Bir yol seçin",    blocks: [      {        type: "actions",        buttons: [          {            label: "Onayla",            style: "success",            allowedUsers: ["123456789012345678"],          },          { label: "Reddet", style: "danger" },        ],      },      {        type: "actions",        select: {          type: "string",          placeholder: "Bir seçenek belirleyin",          options: [            { label: "Seçenek A", value: "a" },            { label: "Seçenek B", value: "b" },          ],        },      },    ],    modal: {      title: "Ayrıntılar",      triggerLabel: "Formu aç",      fields: [        { type: "text", label: "Talep eden" },        {          type: "select",          label: "Öncelik",          options: [            { label: "Düşük", value: "low" },            { label: "Yüksek", 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: { enabled: true },        help: { enabled: 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ş veya üst eş bağlamalarından 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ğerini alır ve Discord için etkindir.
• Kanal bazında geçersiz kılma: channels.discord.commands.native.
• commands.native=false, başlangıç sırasında Discord eğik çizgi komutlarının kaydedilmesini ve temizlenmesini atlar. Daha önce kaydedilmiş komutlar, Discord uygulamasından kaldırılana kadar Discord'da görünür kalabilir.
• Yerel komut kimlik doğrulaması, normal mesaj işleme ile aynı Discord izin listelerini/ilkelerini kullanır.
• Komutlar, yetkisiz kullanıcılar için Discord kullanıcı arayüzünde görünmeye devam edebilir; yürütme sırasında OpenClaw kimlik doğrulaması uygulanır ve "yetkili değil" yanıtı verilir.
• Varsayılan eğik çizgi komutu ayarları: ephemeral: true (channels.discord.slashCommand.ephemeral).

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

Özellik ayrıntıları

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

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

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

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

{channels: {discord: {  subagentProgress: true,},},}

{agents: {entries: {  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: {      intents: { presence: true },      guilds: {        "111111111111111111": {          presenceEvents: {            channelId: "222222222222222222",            users: ["333333333333333333"], // isteğe bağlı; kanal görüntüleyicilerini daha da daraltır            reconnectSuppressSeconds: 300, // isteğe bağlı; yeni oturum sessizlik aralığı (0 devre dışı bırakır)            burstLimit: 8, // isteğe bağlı; ani yoğunluk aralığı başına maksimum olay            burstWindowSeconds: 60, // isteğe bağlı; kayan ani yoğunluk algılama aralığı          },        },      },    },  },}

{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_...", // isteğe bağlı; özel sistemler için gereklidir  },},},}

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

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

{channels: {discord: {  activity: "Odaklanma zamanı",  activityType: 4,},},}

{channels: {discord: {  activity: "Canlı kodlama",  activityType: 1,  activityUrl: "https://twitch.tv/openclaw",},},}

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

Araçlar ve eylem geçitleri

Discord mesaj eylemleri; mesajlaşma, kanal yönetimi, moderasyon, iletişim durumu ve meta verileri kapsar.

Temel örnekler:

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

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

Eylem geçitleri channels.discord.actions.* altında bulunur.

Varsayılan geçit davranışı:

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

OpenClaw, yürütme onayları ve bağlamlar arası işaretçiler için Discord bileşenleri v2'yi kullanır. Discord mesaj eylemleri, özel kullanıcı arayüzü için components değerini de kabul edebilir (ileri düzey; discord aracı aracılığıyla bir bileşen yükü oluşturulmasını gerektirir); eski embeds ise kullanılmaya devam edilebilir ancak önerilmez.

• channels.discord.ui.components.accentColor, Discord bileşen kapsayıcılarının kullandığı vurgu rengini (onaltılık) ayarlar. Hesap başına: channels.discord.accounts.<id>.ui.components.accentColor.
• channels.discord.agentComponents.ttlMs, gönderilen Discord bileşeni geri çağırmalarının ne kadar süreyle kayıtlı kalacağını denetler (varsayılan 1800000, en fazla 86400000). Hesap başına: channels.discord.accounts.<id>.agentComponents.ttlMs.
• embeds, bileşenler v2 mevcut olduğunda yok sayılır.
• Düz URL önizlemeleri varsayılan olarak engellenir. Tek bir giden bağlantının genişletilmesi gerektiğinde mesaj eyleminde suppressEmbeds: false değerini ayarlayın.

Örnek:

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

Ses

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

Ses kanalları

Kurulum denetim listesi:

1. Discord Developer Portal'da Message Content Intent seçeneğini etkinleştirin.
2. Rol/kullanıcı izin listeleri kullanıldığında Server Members Intent seçeneğini 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ı (commands.native veya channels.discord.commands.native) etkinleştirin.
6. channels.discord.voice yapılandırmasını yapın.

Oturumları denetlemek 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 politikası kurallarına uyar.

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

Katılmadan önce botun geçerli izinlerini incelemek için:

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

Otomatik katılım örneği:

{  channels: {    discord: {      voice: {        enabled: true,        model: "openai/gpt-5.6-sol",        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.1",          speakerVoice: "cedar",        },      },    },  },}

Notlar:

• Discord ses özelliği, 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 ayarını yapın (veya mevcut bir channels.discord.voice bloğunu koruyun). channels.discord.intents.voiceStates, intent aboneliğini açıkça geçersiz kılabilir; etkin ses ayarını izlemesi için ayarlamadan bırakın.
• voice.mode, konuşma yolunu denetler. Varsayılan değer agent-proxy şeklindedir: gerçek zamanlı bir ses ön ucu söz alma zamanlamasını, kesintiyi ve oynatmayı yönetir; esas işleri openclaw_agent_consult aracılığıyla yönlendirilmiş OpenClaw aracısına devreder ve sonucu, o konuşmacıdan yazılı bir Discord istemi gibi değerlendirir. stt-tts, eski toplu STT ve TTS akışını korur. bidi, OpenClaw beyni için openclaw_agent_consult özelliğini sunarken gerçek zamanlı modelin doğrudan konuşmasına olanak tanır.
• voice.agentSession, sesli konuşma sıralarını hangi OpenClaw konuşmasının alacağını denetler. Ses kanalının kendi oturumu için ayarlamadan bırakın veya ses kanalını #maintainers gibi mevcut bir Discord metin kanalı oturumunun mikrofon/hoparlör uzantısı hâline getirmek için { mode: "target", target: "channel:<text-channel-id>" } olarak ayarlayın.
• voice.model, Discord sesli yanıtları ve gerçek zamanlı danışmalar için OpenClaw aracı beynini geçersiz kılar. Yönlendirilmiş aracı modelini devralması için ayarlamadan bırakın. Bu ayar voice.realtime.model ayarından ayrıdır.
• voice.followUsers, botun seçili kullanıcılarla birlikte Discord ses kanallarına katılmasına, kanallar arasında geçiş yapmasına ve kanallardan ayrılmasına olanak tanır. Bkz. Ses kanalında kullanıcıları takip etme.
• agent-proxy, konuşmayı discord-voice üzerinden yönlendirir; bu, konuşmacı ve hedef oturum için normal sahip/araç yetkilendirmesini korur ancak oynatma Discord ses özelliğine ait olduğundan aracının tts aracını gizler. Varsayılan olarak agent-proxy, sahip konuşmacılar (voice.realtime.toolPolicy: "owner") için danışmaya sahip eşdeğeri tam araç erişimi verir ve esas yanıtları vermeden önce OpenClaw aracısına danışılmasını özellikle tercih eder (voice.realtime.consultPolicy: "always"). Bu varsayılan always modunda gerçek zamanlı katman, danışma yanıtından önce dolgu ifadelerini otomatik olarak seslendirmez; konuşmayı yakalayıp metne dönüştürür ve ardından yönlendirilmiş OpenClaw yanıtını seslendirir. Discord ilk yanıtı oynatmaya devam ederken birden fazla zorunlu danışma yanıtı tamamlanırsa sonraki tam konuşma yanıtları, cümlenin ortasında konuşmanın yerini almak yerine oynatma boşta kalana kadar kuyruğa alınır.
• stt-tts modunda STT, tools.media.audio kullanır; voice.model, transkripsiyonu etkilemez.
• Gerçek zamanlı modlarda voice.realtime.provider, voice.realtime.model ve voice.realtime.speakerVoice, gerçek zamanlı ses oturumunu yapılandırır. OpenAI Realtime 2.1 ve Codex beyni için voice.realtime.model: "gpt-realtime-2.1" ve voice.model: "openai/gpt-5.6-sol" kullanın.
• Gerçek zamanlı ses modları, hızlı doğrudan konuşma sıralarının yönlendirilmiş OpenClaw aracısıyla aynı kimliği, kullanıcı temellendirmesini ve kişiliği koruması için varsayılan olarak küçük IDENTITY.md, USER.md ve SOUL.md profil dosyalarını gerçek zamanlı sağlayıcı talimatlarına dahil eder. Bunu özelleştirmek için voice.realtime.bootstrapContextFiles değerini bir alt küme olarak, devre dışı bırakmak içinse [] olarak ayarlayın. Yalnızca bu profil dosyaları desteklenir; AGENTS.md normal aracı bağlamında kalır. Eklenen profil bağlamı; çalışma alanı çalışmaları, güncel bilgiler, bellek araması veya araç destekli eylemler için openclaw_agent_consult yerine geçmez.
• OpenAI agent-proxy gerçek zamanlı modunda uyandırma adı denetimi varsayılan olarak odaya uyum sağlar: tek bir kişi uyandırma adı kullanmadan doğal biçimde konuşabilirken iki veya daha fazla kişinin konuşma sırasına bir uyandırma adıyla başlaması veya sırayı bu adla bitirmesi gerekir. Diğer botlar kişi sayılmaz. Her zaman uyandırma adı gerektirmek için voice.realtime.requireWakeName: true, hiçbir zaman gerektirmemek için false olarak ayarlayın. Yapılandırılan uyandırma adları bir veya iki sözcükten oluşmalıdır. voice.realtime.wakeNames ayarlanmamışsa OpenClaw, yönlendirilmiş aracının name değerini ve OpenClaw değerini kullanır; bunlar yoksa aracı kimliği ile OpenClaw değerini kullanır. Etkin bir uyandırma adı denetimi, gerçek zamanlı sağlayıcının otomatik yanıtını devre dışı bırakır, kabul edilen konuşma sıralarını OpenClaw aracı danışma yolu üzerinden yönlendirir ve son transkript ulaşmadan önce kısmi transkripsiyonda baştaki bir uyandırma adı algılandığında kısa bir sesli onay verir. Politika, ses bağlantısını yeniden kurmadan canlı katılma ve ayrılmaları izler.
• OpenAI gerçek zamanlı sağlayıcısı, çıkış sesi ve transkript olayları için güncel Realtime 2 olay adlarını ve eski Codex uyumlu diğer adları kabul eder; böylece uyumlu sağlayıcı anlık görüntüleri, asistan sesini kaybetmeden farklılaşabilir.
• voice.realtime.bargeIn, Discord konuşmacı başlangıcı olaylarının etkin gerçek zamanlı oynatmayı kesip kesmeyeceğini denetler. Ayarlanmamışsa gerçek zamanlı sağlayıcının giriş sesi kesintisi ayarını izler.
• voice.realtime.minBargeInAudioEndMs, OpenAI gerçek zamanlı araya girme işleminin sesi kesmesinden önce gereken minimum asistan oynatma süresini denetler. Varsayılan: 250. Yankının az olduğu odalarda anında kesinti için 0 olarak ayarlayın; hoparlör kurulumunda yoğun yankı varsa değeri yükseltin.
• voice.tts, yalnızca stt-tts ses oynatımı için tts ayarını geçersiz kılar; gerçek zamanlı modlar bunun yerine voice.realtime.speakerVoice kullanır. Discord oynatımında bir OpenAI sesi kullanmak için voice.tts.provider: "openai" ayarını yapın ve voice.tts.providers.openai.speakerVoice altında bir Metinden sese ses seçin. cedar, güncel OpenAI TTS modelinde erkeksi tınıya sahip iyi bir seçenektir.
• Kanal bazındaki Discord systemPrompt geçersiz kılmaları, ilgili ses kanalının ses transkripti konuşma sıralarına uygulanır.
• OpenClaw bir ses kanalına katıldığında yönlendirilmiş aracı oturumu, güncel katılımcı listesini içeren sessiz bir sistem olayı alır. Katılımcıların daha sonra katılması ve ayrılması, istenmeyen bir sesli yanıtı tetiklemeden bu oturumu günceller; Discord görünen adları güvenilmeyen etiketler olarak değerlendirilir. Yetkilendirilmiş sesli konuşma sıraları da güncel bir katılımcı listesi anlık görüntüsü alır.
• Ses transkripti konuşma sıraları ve /vc komutları, sahip durumu için commands.ownerAllowFrom içindeki Discord girdilerini kullanır. Hiçbir Discord komut sahibi yapılandırılmadığında seçili Discord hesabının allowFrom değeri (veya eski dm.allowFrom) sahip durumu vermeden ses erişimini yetkilendirmeye devam edebilir. Aracı araçlarının görünürlüğü, yönlendirilmiş oturum için yapılandırılan araç politikasını izler.
• voice.autoJoin aynı sunucu için birden fazla girdi içeriyorsa OpenClaw, o sunucu için son yapılandırılan kanala katılır.
• voice.allowedChannels, isteğe bağlı bir bulunma izin listesidir. /vc join komutunun yetkilendirilmiş herhangi bir Discord ses kanalına katılmasına izin vermek için ayarlamadan bırakın. Ayarlandığında /vc join, başlangıçta otomatik katılma ve bot ses durumu geçişleri, listelenen { guildId, channelId } girdileriyle sınırlandırılır. Tüm Discord ses kanalı katılımlarını reddetmek için boş bir dizi olarak ayarlayın. Discord botu izin listesinin dışına taşırsa OpenClaw o kanaldan ayrılır ve varsa yapılandırılmış otomatik katılma hedefine yeniden katılır.
• voice.daveEncryption ve voice.decryptionFailureTolerance, @discordjs/voice katılma seçeneklerine doğrudan aktarılır; üst kaynak varsayılanları daveEncryption=true ve decryptionFailureTolerance=24 değerleridir.
• OpenClaw, Discord ses alımı ve gerçek zamanlı ham PCM oynatımı için paketle gelen libopus-wasm codec'ini kullanır. Sabitlenmiş bir libopus WebAssembly derlemesiyle gelir ve yerel opus eklentileri gerektirmez.
• voice.connectTimeoutMs, /vc join ve otomatik katılma denemeleri için ilk @discordjs/voice Ready bekleme süresini denetler. Varsayılan: 30000.
• voice.reconnectGraceMs, bağlantısı kesilmiş bir ses oturumunu yok etmeden önce OpenClaw'ın yeniden bağlanmaya başlaması için ne kadar bekleyeceğini denetler. Varsayılan: 15000.
• stt-tts modunda ses oynatımı, yalnızca başka bir kullanıcı konuşmaya başladığı için durmaz. Geri besleme döngülerini önlemek üzere OpenClaw, TTS oynatılırken yeni ses yakalamayı yok sayar; sonraki konuşma sırası için oynatma bittikten sonra konuşun. Gerçek zamanlı modlar, konuşmacı başlangıçlarını araya girme sinyalleri olarak gerçek zamanlı sağlayıcıya iletir.
• Gerçek zamanlı modlarda hoparlörlerden açık mikrofona giren yankı, araya girme olarak algılanıp oynatmayı kesebilir. Yankının yoğun olduğu Discord odalarında OpenAI'ın giriş sesi nedeniyle otomatik kesinti yapmasını önlemek için voice.realtime.providers.openai.interruptResponseOnInputAudio: false ayarını yapın. Discord konuşmacı başlangıcı olaylarının etkin oynatmayı yine de kesmesini istiyorsanız voice.realtime.bargeIn: true ekleyin. OpenAI gerçek zamanlı köprüsü, voice.realtime.minBargeInAudioEndMs değerinden kısa oynatma kesmelerini olası yankı/gürültü olarak yok sayar ve Discord oynatımını temizlemek yerine bunları atlandı olarak günlüğe kaydeder.
• voice.captureSilenceGraceMs, Discord bir konuşmacının durduğunu bildirdikten sonra OpenClaw'ın bu ses parçasını STT için sonlandırmadan önce ne kadar bekleyeceğini denetler. Varsayılan: 2000; Discord normal duraklamaları kesintili kısmi transkriptlere bölüyorsa değeri yükseltin.
• Seçili TTS sağlayıcısı ElevenLabs olduğunda Discord ses oynatımı akışlı TTS kullanır ve sağlayıcının yanıt akışından başlar. Akış desteği olmayan sağlayıcılar, sentezlenmiş geçici dosya yoluna geri döner.
• OpenClaw, alım şifresi çözme hatalarını izler ve kısa bir zaman aralığında tekrarlanan hatalardan sonra ses kanalından ayrılıp yeniden katılarak otomatik olarak kurtarır.
• Güncellemeden sonra alım günlüklerinde tekrar tekrar DecryptionFailed(UnencryptedWhenPassthroughDisabled) görülüyorsa bir bağımlılık raporu ve günlükleri toplayın. Paketle gelen @discordjs/voice satırı, discord.js PR #11449'daki üst kaynak dolgu düzeltmesini içerir; bu düzeltme discord.js issue #11419'u kapatmıştır.
• The operation was aborted alım olayları, OpenClaw yakalanmış bir konuşmacı parçasını sonlandırdığında beklenir; bunlar ayrıntılı tanılama iletileridir, uyarı değildir.
• Ayrıntılı Discord ses günlükleri, kabul edilen her konuşmacı parçası için sınırlandırılmış tek satırlık bir STT transkript önizlemesi içerir; böylece hata ayıklama sırasında sınırsız transkript metni dökülmeden hem kullanıcı tarafı hem de aracı yanıtı tarafı gösterilir.
• agent-proxy modunda zorunlu danışma geri dönüşü; ... ile biten metinler, "and" gibi sondaki bağlaçlar veya "be right back" ya da "bye" gibi açıkça eylem gerektirmeyen kapanışlar gibi tamamlanmamış olması muhtemel transkript parçalarını atlar. Bu işlem eski bir kuyruklanmış yanıtı önlediğinde günlüklerde forced agent consult skipped reason=... gösterilir.

Ses kanalında kullanıcıları takip etme

Discord ses botunun başlangıçta sabit bir kanala katılması veya /vc join komutunu beklemesi yerine bilinen bir ya da daha fazla Discord kullanıcısıyla birlikte kalmasını istediğinizde voice.followUsers kullanın.

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

Davranış:

• followUsers, ham Discord kullanıcı kimliklerini ve discord:<id> değerlerini kabul eder. OpenClaw, ses durumu olaylarını eşleştirmeden önce her iki biçimi de normalleştirir.
• followUsersEnabled, followUsers yapılandırıldığında varsayılan olarak true değerini alır. Kaydedilen listeyi koruyup otomatik ses takibini durdurmak için bunu false olarak ayarlayın.
• followUsers yalnızca ses kanalında bulunmayı denetler. Konuşmacı erişimi veya sahip yetkisi vermez; commands.ownerAllowFrom ile sunucu ya da kanal kullanıcılarını ve rollerini ayrı ayrı yapılandırın.
• Takip edilen bir kullanıcı izin verilen bir ses kanalına katıldığında OpenClaw da bu kanala katılır. Kullanıcı başka bir kanala geçtiğinde OpenClaw da onunla birlikte geçer. Etkin olarak takip edilen kullanıcının bağlantısı kesildiğinde OpenClaw kanaldan ayrılır.
• Aynı sunucuda birden fazla takip edilen kullanıcı varsa ve etkin olarak takip edilen kullanıcı ayrılırsa OpenClaw, sunucudan ayrılmadan önce izlenen başka bir takip edilen kullanıcının kanalına geçer. Birkaç takip edilen kullanıcı aynı anda hareket ederse en son gözlemlenen ses durumu olayı geçerli olur.
• allowedChannels uygulanmaya devam eder. İzin verilmeyen bir kanaldaki takip edilen kullanıcı yok sayılır ve takip sahipliğindeki oturum başka bir takip edilen kullanıcıya geçer veya kanaldan ayrılır.
• OpenClaw, başlangıçta ve sınırlandırılmış aralıklarla kaçırılan ses durumu olaylarını uzlaştırır. Uzlaştırma, yapılandırılmış sunuculardan örnekleme yapar ve her çalıştırmadaki REST sorgularını sınırlar; bu nedenle çok büyük followUsers listelerinin yakınsaması birden fazla aralık sürebilir.
• Discord veya bir yönetici, bot bir kullanıcıyı takip ederken botu taşırsa OpenClaw ses oturumunu yeniden oluşturur ve hedefe izin veriliyorsa takip sahipliğini korur. Bot allowedChannels dışına taşınırsa OpenClaw ayrılır ve varsa yapılandırılmış hedefe yeniden katılır.
• DAVE alma kurtarması, tekrarlanan şifre çözme hatalarından sonra aynı kanaldan ayrılıp yeniden katılabilir. Takip sahipliğindeki oturumlar bu kurtarma yolu boyunca takip sahipliğini korur; böylece takip edilen kullanıcının daha sonra bağlantısının kesilmesi hâlinde kanaldan yine ayrılır.

Katılma modları arasından seçim yapın:

• Botun siz ses kanalındayken otomatik olarak orada bulunması gereken kişisel veya operatör kurulumlarında followUsers kullanın.
• İzlenen hiçbir kullanıcı ses kanalında olmasa bile bulunması gereken sabit oda botları için autoJoin kullanın.
• Tek seferlik katılımlar veya otomatik ses mevcudiyetinin beklenmedik olacağı odalar için /vc join kullanın.

Discord ses codec'i:

• Ses alma günlükleri discord voice: opus decoder: libopus-wasm gösterir.
• Gerçek zamanlı oynatma, paketleri @discordjs/voice bileşenine aktarmadan önce ham 48 kHz stereo PCM verisini aynı paketlenmiş libopus-wasm paketiyle Opus biçimine kodlar.
• Dosya ve sağlayıcı akışı oynatma, ffmpeg ile ham 48 kHz stereo PCM biçimine dönüştürür; ardından Discord'a gönderilen Opus paket akışı için libopus-wasm kullanır.

STT ve TTS işlem hattı:

• Discord PCM yakalaması geçici bir WAV dosyasına dönüştürülür.
• tools.media.audio, STT işlemini gerçekleştirir; örneğin openai/gpt-4o-mini-transcribe.
• Transkript, Discord girişi ve yönlendirmesi üzerinden gönderilirken yanıt LLM'si, ajan tts aracını gizleyen ve döndürülen metni isteyen bir ses çıkışı politikasıyla çalışır; çünkü nihai TTS oynatmasının sahibi Discord sestir.
• voice.model, ayarlandığında yalnızca bu ses kanalı turunun yanıt LLM'sini geçersiz kılar.
• voice.tts, tts üzerine birleştirilir; akış özellikli sağlayıcılar oynatıcıyı doğrudan besler, aksi hâlde ortaya çıkan ses dosyası katılınan kanalda oynatılır.

Varsayılan ajan vekili ses kanalı oturumu örneği:

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

voice.agentSession bloğu olmadığında her ses kanalı kendi yönlendirilmiş OpenClaw oturumunu alır. Örneğin /vc join channel:234567890123456789, ilgili Discord ses kanalının oturumuyla konuşur. Gerçek zamanlı model yalnızca ses ön ucudur; esas istekler yapılandırılmış OpenClaw ajanına devredilir. Gerçek zamanlı model danışma aracını çağırmadan nihai bir transkript üretirse OpenClaw, varsayılan davranışın yine ajanla konuşuyormuş gibi çalışması için geri dönüş olarak danışmayı zorunlu kılar.

Eski STT ve TTS örneği:

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

Gerçek zamanlı çift yönlü örnek:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "bidi",        model: "openai/gpt-5.6-sol",        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "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/gpt-5.6-sol",        agentSession: {          mode: "target",          target: "channel:123456789012345678",        },        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",        },      },    },  },}

agent-proxy modunda bot yapılandırılmış ses kanalına katılır, ancak OpenClaw ajan turları hedef kanalın normal yönlendirilmiş oturumunu ve ajanını kullanır. Gerçek zamanlı ses oturumu, döndürülen sonucu ses kanalında seslendirir. Gözetmen ajan, doğru eylem buysa ayrı bir Discord mesajı göndermek de dâhil olmak üzere, araç politikasına göre normal mesaj araçlarını kullanmaya devam edebilir.

Yetkilendirilmiş bir OpenClaw çalıştırması etkinken yeni Discord ses transkriptleri, başka bir ajan turu başlatılmadan önce canlı çalıştırma denetimi olarak değerlendirilir. "durum", "bunu iptal et", "daha küçük düzeltmeyi kullan" veya "işin bittiğinde testleri de kontrol et" gibi ifadeler, etkin oturum için durum, iptal, yönlendirme veya takip girdisi olarak sınıflandırılır. Durum, iptal, kabul edilen yönlendirme ve takip sonuçları ses kanalında seslendirilir; böylece arayan kişi OpenClaw'un isteği işleyip işlemediğini bilir.

Kullanışlı hedef biçimleri:

• target: "channel:123456789012345678", bir Discord metin kanalı oturumu üzerinden yönlendirir.
• target: "123456789012345678", bir kanal hedefi olarak değerlendirilir.
• target: "dm:123456789012345678" veya target: "user:123456789012345678", ilgili doğrudan mesaj oturumu üzerinden yönlendirir.

Yankının yoğun olduğu OpenAI Realtime örneği:

{  channels: {    discord: {      voice: {        enabled: true,        mode: "bidi",        model: "openai/gpt-5.6-sol",        realtime: {          provider: "openai",          model: "gpt-realtime-2.1",          speakerVoice: "cedar",          bargeIn: true,          minBargeInAudioEndMs: 500,          consultPolicy: "always",          providers: {            openai: {              interruptResponseOnInputAudio: false,            },          },        },      },    },  },}

Model açık bir mikrofon üzerinden kendi Discord oynatmasını duyduğunda, ancak konuşarak yine de sözünü kesmek istediğinizde bunu kullanın. OpenClaw, OpenAI'ın ham giriş sesi nedeniyle otomatik olarak kesintiye uğramasını önlerken bargeIn: true, Discord konuşmacı başlangıcı olaylarının ve hâlihazırda etkin olan konuşmacı sesinin, yakalanan bir sonraki tur OpenAI'a ulaşmadan önce etkin gerçek zamanlı yanıtları iptal etmesini sağlar. audioEndMs değeri minBargeInAudioEndMs altında olan çok erken araya girme sinyalleri muhtemel yankı/gürültü olarak değerlendirilip yok sayılır; böylece model ilk oynatma karesinde kesilmez.

Beklenen ses günlükleri:

• Katılma sırasında: discord voice: joining ... voiceSession=... supervisorSession=... agentSessionMode=... voiceModel=... realtimeModel=...
• Gerçek zamanlı başlatma sırasında: discord voice: realtime bridge starting ... autoRespond=false interruptResponse=false bargeIn=false minBargeInAudioEndMs=...
• Konuşmacı sesi sırasında: 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 ...
• Gerçek zamanlı yanıt tamamlandığında: discord voice: realtime audio playback finishing reason=response.done ... audioMs=... chunks=...
• Oynatma durdurulduğunda/sıfırlandığında: discord voice: realtime audio playback stopped reason=... audioMs=... elapsedMs=... chunks=...
• Gerçek zamanlı danışma sırasında: discord voice: realtime consult requested ... voiceSession=... supervisorSession=... question=...
• Ajan yanıtında: discord voice: agent turn answer ...
• Kesin konuşma kuyruğa alındığında: 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=...
• Gerçek zamanlı kesinti sırasında: 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=... ya da discord voice: realtime model interrupt confirmed server:response.done status=cancelled ...
• Yankı/gürültü yok sayıldığında: discord voice: realtime model interrupt ignored client:conversation.item.truncate.skipped reason=barge-in audioEndMs=0 minAudioEndMs=250
• Araya girme devre dışı bırakıldığında: discord voice: realtime capture ignored during playback (barge-in disabled) ...
• Boşta oynatma sırasında: discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0

Kesilen ses sorununu ayıklamak için gerçek zamanlı ses günlüklerini bir zaman çizelgesi olarak okuyun:

1. realtime audio playback started, Discord'un asistan sesini oynatmaya başladığı anlamına gelir. Köprü bu noktadan itibaren asistan çıkış parçalarını, Discord PCM baytlarını, sağlayıcı gerçek zamanlı baytlarını ve sentezlenen ses süresini saymaya başlar.
2. realtime speaker turn opened, bir Discord konuşmacısının etkinleştiğini belirtir. Oynatma zaten etkinse ve bargeIn etkinleştirilmişse bunu barge-in detected source=speaker-start izleyebilir.
3. realtime input audio started, ilgili konuşmacı turu için alınan ilk gerçek ses karesini belirtir. Buradaki outputActive=true veya sıfır olmayan outputAudioMs, asistan oynatması hâlâ etkinken mikrofonun giriş gönderdiği anlamına gelir.
4. barge-in detected source=active-speaker-audio, OpenClaw'un asistan oynatması etkinken canlı konuşmacı sesi gördüğü anlamına gelir. Bu, gerçek bir kesintiyi yararlı ses içermeyen bir Discord konuşmacı başlangıcı olayından ayırt etmek için kullanışlıdır.
5. barge-in requested reason=..., OpenClaw'un gerçek zamanlı sağlayıcıdan etkin yanıtı iptal etmesini veya kısaltmasını istediği anlamına gelir. Kesintiden önce asistan sesinin gerçekte ne kadarının 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 belirtir: barge-in, player-idle, provider-clear-audio, forced-agent-consult, stream-close veya session-close.
7. realtime speaker turn closed, yakalanan giriş turunu özetler. chunks=0 veya hasAudio=false, konuşmacı turunun açıldığı ancak gerçek zamanlı köprüye kullanılabilir ses ulaşmadığı anlamına gelir. interruptedPlayback=true, ilgili giriş turunun asistan çıkışıyla çakıştığı ve araya girme mantığını tetiklediği anlamına gelir.

Kullanışlı alanlar:

• outputAudioMs: günlük satırından önce gerçek zamanlı sağlayıcı tarafından oluşturulan asistan sesi süresi.
• audioMs: oynatma durmadan önce OpenClaw'un saydığı asistan sesi süresi.
• elapsedMs: oynatma akışının veya konuşmacı turunun açılmasıyla kapanması arasındaki gerçek zaman.
• discordBytes: Discord sese gönderilen veya Discord sesten alınan 48 kHz stereo PCM baytları.
• realtimeBytes: gerçek zamanlı sağlayıcıya gönderilen veya sağlayıcıdan alınan, sağlayıcı biçimindeki PCM baytları.
• playbackChunks: etkin yanıt için Discord'a iletilen asistan sesi parçaları.
• sinceLastAudioMs: yakalanan son konuşmacı ses karesi ile konuşmacı turunun kapanması arasındaki boşluk.

Yaygın kalıplar:

• source=active-speaker-audio ile anında kesilme, küçük outputAudioMs ve aynı kullanıcının yakında olması, genellikle hoparlör yankısının mikrofona girdiğini gösterir. voice.realtime.minBargeInAudioEndMs değerini artırın, hoparlör sesini azaltın, kulaklık kullanın veya voice.realtime.providers.openai.interruptResponseOnInputAudio: false ayarını yapın.
• source=speaker-start ardından speaker turn closed ... hasAudio=false gelmesi, Discord'un bir konuşmacının konuşmaya başladığını bildirdiği ancak OpenClaw'a ses ulaşmadığı anlamına gelir. Bunun nedeni geçici bir Discord ses olayı, gürültü kapısı davranışı veya bir istemcinin mikrofonu kısa süreliğine etkinleştirmesi olabilir.
• Yakında bir araya girme veya provider-clear-audio olmadan audio playback stopped reason=stream-close görülmesi, yerel Discord oynatma akışının beklenmedik şekilde sona erdiği anlamına gelir. Önceki sağlayıcı ve Discord oynatıcı günlüklerini kontrol edin.
• capture ignored during playback (barge-in disabled), asistan sesi etkinken OpenClaw'ın girdiyi kasıtlı olarak bıraktığı anlamına gelir. Konuşmanın oynatmayı kesmesini istiyorsanız voice.realtime.bargeIn özelliğini etkinleştirin.
• barge-in ignored ... outputActive=false, Discord veya sağlayıcı VAD sisteminin konuşma bildirdiği ancak OpenClaw'ın kesilecek etkin bir oynatmasının olmadığı anlamına gelir. Bu durum 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ı, tts/voice.tts için TTS kimlik doğrulaması ve voice.realtime.providers ya da sağlayıcının normal kimlik doğrulama yapılandırması için gerçek zamanlı sağlayıcı kimlik doğrulaması.

Sesli mesajlar

Discord sesli mesajları bir dalga biçimi önizlemesi gösterir ve OGG/Opus ses gerektirir. OpenClaw dalga biçimini otomatik olarak oluşturur ancak inceleme ve dönüştürme işlemleri için gateway ana makinesinde ffmpeg ve ffprobe bulunması gerekir.

• Bir yerel dosya yolu sağlayın (URL'ler reddedilir).
• Metin içeriğini atlayın (Discord aynı yükte metin + sesli mesajı reddeder).
• Herhangi bir ses biçimi kabul edilir; OpenClaw gerektiğinde OGG/Opus biçimine 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: {defaults: {  botLoopProtection: {    maxEventsPerWindow: 20,    windowSeconds: 60,    cooldownSeconds: 60,  },},discord: {  // İsteğe bağlı Discord geneli geçersiz kılma. Hesap blokları tek tek  // alanları geçersiz kılar ve atlanan alanları buradan devralır.  botLoopProtection: {    maxEventsPerWindow: 4,  },  accounts: {    alpha: {      // Alpha yalnızca kendisinden bahsettiklerinde diğer botları dinler.      allowBots: "mentions",    },    bravo: {      // Bravo, botlar tarafından yazılan tüm Discord mesajlarını dinler.      allowBots: true,      mentionAliases: {        // Bravo'nun yapılandırılmış kullanıcı kimliğiyle bir Alpha Discord bahsetmesi yazmasını sağlar.        Alpha: "ALPHA_DISCORD_USER_ID",      },      botLoopProtection: {        // Çifti engellemeden önce dakikada en fazla beş mesaja izin ver.        maxEventsPerWindow: 5,        windowSeconds: 60,        cooldownSeconds: 90,      },    },  },},},}

Yapılandırma referansı

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

Discord Activities

Ajanların Discord içinde açılan bağımsız HTML araç takımları gönderebilmesi için channels.discord.activities ayarını yapın. Blok isteğe bağlıdır; mevcut olmadığında OpenClaw hiçbir Activity rotası, aracı veya etkileşim işleyicisi kaydetmez. Developer Portal, tünel, güvenlik ve sorun giderme kurulumu için Discord Activities sayfasına bakın.

• activities.clientSecret: Discord uygulamasının OAuth2 istemci sırrı; DISCORD_CLIENT_SECRET değerine geri döner
• activities.applicationId: isteğe bağlı Activity uygulama kimliği; varsayılan olarak gateway başlatılırken öğrenilen bot uygulama kimliğini kullanır

Güvenlik ve operasyonlar

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

İlgili