Discord

Discord, aracı çıktısında yanıt etiketlerini destekler:

• [[reply_to_current]]
• [[reply_to:<id>]]

channels.discord.replyToMode tarafından denetlenir:

• off (varsayılan)
• first
• all
• batched

Not: off, örtük yanıt iş parçacığını devre dışı bırakır. Açık [[reply_to_*]] etiketleri yine de uygulanır. first, dönüş için ilk giden Discord mesajına örtük yerel yanıt başvurusunu her zaman ekler. batched, Discord'un örtük yerel yanıt başvurusunu yalnızca gelen dönüş, birden çok mesajdan oluşan debounced bir toplu iş olduğunda ekler. Bu, yerel yanıtları her tek mesajlı dönüş için değil, esas olarak belirsiz ve yoğun sohbetler için istediğinizde kullanışlıdır.

Mesaj kimlikleri bağlamda/geçmişte sunulur, böylece aracılar belirli mesajları hedefleyebilir.

OpenClaw, geçici bir mesaj gönderip metin geldikçe onu düzenleyerek taslak yanıtları akışa alabilir. channels.discord.streaming, off | partial | block | progress (varsayılan) değerlerini alır. progress, düzenlenebilir tek bir durum taslağı tutar ve son teslimata kadar araç ilerlemesiyle günceller; streamMode eski bir çalışma zamanı takma adıdır. Kalıcı yapılandırmayı kanonik anahtara yeniden yazmak için openclaw doctor --fix çalıştırın.

Discord önizleme düzenlemelerini devre dışı bırakmak için channels.discord.streaming.mode değerini off olarak ayarlayın. Discord blok akışı açıkça etkinleştirildiyse OpenClaw, çift akışı önlemek için önizleme akışını atlar.

{
channels: {
discord: {
  streaming: {
    mode: "progress",
    progress: {
      label: "auto",
      maxLines: 8,
      toolProgress: true,
    },
  },
},
},
}

• partial, token'lar geldikçe tek bir önizleme mesajını düzenler.
• block, taslak boyutunda parçalar yayar (boyutu ve kesme noktalarını ayarlamak için draftChunk kullanın; textChunkLimit ile sınırlandırılır).
• Medya, hata ve açık yanıt sonları bekleyen önizleme düzenlemelerini iptal eder.
• streaming.preview.toolProgress (varsayılan true), araç/ilerleme güncellemelerinin önizleme mesajını yeniden kullanıp kullanmayacağını denetler.
• streaming.preview.commandText / streaming.progress.commandText, kompakt ilerleme satırlarında komut/exec ayrıntısını denetler: raw (varsayılan) veya status (yalnızca araç etiketi).

Kompakt ilerleme satırlarını korurken ham komut/exec metnini gizleyin:

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

Önizleme akışı yalnızca metin içindir; medya yanıtları normal teslimata geri döner. block akışı açıkça etkinleştirildiğinde OpenClaw, çift akışı önlemek için önizleme akışını atlar.

Sunucu geçmişi bağlamı:

• channels.discord.historyLimit varsayılan 20
• yedek: messages.groupChat.historyLimit
• 0 devre dışı bırakır

DM geçmişi denetimleri:

• channels.discord.dmHistoryLimit
• channels.discord.dms["<user_id>"].historyLimit

İş parçacığı davranışı:

• Discord iş parçacıkları kanal oturumları olarak yönlendirilir ve geçersiz kılınmadıkça üst kanal yapılandırmasını devralır.
• İş parçacığı oturumları, üst kanalın oturum düzeyi /model seçimini yalnızca model yedeği olarak devralır; iş parçacığına yerel /model seçimleri yine de önceliklidir ve transkript devralma etkinleştirilmedikçe üst transkript geçmişi kopyalanmaz.
• channels.discord.thread.inheritParent (varsayılan false), yeni otomatik iş parçacıklarını üst transkriptten tohumlamaya dahil eder. Hesap başına geçersiz kılmalar channels.discord.accounts.<id>.thread.inheritParent altında bulunur.
• Mesaj aracı tepkileri user:<id> DM hedeflerini çözümleyebilir.
• guilds.<guild>.channels.<channel>.requireMention: false, yanıt aşaması etkinleştirme yedeği sırasında korunur.

Kanal konuları güvenilmeyen bağlam olarak enjekte edilir. İzin listeleri aracıyı kimin tetikleyebileceğini sınırlar; tam bir ek bağlam redaksiyonu sınırı değildir.

Discord, bir iş parçacığını oturum hedefine bağlayabilir; böylece o iş parçacığındaki takip mesajları aynı oturuma (alt aracı oturumları dahil) yönlendirilmeye devam eder.

Komutlar:

• /focus <target> geçerli/yeni iş parçacığını bir alt aracı/oturum hedefine bağla
• /unfocus geçerli iş parçacığı bağını kaldır
• /agents etkin çalışmaları ve bağlama durumunu göster
• /session idle <duration|off> odaklanmış bağlamalar için hareketsizlik otomatik odaktan çıkarma ayarını incele/güncelle
• /session max-age <duration|off> odaklanmış bağlamalar için sabit azami yaşı incele/güncelle

Yapılandırma:

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

Notlar:

• session.threadBindings.* genel varsayılanları ayarlar.
• channels.discord.threadBindings.* Discord davranışını geçersiz kılar.
• spawnSessions, sessions_spawn({ thread: true }) ve ACP iş parçacığı oluşturma işlemleri için iş parçacıklarını otomatik oluşturmayı/bağlamayı denetler. Varsayılan: true.
• defaultSpawnContext, iş parçacığına bağlı oluşturulan oturumlar için yerel alt aracı bağlamını denetler. Varsayılan: "fork".
• Kullanımdan kaldırılmış spawnSubagentSessions/spawnAcpSessions anahtarları openclaw doctor --fix tarafından taşınır.
• Bir hesap için iş parçacığı bağlamaları devre dışıysa /focus ve ilgili iş parçacığı bağlama işlemleri kullanılamaz.

Alt aracılar, ACP Aracıları ve Yapılandırma Başvurusu bölümlerine bakın.

Kararlı "always-on" ACP çalışma alanları için Discord konuşmalarını hedefleyen üst düzey tipli ACP bağlamaları yapılandırın.

Yapılandırma yolu:

• type: "acp" ve match.channel: "discord" ile bindings[]

Örnek:

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

Notlar:

• /acp spawn codex --bind here, geçerli kanalı veya iş parçacığını yerinde bağlar ve gelecekteki mesajları aynı ACP oturumunda tutar. İş parçacığı mesajları üst kanal bağlamasını devralır.
• Bağlı bir kanalda veya iş parçacığında /new ve /reset, aynı ACP oturumunu yerinde sıfırlar. Geçici iş parçacığı bağlamaları, etkinken hedef çözümlemeyi geçersiz kılabilir.
• spawnSessions, --thread auto|here üzerinden alt iş parçacığı oluşturmayı/bağlamayı kapılar.

Bağlama davranışı ayrıntıları için ACP Aracıları bölümüne bakın.

Sunucu başına tepki bildirim modu:

• off
• own (varsayılan)
• all
• allowlist (guilds.<id>.users kullanır)

Tepki olayları sistem olaylarına dönüştürülür ve yönlendirilen Discord oturumuna eklenir.

ackReaction, OpenClaw gelen bir mesajı işlerken bir onay emojisi gönderir.

Çözümleme sırası:

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• aracı kimliği emoji yedeği (agents.list[].identity.emoji, aksi halde "👀")

Notlar:

• Discord, unicode emoji veya özel emoji adlarını kabul eder.
• Bir kanal veya hesap için tepkiyi devre dışı bırakmak üzere "" kullanın.

Kanal tarafından başlatılan yapılandırma yazımları varsayılan olarak etkindir.

Bu, /config set|unset akışlarını etkiler (komut özellikleri etkin olduğunda).

Devre dışı bırak:

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

Discord Gateway WebSocket trafiğini ve başlangıç REST aramalarını (uygulama kimliği + izin listesi çözümlemesi) channels.discord.proxy ile bir HTTP(S) proxy üzerinden yönlendirin.

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

Hesap başına geçersiz kılma:

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

Proxy'lenmiş mesajları sistem üyesi kimliğiyle eşlemek için PluralKit çözümlemesini etkinleştirin:

{
channels: {
discord: {
  pluralkit: {
    enabled: true,
    token: "pk_live_...", // optional; needed for private systems
  },
},
},
}

Notlar:

• izin listeleri pk:<memberId> kullanabilir
• üye görüntü adları yalnızca channels.discord.dangerouslyAllowNameMatching: true olduğunda ad/slug ile eşleştirilir
• aramalar özgün mesaj kimliğini kullanır ve zaman penceresiyle sınırlandırılır
• arama başarısız olursa proxy'lenmiş mesajlar bot mesajı olarak ele alınır ve allowBots=true olmadığı sürece düşürülür

Aracıların bilinen Discord kullanıcıları için deterministik giden bahsetmelere ihtiyaç duyduğu durumlarda mentionAliases kullanın. Anahtarlar baştaki @ olmadan kullanıcı adlarıdır; değerler Discord kullanıcı kimlikleridir. Bilinmeyen kullanıcı adları, @everyone, @here ve Markdown kod aralıkları içindeki bahsetmeler değiştirilmeden bırakılır.

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

Durum veya etkinlik alanı ayarladığınızda ya da otomatik varlığı etkinleştirdiğinizde varlık güncellemeleri uygulanır.

