Discord

​

Hızlı kurulum

export DISCORD_BOT_TOKEN="YOUR_BOT_TOKEN"
cat > discord.patch.json5 <<'JSON5'
{
  channels: {
    discord: {
      enabled: true,
      token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },
    },
  },
}
JSON5
openclaw config patch --file ./discord.patch.json5 --dry-run
openclaw config patch --file ./discord.patch.json5
openclaw gateway

{
  channels: {
    discord: {
      enabled: true,
      token: {
        source: "env",
        provider: "default",
        id: "DISCORD_BOT_TOKEN",
      },
    },
  },
}

DISCORD_BOT_TOKEN=...

{
  channels: {
    discord: {
      enabled: true,
      accounts: {
        personal: {
          token: { source: "env", provider: "default", id: "DISCORD_PERSONAL_TOKEN" },
          applicationId: "111111111111111111",
        },
        work: {
          token: { source: "env", provider: "default", id: "DISCORD_WORK_TOKEN" },
          applicationId: "222222222222222222",
        },
      },
    },
  },
}

openclaw pairing list discord
openclaw pairing approve discord <CODE>

​

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

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

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

​

Çalışma zamanı modeli

• Gateway, Discord bağlantısının sahibidir.
• Yanıt yö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ı

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

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

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

​

Etkileşimli bileşenler

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

• file blokları bir ek 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

• 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

{
  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

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

​

Ö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

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

​

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

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

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

​

Ses

​

Ses kanalları

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.

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

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

{
  channels: {
    discord: {
      voice: {
        enabled: true,
        model: "openai/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",
        },
      },
    },
  },
}

• 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

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

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

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

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

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

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

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

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

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

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

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

• 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

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.

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

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

​

Sesli mesajlar

• 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 doctor
openclaw channels status --probe
openclaw 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ı

​

Discord Activities

• 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