Discord

Discord obsługuje znaczniki odpowiedzi w danych wyjściowych agenta:

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

Kontrolowane przez channels.discord.replyToMode:

• off (domyślne)
• first
• all
• batched

Uwaga: off wyłącza niejawne wątki odpowiedzi. Jawne znaczniki [[reply_to_*]] są nadal respektowane. first zawsze dołącza niejawną natywną referencję odpowiedzi do pierwszej wychodzącej wiadomości Discord w danej turze. batched dołącza niejawną natywną referencję odpowiedzi Discord tylko wtedy, gdy przychodząca tura była odbitym pakietem wielu wiadomości. Jest to przydatne, gdy chcesz używać natywnych odpowiedzi głównie dla niejednoznacznych, gwałtownych czatów, a nie dla każdej tury z pojedynczą wiadomością.

Identyfikatory wiadomości są udostępniane w kontekście/historii, aby agenci mogli wskazywać konkretne wiadomości.

OpenClaw może strumieniować wersje robocze odpowiedzi, wysyłając tymczasową wiadomość i edytując ją w miarę napływania tekstu. channels.discord.streaming przyjmuje off | partial | block | progress (domyślne). progress utrzymuje jedną edytowalną wersję roboczą statusu i aktualizuje ją postępem narzędzi aż do końcowego dostarczenia; streamMode to starszy alias środowiska uruchomieniowego. Uruchom openclaw doctor --fix, aby przepisać utrwaloną konfigurację na klucz kanoniczny.

Ustaw channels.discord.streaming.mode na off, aby wyłączyć edycje podglądu Discord. Jeśli strumieniowanie blokowe Discord jest jawnie włączone, OpenClaw pomija strumień podglądu, aby uniknąć podwójnego strumieniowania.

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

• partial edytuje pojedynczą wiadomość podglądu w miarę napływania tokenów.
• block emituje porcje o rozmiarze wersji roboczej (użyj draftChunk, aby dostroić rozmiar i punkty podziału, ograniczone do textChunkLimit).
• Media, błędy i końcowe odpowiedzi z jawną odpowiedzią anulują oczekujące edycje podglądu.
• streaming.preview.toolProgress (domyślnie true) kontroluje, czy aktualizacje narzędzi/postępu ponownie używają wiadomości podglądu.
• streaming.preview.commandText / streaming.progress.commandText kontroluje szczegóły poleceń/wykonania w kompaktowych wierszach postępu: raw (domyślne) albo status (tylko etykieta narzędzia).

Ukryj surowy tekst poleceń/wykonania, zachowując kompaktowe wiersze postępu:

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

Strumieniowanie podglądu obsługuje tylko tekst; odpowiedzi z mediami wracają do zwykłego dostarczania. Gdy strumieniowanie block jest jawnie włączone, OpenClaw pomija strumień podglądu, aby uniknąć podwójnego strumieniowania.

Kontekst historii gildii:

• domyślne channels.discord.historyLimit to 20
• wartość zapasowa: messages.groupChat.historyLimit
• 0 wyłącza

Kontrolki historii DM:

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

Zachowanie wątków:

• Wątki Discord są kierowane jako sesje kanału i dziedziczą konfigurację kanału nadrzędnego, chyba że zostanie zastąpiona.
• Sesje wątków dziedziczą wybór /model na poziomie sesji z kanału nadrzędnego jako wartość zapasową tylko dla modelu; lokalne wybory /model w wątku nadal mają pierwszeństwo, a historia transkrypcji nadrzędnej nie jest kopiowana, chyba że włączono dziedziczenie transkrypcji.
• channels.discord.thread.inheritParent (domyślnie false) włącza dla nowych automatycznych wątków inicjowanie z transkrypcji nadrzędnej. Zastąpienia per konto znajdują się pod channels.discord.accounts.<id>.thread.inheritParent.
• Reakcje narzędzia wiadomości mogą rozwiązywać cele DM user:<id>.
• guilds.<guild>.channels.<channel>.requireMention: false jest zachowywane podczas zapasowej aktywacji na etapie odpowiedzi.

Tematy kanałów są wstrzykiwane jako niezaufany kontekst. Listy dozwolonych kontrolują, kto może wyzwolić agenta, a nie stanowią pełnej granicy redakcji kontekstu uzupełniającego.

Discord może powiązać wątek z celem sesji, aby kolejne wiadomości w tym wątku nadal były kierowane do tej samej sesji (w tym sesji subagentów).