Yalnızca durum örneği:

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

Etkinlik örneği (özel durum varsayılan etkinlik türüdür):

{
channels: {
discord: {
  activity: "Focus time",
  activityType: 4,
},
},
}

Akış örneği:

{
channels: {
discord: {
  activity: "Live coding",
  activityType: 1,
  activityUrl: "https://twitch.tv/openclaw",
},
},
}

Etkinlik türü haritası:

• 0: Oynuyor
• 1: Yayında (activityUrl gerektirir)
• 2: Dinliyor
• 3: İzliyor
• 4: Özel (etkinlik metnini durum hali olarak kullanır; emoji isteğe bağlıdır)
• 5: Yarışıyor

Otomatik varlık örneği (çalışma zamanı sağlık sinyali):

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

Otomatik durum, çalışma zamanı kullanılabilirliğini Discord durumuna eşler: healthy => online, degraded veya unknown => idle, exhausted veya unavailable => dnd. İsteğe bağlı metin geçersiz kılmaları:

• autoPresence.healthyText
• autoPresence.degradedText
• autoPresence.exhaustedText ({reason} yer tutucusunu destekler)

Discord, DM'lerde düğme tabanlı onay işlemeyi destekler ve isteğe bağlı olarak onay istemlerini kaynak kanalda yayımlayabilir.

Yapılandırma yolu:

• channels.discord.execApprovals.enabled
• channels.discord.execApprovals.approvers (isteğe bağlı; mümkün olduğunda commands.ownerAllowFrom değerine geri döner)
• channels.discord.execApprovals.target (dm | channel | both, varsayılan: dm)
• agentFilter, sessionFilter, cleanupAfterResolve

Discord, enabled ayarlanmamış veya "auto" olduğunda ve en az bir onaylayıcı çözümlenebildiğinde, onaylayıcı execApprovals.approvers içinden ya da commands.ownerAllowFrom içinden gelsin, yerel exec onaylarını otomatik etkinleştirir. Discord, exec onaylayıcılarını kanal allowFrom, eski dm.allowFrom veya doğrudan mesaj defaultTo değerlerinden çıkarımsamaz. Discord'u yerel onay istemcisi olarak açıkça devre dışı bırakmak için enabled: false ayarlayın.

/diagnostics ve /export-trajectory gibi hassas, yalnızca sahibin kullanabildiği grup komutları için OpenClaw onay istemlerini ve nihai sonuçları özel olarak gönderir. Çağıran sahibin bir Discord sahip rotası varsa önce Discord DM'yi dener; bu mevcut değilse Telegram gibi commands.ownerAllowFrom içindeki ilk kullanılabilir sahip rotasına geri döner.

target, channel veya both olduğunda onay istemi kanalda görünür. Düğmeleri yalnızca çözümlenen onaylayıcılar kullanabilir; diğer kullanıcılar geçici bir ret alır. Onay istemleri komut metnini içerir, bu yüzden kanal teslimini yalnızca güvenilir kanallarda etkinleştirin. Kanal kimliği oturum anahtarından türetilemezse OpenClaw DM teslimine geri döner.

Discord, diğer sohbet kanalları tarafından kullanılan paylaşılan onay düğmelerini de işler. Yerel Discord bağdaştırıcısı esas olarak onaylayıcı DM yönlendirmesi ve kanal fanout ekler. Bu düğmeler mevcut olduğunda birincil onay UX'i onlardır; OpenClaw, yalnızca araç sonucu sohbet onaylarının kullanılamadığını veya manuel onayın tek yol olduğunu söylediğinde manuel bir /approve komutu eklemelidir. Discord yerel onay çalışma zamanı etkin değilse OpenClaw, yerel belirleyici /approve <id> <decision> istemini görünür tutar. Çalışma zamanı etkinse ancak herhangi bir hedefe yerel kart teslim edilemiyorsa, OpenClaw bekleyen onaydaki tam /approve komutuyla aynı sohbette bir geri dönüş bildirimi gönderir.

Gateway kimlik doğrulaması ve onay çözümlemesi paylaşılan Gateway istemci sözleşmesini izler (plugin: kimlikleri plugin.approval.resolve üzerinden, diğer kimlikler exec.approval.resolve üzerinden çözümlenir). Onaylar varsayılan olarak 30 dakika sonra sona erer.

Bkz. Exec onayları.

• Message Content Intent'i etkinleştirin
• kullanıcı/üye çözümlemesine bağlı olduğunuzda Server Members Intent'i etkinleştirin
• intent'leri değiştirdikten sonra gateway'i yeniden başlatın

• groupPolicy değerini doğrulayın
• channels.discord.guilds altındaki guild izin listesini doğrulayın
• guild channels haritası varsa yalnızca listelenen kanallara izin verilir
• requireMention davranışını ve bahsetme kalıplarını doğrulayın

