Discord

Discord підтримує теги відповідей у виводі агента:

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

Керується через channels.discord.replyToMode:

• off (за замовчуванням)
• first
• all
• batched

Примітка: off вимикає неявну потоковість відповідей. Явні теги [[reply_to_*]] усе одно враховуються. first завжди додає неявне посилання нативної відповіді до першого вихідного повідомлення Discord за цей хід. batched додає неявне посилання нативної відповіді Discord лише тоді, коли вхідний хід був debounced-пакетом із кількох повідомлень. Це корисно, коли нативні відповіді потрібні переважно для неоднозначних швидких серій чатів, а не для кожного ходу з одним повідомленням.

ID повідомлень відображаються в контексті/історії, щоб агенти могли націлюватися на конкретні повідомлення.

OpenClaw може потоково надсилати чернетки відповідей, створюючи тимчасове повідомлення й редагуючи його в міру надходження тексту. channels.discord.streaming приймає off | partial | block | progress (за замовчуванням). progress підтримує одну редаговану чернетку статусу й оновлює її прогресом інструментів до фінальної доставки; streamMode є застарілим runtime-псевдонімом. Виконайте openclaw doctor --fix, щоб переписати збережену конфігурацію на канонічний ключ.

Установіть channels.discord.streaming.mode у off, щоб вимкнути редагування попереднього перегляду Discord. Якщо блоковий стримінг Discord явно ввімкнено, OpenClaw пропускає потік попереднього перегляду, щоб уникнути подвійного стримінгу.

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

• partial редагує одне повідомлення попереднього перегляду в міру надходження токенів.
• block надсилає фрагменти розміру чернетки (використовуйте draftChunk, щоб налаштувати розмір і точки розбиття, з обмеженням до textChunkLimit).
• Медіа, помилки та фінальні повідомлення з явною відповіддю скасовують очікувані редагування попереднього перегляду.
• streaming.preview.toolProgress (за замовчуванням true) керує тим, чи оновлення інструментів/прогресу повторно використовують повідомлення попереднього перегляду.
• streaming.preview.commandText / streaming.progress.commandText керує деталями команд/exec у компактних рядках прогресу: raw (за замовчуванням) або status (лише мітка інструмента).

Приховати сирий текст команд/exec, зберігаючи компактні рядки прогресу:

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

Стримінг попереднього перегляду підтримує лише текст; відповіді з медіа повертаються до звичайної доставки. Коли стримінг block явно ввімкнено, OpenClaw пропускає потік попереднього перегляду, щоб уникнути подвійного стримінгу.

Контекст історії guild:

• channels.discord.historyLimit за замовчуванням 20
• fallback: messages.groupChat.historyLimit
• 0 вимикає

Елементи керування історією DM:

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

Поведінка потоків:

• Потоки Discord маршрутизуються як сесії каналів і успадковують конфігурацію батьківського каналу, якщо її не перевизначено.
• Сесії потоків успадковують вибір /model рівня сесії батьківського каналу як fallback лише для моделі; локальні для потоку вибори /model усе одно мають пріоритет, а історія transcript батька не копіюється, якщо не ввімкнено успадкування transcript.
• channels.discord.thread.inheritParent (за замовчуванням false) вмикає для нових auto-threads початкове наповнення з батьківського transcript. Перевизначення для окремого облікового запису розташовані в channels.discord.accounts.<id>.thread.inheritParent.
• Реакції message-tool можуть розв’язувати DM-цілі user:<id>.
• guilds.<guild>.channels.<channel>.requireMention: false зберігається під час fallback активації на етапі відповіді.

Теми каналів додаються як ненадійний контекст. Allowlists обмежують, хто може запускати агента, але не є повною межею редагування додаткового контексту.

Discord може прив’язати потік до цілі сесії, щоб подальші повідомлення в цьому потоці продовжували маршрутизуватися до тієї самої сесії (зокрема сесій субагентів).

Команди:

• /focus <target> прив’язати поточний/новий потік до цілі субагента/сесії
• /unfocus видалити прив’язку поточного потоку
• /agents показати активні запуски та стан прив’язки
• /session idle <duration|off> переглянути/оновити авто-unfocus через неактивність для сфокусованих прив’язок
• /session max-age <duration|off> переглянути/оновити жорсткий максимальний вік для сфокусованих прив’язок

Конфігурація:

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

Примітки:

• session.threadBindings.* задає глобальні значення за замовчуванням.
• channels.discord.threadBindings.* перевизначає поведінку Discord.
• spawnSessions керує автоматичним створенням/прив’язуванням потоків для sessions_spawn({ thread: true }) і створень потоків ACP. За замовчуванням: true.
• defaultSpawnContext керує нативним контекстом субагента для створень, прив’язаних до потоків. За замовчуванням: "fork".
• Застарілі ключі spawnSubagentSessions/spawnAcpSessions мігруються через openclaw doctor --fix.
• Якщо прив’язки потоків вимкнено для облікового запису, /focus і пов’язані операції прив’язки потоків недоступні.

Див. Субагенти, Агенти ACP і Довідник конфігурації.

Для стабільних ACP-робочих просторів «always-on» налаштуйте типізовані ACP-прив’язки верхнього рівня, що націлені на розмови Discord.

Шлях конфігурації:

• bindings[] з type: "acp" і match.channel: "discord"

Приклад:

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

Примітки:

• /acp spawn codex --bind here прив’язує поточний канал або потік на місці й залишає майбутні повідомлення в тій самій ACP-сесії. Повідомлення потоку успадковують прив’язку батьківського каналу.
• У прив’язаному каналі або потоці /new і /reset скидають ту саму ACP-сесію на місці. Тимчасові прив’язки потоків можуть перевизначати розв’язання цілі, доки активні.
• spawnSessions керує створенням/прив’язуванням дочірніх потоків через --thread auto|here.

Див. Агенти ACP, щоб дізнатися подробиці поведінки прив’язок.

Режим сповіщень про реакції для окремого guild:

• off
• own (за замовчуванням)
• all
• allowlist (використовує guilds.<id>.users)

Події реакцій перетворюються на системні події та додаються до маршрутизованої сесії Discord.

ackReaction надсилає emoji підтвердження, поки OpenClaw обробляє вхідне повідомлення.

Порядок розв’язання:

• channels.discord.accounts.<accountId>.ackReaction
• channels.discord.ackReaction
• messages.ackReaction
• fallback на emoji ідентичності агента (agents.list[].identity.emoji, інакше "👀")

Примітки:

• Discord приймає unicode emoji або назви користувацьких emoji.
• Використовуйте "", щоб вимкнути реакцію для каналу або облікового запису.

Записи конфігурації, ініційовані каналом, увімкнено за замовчуванням.

Це впливає на потоки /config set|unset (коли функції команд увімкнено).

Вимкнення:

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

Маршрутизуйте WebSocket-трафік Gateway Discord і стартові REST-запити (ID застосунку + розв’язання allowlist) через HTTP(S)-проксі за допомогою channels.discord.proxy.

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

Перевизначення для окремого облікового запису:

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

Увімкніть розв’язання PluralKit, щоб зіставляти proxied-повідомлення з ідентичністю учасника системи:

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

Примітки:

• allowlists можуть використовувати pk:<memberId>
• відображувані імена учасників зіставляються за назвою/slug лише коли channels.discord.dangerouslyAllowNameMatching: true
• пошуки використовують ID оригінального повідомлення й обмежені часовим вікном
• якщо пошук не вдається, proxied-повідомлення вважаються повідомленнями бота й відкидаються, якщо allowBots=true не встановлено

Використовуйте mentionAliases, коли агентам потрібні детерміновані вихідні згадки для відомих користувачів Discord. Ключі — handles без початкового @; значення — ID користувачів Discord. Невідомі handles, @everyone, @here і згадки всередині Markdown code spans залишаються без змін.

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

Оновлення присутності застосовуються, коли ви задаєте поле статусу чи активності або коли вмикаєте автоматичну присутність.