Polecenia:

• /focus <target> powiąż bieżący/nowy wątek z celem subagenta/sesji
• /unfocus usuń powiązanie bieżącego wątku
• /agents pokaż aktywne uruchomienia i stan powiązania
• /session idle <duration|off> sprawdź/zaktualizuj automatyczne cofnięcie fokusu z powodu braku aktywności dla powiązań w fokusie
• /session max-age <duration|off> sprawdź/zaktualizuj sztywny maksymalny wiek dla powiązań w fokusie

Konfiguracja:

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

Uwagi:

• session.threadBindings.* ustawia globalne wartości domyślne.
• channels.discord.threadBindings.* zastępuje zachowanie Discord.
• spawnSessions kontroluje automatyczne tworzenie/powiązanie wątków dla sessions_spawn({ thread: true }) i wywołań tworzenia wątków ACP. Domyślnie: true.
• defaultSpawnContext kontroluje natywny kontekst subagenta dla wywołań tworzenia powiązanych z wątkiem. Domyślnie: "fork".
• Przestarzałe klucze spawnSubagentSessions/spawnAcpSessions są migrowane przez openclaw doctor --fix.
• Jeśli powiązania wątków są wyłączone dla konta, /focus i powiązane operacje powiązania wątku są niedostępne.

Zobacz Subagenci, Agenci ACP i Dokumentacja konfiguracji.

Dla stabilnych, "zawsze włączonych" obszarów roboczych ACP skonfiguruj najwyższego poziomu typowane powiązania ACP skierowane do rozmów Discord.

Ścieżka konfiguracji:

• bindings[] z type: "acp" i match.channel: "discord"

Przykład:

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

Uwagi:

• /acp spawn codex --bind here wiąże bieżący kanał lub wątek w miejscu i utrzymuje przyszłe wiadomości w tej samej sesji ACP. Wiadomości wątku dziedziczą powiązanie kanału nadrzędnego.
• W powiązanym kanale lub wątku /new i /reset resetują tę samą sesję ACP w miejscu. Tymczasowe powiązania wątków mogą zastępować rozwiązywanie celu, gdy są aktywne.
• spawnSessions bramkuje tworzenie/powiązanie wątków podrzędnych przez --thread auto|here.

Zobacz Agenci ACP, aby poznać szczegóły zachowania powiązań.

Tryb powiadomień o reakcjach per gildia:

• off
• own (domyślne)
• all
• allowlist (używa guilds.<id>.users)

Zdarzenia reakcji są przekształcane w zdarzenia systemowe i dołączane do kierowanej sesji Discord.

ackReaction wysyła emoji potwierdzenia, gdy OpenClaw przetwarza przychodzącą wiadomość.

Kolejność rozwiązywania:

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• zapasowe emoji tożsamości agenta (agents.list[].identity.emoji, w przeciwnym razie "👀")

Uwagi:

• Discord akceptuje emoji Unicode lub niestandardowe nazwy emoji.
• Użyj "", aby wyłączyć reakcję dla kanału lub konta.

Zapisy konfiguracji inicjowane przez kanał są domyślnie włączone.

Wpływa to na przepływy /config set|unset (gdy funkcje poleceń są włączone).

Wyłącz:

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

Kieruj ruch WebSocket Gateway Discord oraz początkowe wyszukiwania REST (identyfikator aplikacji + rozwiązywanie list dozwolonych) przez proxy HTTP(S) z channels.discord.proxy.

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

Zastąpienie per konto:

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

Włącz rozwiązywanie PluralKit, aby mapować wiadomości pośredniczone na tożsamość członka systemu:

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

Uwagi:

• listy dozwolonych mogą używać pk:<memberId>
• nazwy wyświetlane członków są dopasowywane według nazwy/sluga tylko wtedy, gdy channels.discord.dangerouslyAllowNameMatching: true
• wyszukiwania używają oryginalnego identyfikatora wiadomości i są ograniczone oknem czasowym
• jeśli wyszukiwanie się nie powiedzie, wiadomości pośredniczone są traktowane jako wiadomości botów i odrzucane, chyba że allowBots=true

Użyj mentionAliases, gdy agenci potrzebują deterministycznych wzmianek wychodzących dla znanych użytkowników Discord. Klucze to uchwyty bez początkowego @; wartości to identyfikatory użytkowników Discord. Nieznane uchwyty, @everyone, @here i wzmianki wewnątrz spanów kodu Markdown pozostają bez zmian.

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