Yararlı kontroller:

openclaw doctor
openclaw channels status --probe
openclaw logs --follow

Yaygın nedenler:

• eşleşen guild/kanal izin listesi olmadan groupPolicy="allowlist"
• requireMention yanlış yerde yapılandırılmış (channels.discord.guilds veya kanal girdisi altında olmalıdır)
• gönderen, guild/kanal users izin listesi tarafından engellenmiş

Tipik günlükler:

• Slow listener detected ...
• stuck session: sessionKey=agent:...:discord:... state=processing ...

Discord gateway kuyruk ayarları:

• tek hesap: channels.discord.eventQueue.listenerTimeout
• çoklu hesap: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• bu yalnızca Discord gateway dinleyici işini denetler, ajan turu ömrünü denetlemez

Discord, kuyruğa alınan ajan turlarına kanalın sahip olduğu bir zaman aşımı uygulamaz. Mesaj dinleyicileri işi hemen devreder ve kuyruğa alınan Discord çalıştırmaları, oturum/araç/çalışma zamanı yaşam döngüsü tamamlanana veya işi iptal edene kadar oturum başına sıralamayı korur.

{
channels: {
discord: {
  accounts: {
    default: {
      eventQueue: {
        listenerTimeout: 120000,
      },
    },
  },
},
},
}

OpenClaw, bağlanmadan önce Discord /gateway/bot meta verilerini getirir. Geçici hatalarda Discord'un varsayılan gateway URL'sine geri dönülür ve günlüklerde hız sınırlaması uygulanır.

Meta veri zaman aşımı ayarları:

• tek hesap: channels.discord.gatewayInfoTimeoutMs
• çoklu hesap: channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
• yapılandırma ayarlanmamışsa env yedeği: OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
• varsayılan: 30000 (30 saniye), maks: 120000

OpenClaw, başlatma sırasında ve çalışma zamanı yeniden bağlantılarından sonra Discord'un gateway READY olayını bekler. Başlatma kademelendirmesi kullanan çoklu hesap kurulumlarında varsayılandan daha uzun bir başlatma READY penceresi gerekebilir.

READY zaman aşımı ayarları:

• başlatma tek hesap: channels.discord.gatewayReadyTimeoutMs
• başlatma çoklu hesap: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• yapılandırma ayarlanmamışsa başlatma env yedeği: OPENCLAW_DISCORD_READY_TIMEOUT_MS
• başlatma varsayılanı: 15000 (15 saniye), maks: 120000
• çalışma zamanı tek hesap: channels.discord.gatewayRuntimeReadyTimeoutMs
• çalışma zamanı çoklu hesap: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• yapılandırma ayarlanmamışsa çalışma zamanı env yedeği: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• çalışma zamanı varsayılanı: 30000 (30 saniye), maks: 120000

channels status --probe izin denetimleri yalnızca sayısal kanal kimlikleri için çalışır.

Slug anahtarları kullanırsanız çalışma zamanı eşleştirmesi yine çalışabilir, ancak probe izinleri tam olarak doğrulayamaz.

• DM devre dışı: channels.discord.dm.enabled=false
• DM ilkesi devre dışı: channels.discord.dmPolicy="disabled" (eski: channels.discord.dm.policy)
• pairing modunda eşleştirme onayı bekleniyor

Varsayılan olarak bot tarafından yazılan mesajlar yok sayılır.

channels.discord.allowBots=true ayarlarsanız döngü davranışını önlemek için sıkı mention ve izin listesi kuralları kullanın. Yalnızca botu mention eden bot mesajlarını kabul etmek için channels.discord.allowBots="mentions" tercih edin.

{
channels: {
discord: {
  accounts: {
    mantis: {
      // Mantis listens to other bots only when they mention her.
      allowBots: "mentions",
    },
    molty: {
      // Molty listens to all bot-authored Discord messages.
      allowBots: true,
      mentionAliases: {
        // Lets Molty write "@Mantis" and send a real Discord mention.
        Mantis: "MANTIS_DISCORD_USER_ID",
      },
    },
  },
},
},
}

• Discord ses alma kurtarma mantığının mevcut olması için OpenClaw'ı güncel tutun (openclaw update)
• channels.discord.voice.daveEncryption=true değerini doğrulayın (varsayılan)
• channels.discord.voice.decryptionFailureTolerance=24 değerinden başlayın (yukarı akış varsayılanı) ve yalnızca gerekirse ayarlayın
• günlüklerde şunları izleyin:
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• otomatik yeniden katılmadan sonra hatalar devam ederse günlükleri toplayın ve discord.js #11419 ile discord.js #11449 içindeki yukarı akış DAVE alma geçmişiyle karşılaştırın