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 sunucu 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ına sahip ayrı bir agent oturumu kullandığı eksiksiz 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,},},},},}

Artık kanallar oluşturup sohbet etmeye başlayabilirsiniz. Agent kanal adını görür ve her kanal yalıtılmış bir oturumdur; iş akışınıza uygun şekilde #coding, #home, #research veya başka kanallar oluşturun.

Çalışma zamanı modeli

• Discord bağlantısının sahibi Gateway'dir.
• Yanıt yönlendirmesi belirlenimlidir: Discord'dan gelen mesajların yanıtları Discord'a geri gönderilir.
• Discord sunucu/kanal meta verileri, kullanıcıya görünür 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 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ının oturum anahtarları yalıtılmıştı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 yönlendirilen konuşma oturumuna ait CommandTargetSessionKey değerini 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 ürettiğinde 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şturmanın iki yolunu destekler:

• Otomatik olarak bir ileti dizisi 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 uyacak şekilde kısaltılır).
• Doğrudan bir ileti dizisi oluşturmak için openclaw message thread create komutunu kullanın. Forum kanalları için --message-id iletmeyin.

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

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

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

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

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ılabilmesi için components.reusable=true ayarını belirleyin.

Bir düğmeye kimlerin tıklayabileceğini sınırlamak için o düğmede allowedUsers değerini belirleyin (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 bazında değiştirmek için channels.discord.accounts.<accountId>.agentComponents.ttlMs ayarını belirleyin. 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 değerleri, düğmelerin kullanılabilir kalması gereken inceleme/onay iş akışlarına uygundur ancak eski bir Discord mesajının hâlâ bir eylemi tetikleyebileceği süreyi uzatır. İhtiyacı karşılayan en kısa TTL değerini tercih edin ve eski geri çağrıların beklenmedik sonuçlar doğuracağı 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 sohbetten model kaydetmek yerine kullanım dışı bırakma mesajı döndürür. Seçici yanıtı yalnızca çağıran kullanıcıya görünür ve yalnızca bu kullanıcı tarafından 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.models öğesine provider/* girdileri ekleyin.

Dosya ekleri:

• file blokları bir ek başvurusuna (attachment://<filename>) işaret etmelidir
• Eki media/path/filePath (tek dosya) aracılığıyla sağlayın; birden çok dosya için media-gallery kullanın
• Yükleme adının ek başvurusuyla 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 tetikleyici düğme 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: { 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 yetkilendirmesi

• commands.native varsayılan olarak "auto" değerini kullanı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 kaydını ve temizlenmesini atlar. Önceden kaydedilmiş komutlar, bunları Discord uygulamasından kaldırana 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 yine de görünebilir; yürütme sırasında OpenClaw kimlik doğrulaması uygulanır ve "yetkiniz yok" 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: {      label: "auto",      maxLines: 8,      maxLineChars: 120,      toolProgress: true,      commentary: false,    },  },},},}

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

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

{agents: {list: [  {    id: "codex",    runtime: {      type: "acp",      acp: {        agent: "codex",        backend: "acpx",        mode: "persistent",        cwd: "/workspace/openclaw",      },    },  },],},bindings: [{  type: "acp",  agentId: "codex",  match: {    channel: "discord",    accountId: "default",    peer: { kind: "channel", id: "222222222222222222" },  },  acp: { label: "codex-main" },},],channels: {discord: {  guilds: {    "111111111111111111": {      channels: {        "222222222222222222": {          requireMention: false,        },      },    },  },},},}

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

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

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

{channels: {discord: {  pluralkit: {    enabled: true,    token: "pk_live_...", // 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: "belirteç tükendi",  },},},}

Araçlar ve eylem geçitleri

Discord ileti eylemleri; iletileşme, kanal yönetimi, moderasyon, durum ve meta verileri kapsar.

Temel örnekler:

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

event-create eylemi, planlanmış etkinliğin 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, çalıştırma onayları ve bağlamlar arası işaretleyiciler için Discord bileşenleri v2'yi kullanır. Discord ileti 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 kullanılabilir durumda kalır 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, azami 86400000). Hesap başına: channels.discord.accounts.<id>.agentComponents.ttlMs.
• Bileşenler v2 mevcut olduğunda embeds yok sayılır.
• Düz URL önizlemeleri varsayılan olarak engellenir. Tek bir giden bağlantının genişletilmesi gerektiğinde ileti eyleminde suppressEmbeds: false ayarlayın.

Örnek:

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

Ses

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

Ses kanalları

Kurulum denetim 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ı (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 agent'ı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 geçerli izinlerini incelemek için:

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

Otomatik katılma ö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 sesi, yalnızca metin yapılandırmalarında isteğe bağlıdır; /vc komutlarını, ses çalışma zamanını ve GuildVoiceStates Gateway niyetini etkinleştirmek için channels.discord.voice.enabled=true olarak ayarlayın (veya mevcut bir channels.discord.voice bloğunu koruyun). channels.discord.intents.voiceStates, niyet aboneliğini açıkça geçersiz kılabilir; etkin ses ayarını takip etmesi için ayarlamadan bırakın.
• voice.mode, konuşma yolunu denetler. Varsayılan değer agent-proxy'dir: gerçek zamanlı bir ses ön ucu, konuşma sırası zamanlamasını, kesintiyi ve oynatmayı yönetir; esas işi openclaw_agent_consult aracılığıyla yönlendirilen OpenClaw aracısına devreder ve sonucu, o konuşmacıdan gelen yazılı bir Discord istemi gibi ele alır. stt-tts, eski toplu STT ve TTS akışını korur. bidi, OpenClaw beyni için openclaw_agent_consult erişimini 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ın #maintainers gibi mevcut bir Discord metin kanalı oturumunun mikrofon/hoparlör uzantısı olarak çalışmasını sağlamak 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önlendirilen aracı modelini devralması için ayarlamadan bırakın. Bu ayar, voice.realtime.model ayarından ayrıdır.
• voice.followUsers, botun seçilen kullanıcılarla birlikte Discord sesine katılmasını, taşınmasını ve ayrılmasını sağlar. Bkz. Sesli konuşmada 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 korurken Discord sesi oynatmayı yönettiği için aracının tts aracını gizler. Varsayılan olarak agent-proxy, sahip konuşmacıların danışmasına sahip ile eşdeğer tam araç erişimi verir (voice.realtime.toolPolicy: "owner") ve esas yanıtları vermeden önce OpenClaw aracısına danışılmasını güçlü biçimde 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 yazıya döker, ardından yönlendirilen OpenClaw yanıtını seslendirir. Discord hâlâ ilk yanıtı oynatırken birden fazla zorunlu danışma yanıtı tamamlanırsa sonraki birebir seslendirilecek 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, yazıya dökümü 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 ile Codex beynini kullanmak için voice.realtime.model: "gpt-realtime-2.1" ve voice.model: "openai/gpt-5.6-sol" ayarlarını kullanın.
• Gerçek zamanlı ses modları, hızlı doğrudan konuşma sıralarının yönlendirilen 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 ayarını bir alt kümeye, devre dışı bırakmak içinse [] değerine 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 işlevinin yerini almaz.
• OpenAI agent-proxy gerçek zamanlı modunda, yazıya döküm bir uyandırma adıyla başlayana veya bitene kadar Discord gerçek zamanlı sesini sessiz tutmak için voice.realtime.requireWakeName: true olarak ayarlayın. Yapılandırılan uyandırma adları bir veya iki sözcük olmalıdır. voice.realtime.wakeNames ayarlanmamışsa OpenClaw, yönlendirilen aracının name değerini ve OpenClaw adını kullanır; bunlar yoksa aracı kimliğini ve OpenClaw adını kullanır. 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 yazıya döküm gelmeden önce kısmi yazıya dökümde baştaki bir uyandırma adı tanındığında kısa bir sesli onay verir.
• OpenAI gerçek zamanlı sağlayıcısı, çıkış sesi ve yazıya döküm 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 sesinin kaybolmasına yol açmadan 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 kesme ayarını takip eder.
• voice.realtime.minBargeInAudioEndMs, OpenAI gerçek zamanlı araya girişinin sesi kısaltmasından önceki minimum asistan oynatma süresini denetler. Varsayılan: 250. Düşük yankılı odalarda anında kesinti için 0 olarak ayarlayın; yüksek yankılı hoparlör düzenlerinde değeri artırın.
• voice.tts, yalnızca stt-tts ses oynatması için messages.tts ayarını geçersiz kılar; gerçek zamanlı modlar bunun yerine voice.realtime.speakerVoice kullanır. Discord oynatmasında bir OpenAI sesi kullanmak için voice.tts.provider: "openai" olarak ayarlayın ve voice.tts.providers.openai.speakerVoice altında bir Metinden Konuşmaya ses seçin. cedar, güncel OpenAI TTS modelinde erkeksi tını için iyi bir seçimdir.
• Kanal başına Discord systemPrompt geçersiz kılmaları, ilgili ses kanalının ses yazıya döküm konuşma sıralarına uygulanır.
• Ses yazıya döküm konuşma sıraları, sahip kısıtlamalı komutlar ve kanal eylemleri için sahip durumunu Discord allowFrom (veya dm.allowFrom) ayarından türetir. Aracı araçlarının görünürlüğü, yönlendirilen oturum için yapılandırılmış araç politikasını takip eder.
• 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 kalış izin listesidir. /vc join ile yetkilendirilmiş herhangi bir Discord ses kanalına katılmaya izin vermek için ayarlamadan bırakın. Ayarlandığında /vc join, başlangıçta otomatik katılım ve botun ses durumu taşımaları, listelenen { guildId, channelId } girdileriyle sınırlandırılır. Tüm Discord ses 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 mevcutsa yapılandırılmış otomatik katılım hedefine yeniden katılır.
• voice.daveEncryption ve voice.decryptionFailureTolerance, @discordjs/voice katılım 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 oynatması için paketlenmiş libopus-wasm kodlayıcı/kod çözücüsünü kullanır. Sabitlenmiş bir libopus WebAssembly derlemesiyle birlikte gelir ve yerel opus eklentileri gerektirmez.
• voice.connectTimeoutMs, /vc join ve otomatik katılım denemeleri için başlangıçtaki @discordjs/voice Ready bekleme süresini denetler. Varsayılan: 30000.
• voice.reconnectGraceMs, OpenClaw'un bağlantısı kesilmiş bir ses oturumunu sonlandırmadan önce yeniden bağlanmaya başlamasını ne kadar bekleyeceğini denetler. Varsayılan: 15000.
• stt-tts modunda ses oynatma, yalnızca başka bir kullanıcı konuşmaya başladığı için durmaz. Geri besleme döngülerini önlemek amacıyla OpenClaw, TTS oynatılırken yeni ses yakalamayı yok sayar; sonraki konuşma sırası için oynatma tamamlandıktan sonra konuşun. Gerçek zamanlı modlar, konuşmacı başlangıçlarını araya giriş sinyalleri olarak gerçek zamanlı sağlayıcıya iletir.
• Gerçek zamanlı modlarda hoparlörlerden açık mikrofona gelen yankı, araya giriş gibi görünebilir ve oynatmayı kesebilir. Yüksek yankılı Discord odalarında OpenAI'ın giriş sesi üzerine otomatik kesinti yapmasını engellemek için voice.realtime.providers.openai.interruptResponseOnInputAudio: false olarak ayarlayı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 kısaltmalarını muhtemel yankı/gürültü olarak yok sayar ve Discord oynatmasını temizlemek yerine bunları atlandı olarak günlüğe kaydeder.
• voice.captureSilenceGraceMs, Discord bir konuşmacının durduğunu bildirdikten sonra OpenClaw'un ilgili ses bölümünü STT için sonlandırmadan önce ne kadar bekleyeceğini denetler. Varsayılan: 2000; Discord normal duraklamaları kesik kısmi yazıya dökümlere bölüyorsa değeri artırın.
• Seçilen TTS sağlayıcısı ElevenLabs olduğunda Discord ses oynatması akışlı TTS kullanır ve sağlayıcı 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 ş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 gerçekleştirir.
• Güncellemeden sonra alım günlüklerinde sürekli DecryptionFailed(UnencryptedWhenPassthroughDisabled) gösteriliyorsa bir bağımlılık raporu ve günlükleri toplayın. Paketlenmiş @discordjs/voice sürümü, discord.js PR #11449 ile gelen ve discord.js issue #11419'u kapatan üst kaynak dolgu düzeltmesini içerir.
• OpenClaw yakalanan bir konuşmacı bölümünü sonlandırdığında The operation was aborted alım olayları beklenir; bunlar ayrıntılı tanılama iletileridir, uyarı değildir.
• Ayrıntılı Discord ses günlükleri, kabul edilen her konuşmacı bölümü için sınırlandırılmış tek satırlık bir STT yazıya döküm önizlemesi içerir; böylece hata ayıklama sırasında sınırsız yazıya döküm metni dökülmeden hem kullanıcı tarafı hem de aracı yanıtı tarafı görülür.
• agent-proxy modunda zorunlu danışma geri dönüşü, ... ile biten metinler veya "ve" gibi sonda kalan bağlaçlar başta olmak üzere muhtemelen tamamlanmamış yazıya döküm parçalarını ve "hemen döneceğim" ya da "hoşça kal" gibi açıkça eylem gerektirmeyen kapanışları atlar. Bu işlem eski bir kuyruk yanıtını engellediğinde günlüklerde forced agent consult skipped reason=... gösterilir.

Sesli konuşmada kullanıcıları takip etme

Discord ses botunun başlangıçta sabit bir kanala katılmak veya /vc join komutunu beklemek 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.
• followUsers yapılandırıldığında followUsersEnabled varsayılan olarak true olur. Kayıtlı listeyi koruyup otomatik sesli takibi durdurmak için false olarak ayarlayın.
• Takip edilen bir kullanıcı izin verilen bir ses kanalına katıldığında OpenClaw o kanala katılır. Kullanıcı taşındığında OpenClaw da onunla birlikte taşınır. Etkin takip edilen kullanıcının bağlantısı kesildiğinde OpenClaw ayrılır.
• Aynı sunucuda birden fazla takip edilen kullanıcı varsa ve etkin takip edilen kullanıcı ayrılırsa OpenClaw, sunucudan ayrılmadan önce izlenen başka bir takip edilen kullanıcının kanalına taşınır. Birkaç takip edilen kullanıcı aynı anda taşınırsa 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 bir oturum başka bir takip edilen kullanıcıya taşınır veya ayrılır.
• OpenClaw, başlangıçta ve sınırlandırılmış aralıklarla kaçırılmış ses durumu olaylarını uzlaştırır. Uzlaştırma, yapılandırılmış sunucuları örnekler ve çalıştırma başına REST aramaları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 mevcut olduğunda yapılandırılmış hedefe yeniden katılır.
• DAVE alım 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ılım modları arasında seçim yapın:

• Botun siz sesli konuşmadayken otomatik olarak sesli konuşmada bulunması gereken kişisel veya operatör kurulumları için followUsers kullanın.
• İzlenen hiçbir kullanıcı sesli konuşmada bulunmadığında bile hazır bulunması gereken sabit oda botları için autoJoin kullanın.
• Tek seferlik katılımlar veya otomatik sesli bulunmanın şaşırtıcı olacağı odalar için /vc join kullanın.

Discord ses kodlayıcı/kod çözücüsü:

• Ses alım 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'yi aynı paketlenmiş libopus-wasm paketiyle Opus biçiminde kodlar.
• Dosya ve sağlayıcı akışı oynatması, ffmpeg ile ham 48 kHz stereo PCM'ye dönüştürülür ve ardından Discord'a gönderilen Opus paket akışı için libopus-wasm kullanılı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, örneğin openai/gpt-4o-mini-transcribe ile STT işlemini gerçekleştirir.
• Transkript Discord girişi ve yönlendirmesi üzerinden gönderilirken yanıt LLM'si, Discord ses özelliği son TTS oynatmasını üstlendiğinden ajan tts aracını gizleyen ve döndürülen metni isteyen bir ses çıkışı ilkesiyle çalışır.
• voice.model ayarlandığında yalnızca bu ses kanalı sırasındaki yanıt LLM'sini geçersiz kılar.
• voice.tts, messages.tts üzerine birleştirilir; akış özelliğine sahip sağlayıcılar oynatıcıyı doğrudan besler, aksi takdirde oluşturulan ses dosyası katılınan kanalda oynatılır.

Varsayılan ajan proxy'si 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 oturumuna sahip olur. Örneğin /vc join channel:234567890123456789, ilgili Discord ses kanalının oturumuyla konuşur. Gerçek zamanlı model yalnızca ses ön yüzüdür; esas istekler yapılandırılmış OpenClaw ajanına aktarılır. Gerçek zamanlı model danışma aracını çağırmadan nihai bir transkript üretirse OpenClaw, varsayılan davranışın hâlâ ajanla konuşuyormuş gibi çalışmasını sağlamak 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 sıraları 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. Denetleyici ajan, ayrı bir Discord mesajı göndermek doğru eylemse bunu yapmak da dâhil olmak üzere araç ilkesine göre normal mesaj araçlarını kullanmaya devam edebilir.

Devredilmiş bir OpenClaw çalışması etkinken yeni Discord ses transkriptleri, başka bir ajan sırası başlatılmadan önce canlı çalışma denetimi olarak işlenir. "durum", "onu 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'ın 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", 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ı engellerken bargeIn: true, bir sonraki yakalanan sıra OpenAI'a ulaşmadan önce Discord konuşmacı başlangıcı olaylarının ve hâlihazırda etkin olan konuşmacı sesinin etkin gerçek zamanlı yanıtları iptal etmesine olanak tanır. audioEndMs değeri minBargeInAudioEndMs değerinin altında olan çok erken söz kesme 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=...
• Güncelliğini yitirmiş 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ı sırasında: discord voice: agent turn answer ...
• Tam 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 ...
• Söz kesme 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=... veya 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
• Söz kesme devre dışı olduğunda: discord voice: realtime capture ignored during playback (barge-in disabled) ...
• Oynatma boştayken: discord voice: realtime barge-in ignored reason=... outputActive=false ... playbackChunks=0

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

1. realtime audio playback started, Discord'un yardımcı sesini oynatmaya başladığı anlamına gelir. Köprü bu noktadan itibaren yardımcı çıkış parçalarını, Discord PCM baytlarını, sağlayıcının 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ı sırası için alınan ilk gerçek ses karesini belirtir. Buradaki outputActive=true veya sıfırdan farklı bir outputAudioMs, yardımcı oynatması hâlâ etkinken mikrofonun giriş gönderdiği anlamına gelir.
4. barge-in detected source=active-speaker-audio, OpenClaw'ın yardımcı oynatması etkinken canlı konuşmacı sesi algıladığı anlamına gelir. Bu, gerçek bir kesintiyi kullanılabilir 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'ın gerçek zamanlı sağlayıcıdan etkin yanıtı iptal etmesini veya kısaltmasını istediği anlamına gelir. Kesintiden önce gerçekte ne kadar yardımcı sesi oynatıldığını görebilmeniz için outputAudioMs, outputActive ve playbackChunks değerlerini içerir.
6. realtime audio playback stopped reason=..., yerel Discord oynatmasının sıfırlanma 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ş sırasını özetler. chunks=0 veya hasAudio=false, konuşmacı sırasının açıldığı ancak gerçek zamanlı köprüye kullanılabilir ses ulaşmadığı anlamına gelir. interruptedPlayback=true, bu giriş sırasının yardımcı çıkışıyla çakıştığı ve söz kesme mantığını tetiklediği anlamına gelir.

Kullanışlı alanlar:

• outputAudioMs: günlük satırından önce gerçek zamanlı sağlayıcının oluşturduğu yardımcı sesi süresi.
• audioMs: oynatma durmadan önce OpenClaw'ın saydığı yardımcı sesi süresi.
• elapsedMs: oynatma akışının veya konuşmacı sırasının açılmasıyla kapanması arasındaki gerçek zaman süresi.
• discordBytes: Discord sesine gönderilen veya Discord sesinden 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 yardımcı ses parçaları.
• sinceLastAudioMs: yakalanan son konuşmacı ses karesiyle konuşmacı sırasının kapanması arasındaki boşluk.

Yaygın örüntüler:

• source=active-speaker-audio, küçük bir outputAudioMs ve yakında aynı kullanıcı varken oluşan anında kesilme, genellikle mikrofona giren hoparlör yankısına işaret eder. voice.realtime.minBargeInAudioEndMs değerini yükseltin, hoparlör sesini azaltın, kulaklık kullanın veya voice.realtime.providers.openai.interruptResponseOnInputAudio: false olarak ayarlayın.
• source=speaker-start sonrasında speaker turn closed ... hasAudio=false görülmesi, Discord'un bir konuşmacı başlangıcı bildirdiği ancak OpenClaw'a ses ulaşmadığı anlamına gelir. Bu, geçici bir Discord ses olayı, gürültü kapısı davranışı veya istemcinin mikrofonu kısa süreliğine etkinleştirmesi olabilir.
• Yakınında bir söz kesme veya provider-clear-audio olmadan audio playback stopped reason=stream-close görülmesi, yerel Discord oynatma akışının beklenmedik biçimde 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), yardımcı sesi etkinken OpenClaw'ın girişi 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'sinin konuşma bildirdiği ancak OpenClaw'ın kesilecek etkin bir oynatması olmadığı anlamına gelir. Bu durum sesi kesmemelidir.

Kimlik bilgileri bileşen bazında çözümlenir: voice.model için LLM yönlendirme 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 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 eklemeyin (Discord aynı yükte metin ile sesli mesajı birlikte 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: {discord: {  accounts: {    default: {      eventQueue: {        listenerTimeout: 120000,      },    },  },},},}

{channels: {defaults: {  botLoopProtection: {    maxEventsPerWindow: 20,    windowSeconds: 60,    cooldownSeconds: 60,  },},discord: {  // İsteğe bağlı, Discord genelinde geçersiz kılma. Hesap blokları bağımsız  // 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 Alpha için Discord bahsetmesi yazmasını sağlar.        Alpha: "ALPHA_DISCORD_USER_ID",      },      botLoopProtection: {        // Çifti baskılamadan önce dakikada en fazla beş mesaja izin verin.        maxEventsPerWindow: 5,        windowSeconds: 60,        cooldownSeconds: 90,      },    },  },},},}

Yapılandırma referansı

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

Güvenlik ve işletim

• Bot token'larını gizli bilgi olarak değerlendirin (gözetimli ortamlarda DISCORD_BOT_TOKEN tercih edilir).
• Discord izinlerini en düşük ayrıcalık ilkesiyle verin.
• Komut dağıtımı/durumu güncelliğini yitirmişse Gateway'i yeniden başlatın ve openclaw channels status --probe ile tekrar kontrol edin.

İlgili