Aktualizacje obecności są stosowane, gdy ustawisz pole statusu lub aktywności albo gdy włączysz automatyczną obecność.

Przykład tylko ze statusem:

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

Przykład aktywności (status niestandardowy jest domyślnym typem aktywności):

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

Przykład strumieniowania:

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

Mapa typów aktywności:

• 0: Granie
• 1: Strumieniowanie (wymaga activityUrl)
• 2: Słuchanie
• 3: Oglądanie
• 4: Niestandardowe (używa tekstu aktywności jako stanu statusu; emoji jest opcjonalne)
• 5: Rywalizacja

Przykład automatycznej obecności (sygnał kondycji środowiska uruchomieniowego):

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

Automatyczna obecność mapuje dostępność środowiska wykonawczego na status Discord: healthy => online, degraded lub unknown => idle, exhausted lub unavailable => dnd. Opcjonalne nadpisania tekstu:

• autoPresence.healthyText
• autoPresence.degradedText
• autoPresence.exhaustedText (obsługuje placeholder {reason})

Discord obsługuje zatwierdzanie oparte na przyciskach w wiadomościach DM i może opcjonalnie publikować prośby o zatwierdzenie w kanale źródłowym.

Ścieżka konfiguracji:

• channels.discord.execApprovals.enabled
• channels.discord.execApprovals.approvers (opcjonalne; w miarę możliwości wraca do commands.ownerAllowFrom)
• channels.discord.execApprovals.target (dm | channel | both, domyślnie: dm)
• agentFilter, sessionFilter, cleanupAfterResolve

Discord automatycznie włącza natywne zatwierdzenia wykonywania, gdy enabled nie jest ustawione lub ma wartość "auto" i można rozwiązać co najmniej jedną osobę zatwierdzającą, z execApprovals.approvers albo z commands.ownerAllowFrom. Discord nie wywnioskowuje osób zatwierdzających wykonywanie z kanałowego allowFrom, starszego dm.allowFrom ani bezpośredniej wiadomości defaultTo. Ustaw enabled: false, aby jawnie wyłączyć Discord jako natywnego klienta zatwierdzania.

W przypadku wrażliwych, dostępnych tylko dla właściciela poleceń grupowych, takich jak /diagnostics i /export-trajectory, OpenClaw wysyła prośby o zatwierdzenie i wyniki końcowe prywatnie. Najpierw próbuje Discord DM, gdy wywołujący właściciel ma trasę właściciela Discord; jeśli nie jest dostępna, wraca do pierwszej dostępnej trasy właściciela z commands.ownerAllowFrom, takiej jak Telegram.

Gdy target ma wartość channel lub both, prośba o zatwierdzenie jest widoczna w kanale. Tylko rozwiązane osoby zatwierdzające mogą używać przycisków; inni użytkownicy otrzymują efemeryczną odmowę. Prośby o zatwierdzenie zawierają tekst polecenia, więc włączaj dostarczanie do kanału tylko w zaufanych kanałach. Jeśli identyfikatora kanału nie można wyprowadzić z klucza sesji, OpenClaw wraca do dostarczania przez DM.

Discord renderuje też współdzielone przyciski zatwierdzania używane przez inne kanały czatu. Natywny adapter Discord głównie dodaje routing DM dla osób zatwierdzających i rozsyłanie do kanałów. Gdy te przyciski są obecne, są podstawowym UX zatwierdzania; OpenClaw powinien dołączać ręczne polecenie /approve tylko wtedy, gdy wynik narzędzia mówi, że zatwierdzenia czatu są niedostępne albo ręczne zatwierdzenie jest jedyną ścieżką. Jeśli natywne środowisko wykonawcze zatwierdzania Discord nie jest aktywne, OpenClaw zachowuje widoczną lokalną, deterministyczną prośbę /approve <id> <decision>. Jeśli środowisko wykonawcze jest aktywne, ale natywnej karty nie można dostarczyć do żadnego celu, OpenClaw wysyła w tym samym czacie powiadomienie awaryjne z dokładnym poleceniem /approve z oczekującego zatwierdzenia.

Uwierzytelnianie Gateway i rozwiązywanie zatwierdzeń są zgodne ze współdzielonym kontraktem klienta Gateway (identyfikatory plugin: są rozwiązywane przez plugin.approval.resolve; inne identyfikatory przez exec.approval.resolve). Zatwierdzenia domyślnie wygasają po 30 minutach.

Zobacz Zatwierdzenia wykonywania.