Приклад лише зі статусом:

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

Приклад активності (користувацький статус є типовим типом активності):

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

Приклад стримінгу:

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

Мапа типів активності:

• 0: Грає
• 1: Стримить (потребує activityUrl)
• 2: Слухає
• 3: Дивиться
• 4: Користувацький (використовує текст активності як стан статусу; emoji необов’язковий)
• 5: Змагається

Приклад автоматичної присутності (сигнал справності runtime):

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

Автоматична присутність зіставляє доступність під час виконання зі статусом Discord: справний => онлайн, погіршений або невідомий => неактивний, вичерпаний або недоступний => не турбувати. Необов’язкові перевизначення тексту:

• autoPresence.healthyText
• autoPresence.degradedText
• autoPresence.exhaustedText (підтримує заповнювач {reason})

Discord підтримує обробку схвалень за допомогою кнопок у приватних повідомленнях і може необов’язково публікувати запити на схвалення в початковому каналі.

Шлях конфігурації:

• channels.discord.execApprovals.enabled
• channels.discord.execApprovals.approvers (необов’язково; за можливості повертається до commands.ownerAllowFrom)
• channels.discord.execApprovals.target (dm | channel | both, типово: dm)
• agentFilter, sessionFilter, cleanupAfterResolve

Discord автоматично вмикає нативні схвалення виконання, коли enabled не задано або має значення "auto", і можна визначити принаймні одного схвалювача або з execApprovals.approvers, або з commands.ownerAllowFrom. Discord не виводить схвалювачів виконання з канального allowFrom, застарілого dm.allowFrom або defaultTo для прямих повідомлень. Задайте enabled: false, щоб явно вимкнути Discord як нативний клієнт схвалення.

Для чутливих групових команд лише для власника, як-от /diagnostics і /export-trajectory, OpenClaw надсилає запити на схвалення та фінальні результати приватно. Спочатку він пробує Discord DM, коли власник, що викликає команду, має маршрут власника Discord; якщо він недоступний, OpenClaw повертається до першого доступного маршруту власника з commands.ownerAllowFrom, наприклад Telegram.

Коли target має значення channel або both, запит на схвалення видимий у каналі. Кнопками можуть користуватися лише визначені схвалювачі; інші користувачі отримують ефемерну відмову. Запити на схвалення містять текст команди, тому вмикайте доставку в канал лише в довірених каналах. Якщо ID каналу неможливо отримати з ключа сесії, OpenClaw повертається до доставки через DM.

Discord також відображає спільні кнопки схвалення, які використовують інші чат-канали. Нативний адаптер Discord переважно додає маршрутизацію DM для схвалювачів і розсилання в канали. Коли ці кнопки присутні, вони є основним UX схвалення; OpenClaw має додавати ручну команду /approve лише тоді, коли результат інструмента каже, що чат-схвалення недоступні або ручне схвалення є єдиним шляхом. Якщо нативне середовище виконання схвалень Discord не активне, OpenClaw залишає локальний детермінований запит /approve <id> <decision> видимим. Якщо середовище виконання активне, але нативну картку неможливо доставити жодній цілі, OpenClaw надсилає резервне повідомлення в той самий чат із точною командою /approve з очікуваного схвалення.

Автентифікація Gateway і розв’язання схвалень відповідають спільному контракту клієнта Gateway (plugin: ID розв’язуються через plugin.approval.resolve; інші ID через exec.approval.resolve). Типово термін дії схвалень спливає через 30 хвилин.

Див. схвалення виконання.

• увімкніть Message Content Intent
• увімкніть Server Members Intent, коли ви залежите від розв’язання користувача/учасника
• перезапустіть gateway після зміни intent

• перевірте groupPolicy
• перевірте список дозволених guild у channels.discord.guilds
• якщо існує мапа channels для guild, дозволені лише перелічені канали
• перевірте поведінку requireMention і шаблони згадок

Корисні перевірки:

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

Поширені причини:

• groupPolicy="allowlist" без відповідного списку дозволених guild/channel
• requireMention налаштовано не в тому місці (має бути в channels.discord.guilds або записі каналу)
• відправника заблоковано списком дозволених users для guild/channel

Типові журнали:

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

Параметри черги Discord gateway:

• один акаунт: channels.discord.eventQueue.listenerTimeout
• кілька акаунтів: channels.discord.accounts.<accountId>.eventQueue.listenerTimeout
• це керує лише роботою слухача Discord gateway, а не тривалістю звернення агента

Discord не застосовує тайм-аут, що належить каналу, до поставлених у чергу звернень агента. Слухачі повідомлень одразу передають роботу далі, а поставлені в чергу запуски Discord зберігають порядок у межах сесії, доки життєвий цикл сесії/інструмента/середовища виконання не завершить або не перерве роботу.

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

OpenClaw отримує метадані Discord /gateway/bot перед підключенням. У разі тимчасових збоїв використовується резервна типова URL-адреса Discord gateway, а записи в журналах обмежуються за частотою.

Параметри тайм-ауту метаданих:

• один акаунт: channels.discord.gatewayInfoTimeoutMs
• кілька акаунтів: channels.discord.accounts.<accountId>.gatewayInfoTimeoutMs
• резервне значення env, коли конфігурацію не задано: OPENCLAW_DISCORD_GATEWAY_INFO_TIMEOUT_MS
• типово: 30000 (30 секунд), максимум: 120000

OpenClaw чекає на подію Discord gateway READY під час запуску та після повторних підключень середовища виконання. Конфігураціям із кількома акаунтами та рознесенням запуску може знадобитися довше стартове вікно READY, ніж типове.

Параметри тайм-ауту READY:

• запуск, один акаунт: channels.discord.gatewayReadyTimeoutMs
• запуск, кілька акаунтів: channels.discord.accounts.<accountId>.gatewayReadyTimeoutMs
• резервне значення env для запуску, коли конфігурацію не задано: OPENCLAW_DISCORD_READY_TIMEOUT_MS
• типово для запуску: 15000 (15 секунд), максимум: 120000
• середовище виконання, один акаунт: channels.discord.gatewayRuntimeReadyTimeoutMs
• середовище виконання, кілька акаунтів: channels.discord.accounts.<accountId>.gatewayRuntimeReadyTimeoutMs
• резервне значення env для середовища виконання, коли конфігурацію не задано: OPENCLAW_DISCORD_RUNTIME_READY_TIMEOUT_MS
• типово для середовища виконання: 30000 (30 секунд), максимум: 120000

Перевірки дозволів channels status --probe працюють лише для числових ID каналів.

Якщо ви використовуєте slug-ключі, зіставлення під час виконання все одно може працювати, але probe не може повністю перевірити дозволи.

• DM вимкнено: channels.discord.dm.enabled=false
• політику DM вимкнено: channels.discord.dmPolicy="disabled" (застаріле: channels.discord.dm.policy)
• очікується схвалення сполучення в режимі pairing

За замовчуванням повідомлення, створені ботами, ігноруються.

Якщо ви встановлюєте channels.discord.allowBots=true, використовуйте суворі правила згадок і списків дозволених, щоб уникнути циклічної поведінки. Надавайте перевагу channels.discord.allowBots="mentions", щоб приймати лише повідомлення ботів, які згадують бота.

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

• підтримуйте OpenClaw актуальним (openclaw update), щоб була наявна логіка відновлення отримання голосу Discord
• підтвердьте channels.discord.voice.daveEncryption=true (типово)
• почніть із channels.discord.voice.decryptionFailureTolerance=24 (типове значення upstream) і налаштовуйте лише за потреби
• стежте за журналами на наявність:
  • discord voice: DAVE decrypt failures detected
  • discord voice: repeated decrypt failures; attempting rejoin
• якщо збої тривають після автоматичного повторного приєднання, зберіть журнали та порівняйте з upstream-історією отримання DAVE у discord.js #11419 і discord.js #11449