• włącz Message Content Intent
• włącz Server Members Intent, gdy zależy Ci na rozwiązywaniu użytkowników/członków
• uruchom ponownie gateway po zmianie intencji

• sprawdź groupPolicy
• sprawdź listę dozwolonych serwerów pod channels.discord.guilds
• jeśli istnieje mapa channels serwera, dozwolone są tylko wymienione kanały
• sprawdź zachowanie requireMention i wzorce wzmianek

Przydatne kontrole:

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

Typowe przyczyny:

• groupPolicy="allowlist" bez pasującej listy dozwolonych serwerów/kanałów
• requireMention skonfigurowane w niewłaściwym miejscu (musi być pod channels.discord.guilds albo we wpisie kanału)
• nadawca zablokowany przez listę dozwolonych users serwera/kanału

Typowe logi:

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

Pokrętła kolejki Discord gateway:

• pojedyncze konto: channels.discord.eventQueue.listenerTimeout
• wiele kont: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• to kontroluje tylko pracę listenera Discord gateway, a nie czas życia tury agenta

Discord nie stosuje limitu czasu należącego do kanału do zakolejkowanych tur agenta. Listenery wiadomości przekazują pracę natychmiast, a zakolejkowane uruchomienia Discord zachowują kolejność w ramach sesji, dopóki cykl życia sesji/narzędzia/środowiska wykonawczego nie zakończy się albo nie przerwie pracy.

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

OpenClaw pobiera metadane Discord /gateway/bot przed nawiązaniem połączenia. Przejściowe błędy używają domyślnego adresu URL Gateway Discord jako rozwiązania awaryjnego i są ograniczane częstotliwościowo w logach.

Ustawienia limitu czasu metadanych:

• pojedyncze konto: channels.discord.gatewayInfoTimeoutMs
• wiele kont: channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
• awaryjna wartość ze środowiska, gdy konfiguracja nie jest ustawiona: OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
• domyślnie: 30000 (30 sekund), maks.: 120000

OpenClaw czeka na zdarzenie Gateway Discord READY podczas uruchamiania i po ponownych połączeniach w czasie działania. Konfiguracje z wieloma kontami i rozłożonym uruchamianiem mogą wymagać dłuższego okna READY podczas uruchamiania niż domyślne.

Ustawienia limitu czasu READY:

• uruchamianie, pojedyncze konto: channels.discord.gatewayReadyTimeoutMs
• uruchamianie, wiele kont: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• awaryjna wartość ze środowiska podczas uruchamiania, gdy konfiguracja nie jest ustawiona: OPENCLAW_DISCORD_READY_TIMEOUT_MS
• domyślnie podczas uruchamiania: 15000 (15 sekund), maks.: 120000
• czas działania, pojedyncze konto: channels.discord.gatewayRuntimeReadyTimeoutMs
• czas działania, wiele kont: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• awaryjna wartość ze środowiska w czasie działania, gdy konfiguracja nie jest ustawiona: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• domyślnie w czasie działania: 30000 (30 sekund), maks.: 120000

Kontrole uprawnień channels status --probe działają tylko dla numerycznych identyfikatorów kanałów.

Jeśli używasz kluczy slug, dopasowanie w czasie działania nadal może działać, ale probe nie może w pełni zweryfikować uprawnień.

• DM wyłączone: channels.discord.dm.enabled=false
• zasady DM wyłączone: channels.discord.dmPolicy="disabled" (starsze: channels.discord.dm.policy)
• oczekiwanie na zatwierdzenie parowania w trybie pairing

Domyślnie wiadomości autorstwa botów są ignorowane.

Jeśli ustawisz channels.discord.allowBots=true, użyj ścisłych reguł wzmianek i listy dozwolonych, aby uniknąć zapętlenia. Preferuj channels.discord.allowBots="mentions", aby akceptować tylko wiadomości botów, które wspominają bota.

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

• utrzymuj OpenClaw w aktualnej wersji (openclaw update), aby dostępna była logika odzyskiwania odbioru głosu Discord
• potwierdź channels.discord.voice.daveEncryption=true (domyślnie)
• zacznij od channels.discord.voice.decryptionFailureTolerance=24 (domyślna wartość upstream) i dostrajaj tylko w razie potrzeby
• obserwuj logi pod kątem:
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• jeśli błędy nadal występują po automatycznym ponownym dołączeniu, zbierz logi i porównaj je z historią odbioru upstream DAVE w discord.js #11419 i discord.js #11449