​

Довідник конфігурації

• openclaw config schema виводить актуальну JSON Schema, що використовується для валідації та Control UI, з об’єднаними метаданими bundled/plugin/channel, коли вони доступні
• config.schema.lookup повертає один вузол схеми з обмеженням за шляхом для інструментів деталізації
• pnpm config:docs:check / pnpm config:docs:gen перевіряють хеш базового рівня документації конфігурації щодо поточної поверхні схеми

• Memory configuration reference для agents.defaults.memorySearch.*, memory.qmd.*, memory.citations і конфігурації dreaming у plugins.entries.memory-core.config.dreaming
• Slash Commands для поточного каталогу вбудованих + bundled команд
• сторінки відповідного каналу/плагіну для поверхонь команд, специфічних для каналу

​

Канали

​

Доступ до особистих повідомлень і груп

​

Перевизначення моделі для каналів

{
  channels: {
    modelByChannel: {
      discord: {
        "123456789012345678": "anthropic/claude-opus-4-6",
      },
      slack: {
        C1234567890: "openai/gpt-4.1",
      },
      telegram: {
        "-1001234567890": "openai/gpt-4.1-mini",
        "-1001234567890:topic:99": "anthropic/claude-sonnet-4-6",
      },
    },
  },
}

​

Типові значення каналу та heartbeat

{
  channels: {
    defaults: {
      groupPolicy: "allowlist", // open | allowlist | disabled
      contextVisibility: "all", // all | allowlist | allowlist_quote
      heartbeat: {
        showOk: false,
        showAlerts: true,
        useIndicator: true,
      },
    },
  },
}

• channels.defaults.groupPolicy: резервна політика груп, коли groupPolicy на рівні постачальника не встановлено.
• channels.defaults.contextVisibility: типовий режим видимості додаткового контексту для всіх каналів. Значення: all (типово, включати весь цитований/гілковий/історичний контекст), allowlist (включати контекст лише від відправників зі списку дозволів), allowlist_quote (те саме, що allowlist, але зберігати явний контекст цитати/відповіді). Перевизначення на рівні каналу: channels.<channel>.contextVisibility.
• channels.defaults.heartbeat.showOk: включати статуси справних каналів у вивід heartbeat.
• channels.defaults.heartbeat.showAlerts: включати деградовані/помилкові статуси у вивід heartbeat.
• channels.defaults.heartbeat.useIndicator: відображати компактний вивід heartbeat у стилі індикатора.

​

WhatsApp

{
  channels: {
    whatsapp: {
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["+15555550123", "+447700900123"],
      textChunkLimit: 4000,
      chunkMode: "length", // length | newline
      mediaMaxMb: 50,
      sendReadReceipts: true, // сині галочки (false у режимі чату із самим собою)
      groups: {
        "*": { requireMention: true },
      },
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15551234567"],
    },
  },
  web: {
    enabled: true,
    heartbeatSeconds: 60,
    reconnect: {
      initialMs: 2000,
      maxMs: 120000,
      factor: 1.4,
      jitter: 0.2,
      maxAttempts: 0,
    },
  },
}

{
  channels: {
    whatsapp: {
      accounts: {
        default: {},
        personal: {},
        biz: {
          // authDir: "~/.openclaw/credentials/whatsapp/biz",
        },
      },
    },
  },
}

​

Telegram

{
  channels: {
    telegram: {
      enabled: true,
      botToken: "your-bot-token",
      dmPolicy: "pairing",
      allowFrom: ["tg:123456789"],
      groups: {
        "*": { requireMention: true },
        "-1001234567890": {
          allowFrom: ["@admin"],
          systemPrompt: "Keep answers brief.",
          topics: {
            "99": {
              requireMention: false,
              skills: ["search"],
              systemPrompt: "Stay on topic.",
            },
          },
        },
      },
      customCommands: [
        { command: "backup", description: "Git backup" },
        { command: "generate", description: "Create an image" },
      ],
      historyLimit: 50,
      replyToMode: "first", // off | first | all | batched
      linkPreview: true,
      streaming: "partial", // off | partial | block | progress (типово: off; увімкніть явно, щоб уникнути обмежень частоти preview-edit)
      actions: { reactions: true, sendMessage: true },
      reactionNotifications: "own", // off | own | all
      mediaMaxMb: 100,
      retry: {
        attempts: 3,
        minDelayMs: 400,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
      network: {
        autoSelectFamily: true,
        dnsResultOrder: "ipv4first",
      },
      proxy: "socks5://localhost:9050",
      webhookUrl: "https://example.com/telegram-webhook",
      webhookSecret: "secret",
      webhookPath: "/telegram-webhook",
    },
  },
}

• Токен бота: channels.telegram.botToken або channels.telegram.tokenFile (лише звичайний файл; символьні посилання відхиляються), з TELEGRAM_BOT_TOKEN як резервним варіантом для типового облікового запису.
• Необов’язковий channels.telegram.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ідентифікатором облікового запису.
• У багатооблікових конфігураціях (2+ ідентифікаторів облікових записів) задайте явний типово вибраний обліковий запис (channels.telegram.defaultAccount або channels.telegram.accounts.default), щоб уникнути резервної маршрутизації; openclaw doctor попереджає, якщо його немає або він некоректний.
• configWrites: false блокує ініційовані з Telegram записи конфігурації (міграції ID супергруп, /config set|unset).
• Записи верхнього рівня bindings[] із type: "acp" налаштовують постійні ACP-прив’язки для тем форуму (використовуйте канонічний chatId:topic:topicId у match.peer.id). Семантика полів є спільною в ACP Agents.
• Попередній перегляд потокової передачі в Telegram використовує sendMessage + editMessageText (працює в особистих і групових чатах).
• Політика повторних спроб: див. Retry policy.

​

Discord

{
  channels: {
    discord: {
      enabled: true,
      token: "your-bot-token",
      mediaMaxMb: 100,
      allowBots: false,
      actions: {
        reactions: true,
        stickers: true,
        polls: true,
        permissions: true,
        messages: true,
        threads: true,
        pins: true,
        search: true,
        memberInfo: true,
        roleInfo: true,
        roles: false,
        channelInfo: true,
        voiceStatus: true,
        events: true,
        moderation: false,
      },
      replyToMode: "off", // off | first | all | batched
      dmPolicy: "pairing",
      allowFrom: ["1234567890", "123456789012345678"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["openclaw-dm"] },
      guilds: {
        "123456789012345678": {
          slug: "friends-of-openclaw",
          requireMention: false,
          ignoreOtherMentions: true,
          reactionNotifications: "own",
          users: ["987654321098765432"],
          channels: {
            general: { allow: true },
            help: {
              allow: true,
              requireMention: true,
              users: ["987654321098765432"],
              skills: ["docs"],
              systemPrompt: "Short answers only.",
            },
          },
        },
      },
      historyLimit: 20,
      textChunkLimit: 2000,
      chunkMode: "length", // length | newline
      streaming: "off", // off | partial | block | progress (progress відповідає partial у Discord)
      maxLinesPerMessage: 17,
      ui: {
        components: {
          accentColor: "#5865F2",
        },
      },
      threadBindings: {
        enabled: true,
        idleHours: 24,
        maxAgeHours: 0,
        spawnSubagentSessions: false, // увімкнення за бажанням для sessions_spawn({ thread: true })
      },
      voice: {
        enabled: true,
        autoJoin: [
          {
            guildId: "123456789012345678",
            channelId: "234567890123456789",
          },
        ],
        daveEncryption: true,
        decryptionFailureTolerance: 24,
        tts: {
          provider: "openai",
          openai: { voice: "alloy" },
        },
      },
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["987654321098765432"],
        agentFilter: ["default"],
        sessionFilter: ["discord:"],
        target: "dm", // dm | channel | both
        cleanupAfterResolve: false,
      },
      retry: {
        attempts: 3,
        minDelayMs: 500,
        maxDelayMs: 30000,
        jitter: 0.1,
      },
    },
  },
}

• Токен: channels.discord.token, з DISCORD_BOT_TOKEN як резервним варіантом для типового облікового запису.
• Прямі вихідні виклики, що надають явний Discord token, використовують цей токен для виклику; налаштування повторних спроб/політик облікового запису все одно беруться з вибраного облікового запису в активному знімку runtime.
• Необов’язковий channels.discord.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ідентифікатором облікового запису.
• Використовуйте user:<id> (DM) або channel:<id> (канал guild) для цілей доставки; прості числові ID відхиляються.
• Slug-и guild — у нижньому регістрі, а пробіли замінюються на -; ключі каналів використовують slug-ім’я (без #). Надавайте перевагу ID guild.
• Повідомлення, створені ботом, типово ігноруються. allowBots: true вмикає їх; використовуйте allowBots: "mentions", щоб приймати лише повідомлення ботів, які згадують бота (власні повідомлення все одно відфільтровуються).
• channels.discord.guilds.<id>.ignoreOtherMentions (і перевизначення каналу) відкидає повідомлення, які згадують іншого користувача або роль, але не бота (крім @everyone/@here).
• maxLinesPerMessage (типово 17) розбиває високі повідомлення навіть тоді, коли вони не перевищують 2000 символів.
• channels.discord.threadBindings керує маршрутизацією, прив’язаною до гілок Discord:
  • enabled: перевизначення Discord для функцій сеансів, прив’язаних до гілок (/focus, /unfocus, /agents, /session idle, /session max-age і прив’язана доставка/маршрутизація)
  • idleHours: перевизначення Discord для автоматичного зняття фокуса через неактивність у годинах (0 вимикає)
  • maxAgeHours: перевизначення Discord для жорсткого максимального віку в годинах (0 вимикає)
  • spawnSubagentSessions: перемикач opt-in для автоматичного створення/прив’язки гілок у sessions_spawn({ thread: true })
• Записи верхнього рівня bindings[] із type: "acp" налаштовують постійні ACP-прив’язки для каналів і гілок (використовуйте id каналу/гілки в match.peer.id). Семантика полів є спільною в ACP Agents.
• channels.discord.ui.components.accentColor задає колір акценту для контейнерів компонентів Discord v2.
• channels.discord.voice вмикає розмови в голосових каналах Discord і необов’язкові перевизначення auto-join + TTS.
• channels.discord.voice.daveEncryption і channels.discord.voice.decryptionFailureTolerance напряму передаються до параметрів DAVE у @discordjs/voice (типово true і 24).
• OpenClaw також намагається відновити голосовий прийом, виходячи та повторно приєднуючись до голосового сеансу після повторних збоїв дешифрування.
• channels.discord.streaming — це канонічний ключ режиму потоку. Застарілі streamMode і булеві значення streaming мігруються автоматично.
• channels.discord.autoPresence відображає доступність runtime на присутність бота (healthy => online, degraded => idle, exhausted => dnd) і дозволяє необов’язкові перевизначення тексту статусу.
• channels.discord.dangerouslyAllowNameMatching знову вмикає зіставлення за змінюваними іменами/тегами (режим сумісності break-glass).
• channels.discord.execApprovals: доставка схвалень exec у стилі Discord і авторизація тих, хто схвалює.
  • enabled: true, false або "auto" (типово). У режимі auto схвалення exec активуються, коли тих, хто схвалює, можна визначити з approvers або commands.ownerAllowFrom.
  • approvers: ID користувачів Discord, яким дозволено схвалювати запити exec. Якщо не вказано, використовується commands.ownerAllowFrom.
  • agentFilter: необов’язковий список дозволених ID агентів. Не вказуйте, щоб пересилати схвалення для всіх агентів.
  • sessionFilter: необов’язкові шаблони ключів сеансів (підрядок або regex).
  • target: куди надсилати запити на схвалення. "dm" (типово) надсилає в DM тим, хто схвалює, "channel" надсилає у вихідний канал, "both" надсилає в обидва місця. Коли target включає "channel", кнопками можуть користуватися лише визначені як такі, що схвалюють.
  • cleanupAfterResolve: якщо true, видаляє DM зі схваленням після схвалення, відхилення або тайм-ауту.

​

Google Chat

{
  channels: {
    googlechat: {
      enabled: true,
      serviceAccountFile: "/path/to/service-account.json",
      audienceType: "app-url", // app-url | project-number
      audience: "https://gateway.example.com/googlechat",
      webhookPath: "/googlechat",
      botUser: "users/1234567890",
      dm: {
        enabled: true,
        policy: "pairing",
        allowFrom: ["users/1234567890"],
      },
      groupPolicy: "allowlist",
      groups: {
        "spaces/AAAA": { allow: true, requireMention: true },
      },
      actions: { reactions: true },
      typingIndicator: "message",
      mediaMaxMb: 20,
    },
  },
}

• JSON облікового запису служби: вбудований (serviceAccount) або з файла (serviceAccountFile).
• Також підтримується SecretRef облікового запису служби (serviceAccountRef).
• Резервні варіанти через env: GOOGLE_CHAT_SERVICE_ACCOUNT або GOOGLE_CHAT_SERVICE_ACCOUNT_FILE.
• Використовуйте spaces/<spaceId> або users/<userId> для цілей доставки.
• channels.googlechat.dangerouslyAllowNameMatching знову вмикає зіставлення за змінюваним email principal (режим сумісності break-glass).

​

Slack

{
  channels: {
    slack: {
      enabled: true,
      botToken: "xoxb-...",
      appToken: "xapp-...",
      dmPolicy: "pairing",
      allowFrom: ["U123", "U456", "*"],
      dm: { enabled: true, groupEnabled: false, groupChannels: ["G123"] },
      channels: {
        C123: { allow: true, requireMention: true, allowBots: false },
        "#general": {
          allow: true,
          requireMention: true,
          allowBots: false,
          users: ["U123"],
          skills: ["docs"],
          systemPrompt: "Short answers only.",
        },
      },
      historyLimit: 50,
      allowBots: false,
      reactionNotifications: "own",
      reactionAllowlist: ["U123"],
      replyToMode: "off", // off | first | all | batched
      thread: {
        historyScope: "thread", // thread | channel
        inheritParent: false,
      },
      actions: {
        reactions: true,
        messages: true,
        pins: true,
        memberInfo: true,
        emojiList: true,
      },
      slashCommand: {
        enabled: true,
        name: "openclaw",
        sessionPrefix: "slack:slash",
        ephemeral: true,
      },
      typingReaction: "hourglass_flowing_sand",
      textChunkLimit: 4000,
      chunkMode: "length",
      streaming: {
        mode: "partial", // off | partial | block | progress
        nativeTransport: true, // використовувати власний streaming API Slack, коли mode=partial
      },
      mediaMaxMb: 20,
      execApprovals: {
        enabled: "auto", // true | false | "auto"
        approvers: ["U123"],
        agentFilter: ["default"],
        sessionFilter: ["slack:"],
        target: "dm", // dm | channel | both
      },
    },
  },
}

• Режим Socket вимагає і botToken, і appToken (SLACK_BOT_TOKEN + SLACK_APP_TOKEN як резервний варіант env для типового облікового запису).
• Режим HTTP вимагає botToken плюс signingSecret (у корені або для кожного облікового запису).
• botToken, appToken, signingSecret і userToken приймають відкриті рядки або об’єкти SecretRef.
• Знімки облікових записів Slack показують поля джерела/статусу для кожного облікового даного, наприклад botTokenSource, botTokenStatus, appTokenStatus, а в режимі HTTP — signingSecretStatus. configured_unavailable означає, що обліковий запис налаштований через SecretRef, але поточний шлях команди/runtime не зміг визначити значення секрету.
• configWrites: false блокує записи конфігурації, ініційовані зі Slack.
• Необов’язковий channels.slack.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ідентифікатором облікового запису.
• channels.slack.streaming.mode — канонічний ключ режиму потоку Slack. channels.slack.streaming.nativeTransport керує власним транспортом потокової передачі Slack. Застарілі streamMode, булеві значення streaming і nativeStreaming мігруються автоматично.
• Використовуйте user:<id> (DM) або channel:<id> для цілей доставки.

• Власна потокова передача Slack разом зі статусом гілки Slack у стилі помічника “is typing…” вимагають ціль відповіді у гілці. DM верхнього рівня типово залишаються поза гілкою, тому вони використовують typingReaction або звичайну доставку замість попереднього перегляду у стилі гілки.
• typingReaction додає тимчасову реакцію до вхідного повідомлення Slack, поки виконується відповідь, а потім видаляє її після завершення. Використовуйте shortcode емодзі Slack, наприклад "hourglass_flowing_sand".
• channels.slack.execApprovals: доставка схвалень exec у стилі Slack і авторизація тих, хто схвалює. Та сама схема, що й у Discord: enabled (true/false/"auto"), approvers (ID користувачів Slack), agentFilter, sessionFilter і target ("dm", "channel" або "both").

​

Mattermost

{
  channels: {
    mattermost: {
      enabled: true,
      botToken: "mm-token",
      baseUrl: "https://chat.example.com",
      dmPolicy: "pairing",
      chatmode: "oncall", // oncall | onmessage | onchar
      oncharPrefixes: [">", "!"],
      groups: {
        "*": { requireMention: true },
        "team-channel-id": { requireMention: false },
      },
      commands: {
        native: true, // увімкнення за бажанням
        nativeSkills: true,
        callbackPath: "/api/channels/mattermost/command",
        // Необов’язкова явна URL-адреса для розгортань із reverse proxy/публічним доступом
        callbackUrl: "https://gateway.example.com/api/channels/mattermost/command",
      },
      textChunkLimit: 4000,
      chunkMode: "length",
    },
  },
}

• commands.callbackPath має бути шляхом (наприклад /api/channels/mattermost/command), а не повною URL-адресою.
• commands.callbackUrl має вказувати на endpoint шлюзу OpenClaw і бути доступною з сервера Mattermost.
• Власні slash callback-обробники автентифікуються за токенами кожної команди, які Mattermost повертає під час реєстрації slash command. Якщо реєстрація не вдається або жодну команду не активовано, OpenClaw відхиляє callback-и з помилкою Unauthorized: invalid command token.
• Для приватних/tailnet/internal callback-хостів Mattermost може вимагати, щоб ServiceSettings.AllowedUntrustedInternalConnections включав callback-хост/домен. Використовуйте значення хоста/домену, а не повні URL-адреси.
• channels.mattermost.configWrites: дозволяти або забороняти записи конфігурації, ініційовані з Mattermost.
• channels.mattermost.requireMention: вимагати @mention перед відповіддю в каналах.
• channels.mattermost.groups.<channelId>.requireMention: перевизначення контролю згадування для конкретного каналу ("*" для типового значення).
• Необов’язковий channels.mattermost.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ідентифікатором облікового запису.

​

Signal

{
  channels: {
    signal: {
      enabled: true,
      account: "+15555550123", // необов’язкова прив’язка облікового запису
      dmPolicy: "pairing",
      allowFrom: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      configWrites: true,
      reactionNotifications: "own", // off | own | all | allowlist
      reactionAllowlist: ["+15551234567", "uuid:123e4567-e89b-12d3-a456-426614174000"],
      historyLimit: 50,
    },
  },
}

• channels.signal.account: прив’язати запуск каналу до конкретної ідентичності облікового запису Signal.
• channels.signal.configWrites: дозволяти або забороняти записи конфігурації, ініційовані з Signal.
• Необов’язковий channels.signal.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ідентифікатором облікового запису.

​

BlueBubbles

{
  channels: {
    bluebubbles: {
      enabled: true,
      dmPolicy: "pairing",
      // serverUrl, password, webhookPath, group controls, and advanced actions:
      // див. /channels/bluebubbles
    },
  },
}

• Основні шляхи ключів, охоплені тут: channels.bluebubbles, channels.bluebubbles.dmPolicy.
• Необов’язковий channels.bluebubbles.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ідентифікатором облікового запису.
• Записи верхнього рівня bindings[] із type: "acp" можуть прив’язувати розмови BlueBubbles до постійних сеансів ACP. Використовуйте handle BlueBubbles або рядок цілі (chat_id:*, chat_guid:*, chat_identifier:*) у match.peer.id. Спільна семантика полів: ACP Agents.
• Повну конфігурацію каналу BlueBubbles описано в BlueBubbles.

​

iMessage

{
  channels: {
    imessage: {
      enabled: true,
      cliPath: "imsg",
      dbPath: "~/Library/Messages/chat.db",
      remoteHost: "user@gateway-host",
      dmPolicy: "pairing",
      allowFrom: ["+15555550123", "user@example.com", "chat_id:123"],
      historyLimit: 50,
      includeAttachments: false,
      attachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      remoteAttachmentRoots: ["/Users/*/Library/Messages/Attachments"],
      mediaMaxMb: 16,
      service: "auto",
      region: "US",
    },
  },
}

• Необов’язковий channels.imessage.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ідентифікатором облікового запису.
• Потрібен Full Disk Access до БД Messages.
• Надавайте перевагу цілям chat_id:<id>. Використовуйте imsg chats --limit 20, щоб переглянути список чатів.
• cliPath може вказувати на SSH-обгортку; задайте remoteHost (host або user@host) для отримання вкладень через SCP.
• attachmentRoots і remoteAttachmentRoots обмежують шляхи вхідних вкладень (типово: /Users/*/Library/Messages/Attachments).
• SCP використовує сувору перевірку ключа хоста, тому переконайтеся, що ключ relay-хоста вже існує в ~/.ssh/known_hosts.
• channels.imessage.configWrites: дозволяти або забороняти записи конфігурації, ініційовані з iMessage.
• Записи верхнього рівня bindings[] із type: "acp" можуть прив’язувати розмови iMessage до постійних сеансів ACP. Використовуйте нормалізований handle або явну ціль чату (chat_id:*, chat_guid:*, chat_identifier:*) у match.peer.id. Спільна семантика полів: ACP Agents.

#!/usr/bin/env bash
exec ssh -T gateway-host imsg "$@"

​

Matrix

{
  channels: {
    matrix: {
      enabled: true,
      homeserver: "https://matrix.example.org",
      accessToken: "syt_bot_xxx",
      proxy: "http://127.0.0.1:7890",
      encryption: true,
      initialSyncLimit: 20,
      defaultAccount: "ops",
      accounts: {
        ops: {
          name: "Ops",
          userId: "@ops:example.org",
          accessToken: "syt_ops_xxx",
        },
        alerts: {
          userId: "@alerts:example.org",
          password: "secret",
          proxy: "http://127.0.0.1:7891",
        },
      },
    },
  },
}

• Автентифікація за токеном використовує accessToken; автентифікація за паролем використовує userId + password.
• channels.matrix.proxy маршрутизує HTTP-трафік Matrix через явний HTTP(S) proxy. Іменовані облікові записи можуть перевизначити це через channels.matrix.accounts.<id>.proxy.
• channels.matrix.network.dangerouslyAllowPrivateNetwork дозволяє приватні/internal homeserver-и. proxy і цей мережевий opt-in — незалежні елементи керування.
• channels.matrix.defaultAccount вибирає бажаний обліковий запис у багатооблікових конфігураціях.
• channels.matrix.autoJoin типово має значення off, тому запрошені кімнати й нові запрошення у стилі DM ігноруються, доки ви не встановите autoJoin: "allowlist" разом із autoJoinAllowlist або autoJoin: "always".
• channels.matrix.execApprovals: доставка схвалень exec у стилі Matrix і авторизація тих, хто схвалює.
  • enabled: true, false або "auto" (типово). У режимі auto схвалення exec активуються, коли тих, хто схвалює, можна визначити з approvers або commands.ownerAllowFrom.
  • approvers: ID користувачів Matrix (наприклад @owner:example.org), яким дозволено схвалювати запити exec.
  • agentFilter: необов’язковий список дозволених ID агентів. Не вказуйте, щоб пересилати схвалення для всіх агентів.
  • sessionFilter: необов’язкові шаблони ключів сеансів (підрядок або regex).
  • target: куди надсилати запити на схвалення. "dm" (типово), "channel" (вихідна кімната) або "both".
  • Перевизначення для облікового запису: channels.matrix.accounts.<id>.execApprovals.
• channels.matrix.dm.sessionScope керує тим, як DM у Matrix групуються в сеанси: per-user (типово) спільний для маршрутизованого peer, тоді як per-room ізолює кожну DM-кімнату.
• Перевірки статусу Matrix і live-пошуки в каталозі використовують ту саму політику proxy, що й runtime-трафік.
• Повну конфігурацію Matrix, правила таргетингу й приклади налаштування описано в Matrix.

​

Microsoft Teams

{
  channels: {
    msteams: {
      enabled: true,
      configWrites: true,
      // appId, appPassword, tenantId, webhook, team/channel policies:
      // див. /channels/msteams
    },
  },
}

• Основні шляхи ключів, охоплені тут: channels.msteams, channels.msteams.configWrites.
• Повну конфігурацію Teams (облікові дані, webhook, політика DM/груп, перевизначення для окремих team/channel) описано в Microsoft Teams.

​

IRC

{
  channels: {
    irc: {
      enabled: true,
      dmPolicy: "pairing",
      configWrites: true,
      nickserv: {
        enabled: true,
        service: "NickServ",
        password: "${IRC_NICKSERV_PASSWORD}",
        register: false,
        registerEmail: "bot@example.com",
      },
    },
  },
}

• Основні шляхи ключів, охоплені тут: channels.irc, channels.irc.dmPolicy, channels.irc.configWrites, channels.irc.nickserv.*.
• Необов’язковий channels.irc.defaultAccount перевизначає вибір типового облікового запису, коли він збігається з налаштованим ідентифікатором облікового запису.
• Повну конфігурацію каналу IRC (host/port/TLS/channels/allowlists/контроль згадувань) описано в IRC.

​

Багато облікових записів (усі канали)

{
  channels: {
    telegram: {
      accounts: {
        default: {
          name: "Primary bot",
          botToken: "123456:ABC...",
        },
        alerts: {
          name: "Alerts bot",
          botToken: "987654:XYZ...",
        },
      },
    },
  },
}

• default використовується, коли accountId пропущено (CLI + маршрутизація).
• Токени env застосовуються лише до облікового запису default.
• Базові налаштування каналу застосовуються до всіх облікових записів, якщо їх не перевизначено для конкретного облікового запису.
• Використовуйте bindings[].match.accountId, щоб маршрутизувати кожен обліковий запис до іншого агента.
• Якщо ви додаєте не-default обліковий запис через openclaw channels add (або onboarding каналу), залишаючись у топології одноканальної конфігурації верхнього рівня, OpenClaw спочатку переносить значення верхнього рівня для одного облікового запису, прив’язані до облікового запису, у карту облікових записів каналу, щоб початковий обліковий запис продовжив працювати. Більшість каналів переносять їх у channels.<channel>.accounts.default; Matrix натомість може зберегти наявну відповідну іменовану/default ціль.
• Наявні прив’язки лише для каналу (без accountId) і далі відповідатимуть default обліковому запису; прив’язки з областю дії облікового запису залишаються необов’язковими.
• openclaw doctor --fix також виправляє змішані форми, переміщуючи значення верхнього рівня для одного облікового запису, прив’язані до облікового запису, у promoted account, вибраний для цього каналу. Більшість каналів використовують accounts.default; Matrix натомість може зберегти наявну відповідну іменовану/default ціль.

​

Інші канали розширень

​

Контроль згадувань у групових чатах

• Згадки в метаданих: нативні @-згадки платформи. Ігноруються в режимі self-chat WhatsApp.
• Текстові шаблони: безпечні regex-шаблони в agents.list[].groupChat.mentionPatterns. Недійсні шаблони й небезпечні вкладені повторення ігноруються.
• Контроль згадувань застосовується лише тоді, коли виявлення можливе (нативні згадки або принаймні один шаблон).

{
  messages: {
    groupChat: { historyLimit: 50 },
  },
  agents: {
    list: [{ id: "main", groupChat: { mentionPatterns: ["@openclaw", "openclaw"] } }],
  },
}

​

Ліміти історії DM

{
  channels: {
    telegram: {
      dmHistoryLimit: 30,
      dms: {
        "123456789": { historyLimit: 50 },
      },
    },
  },
}

​

Режим self-chat

{
  channels: {
    whatsapp: {
      allowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },
  },
  agents: {
    list: [
      {
        id: "main",
        groupChat: { mentionPatterns: ["reisponde", "@openclaw"] },
      },
    ],
  },
}

​

Команди (обробка команд чату)

{
  commands: {
    native: "auto", // реєструвати нативні команди, коли це підтримується
    nativeSkills: "auto", // реєструвати нативні команди Skills, коли це підтримується
    text: true, // розбирати /commands у повідомленнях чату
    bash: false, // дозволяти ! (псевдонім: /bash)
    bashForegroundMs: 2000,
    config: false, // дозволяти /config
    mcp: false, // дозволяти /mcp
    plugins: false, // дозволяти /plugins
    debug: false, // дозволяти /debug
    restart: true, // дозволяти /restart + інструмент перезапуску шлюзу
    ownerAllowFrom: ["discord:123456789012345678"],
    ownerDisplay: "raw", // raw | hash
    ownerDisplaySecret: "${OWNER_ID_HASH_SECRET}",
    allowFrom: {
      "*": ["user1"],
      discord: ["user:123"],
    },
    useAccessGroups: true,
  },
}

​

Типові значення агента

​

agents.defaults.workspace

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
}

​

agents.defaults.repoRoot

{
  agents: { defaults: { repoRoot: "~/Projects/openclaw" } },
}

​

agents.defaults.skills

{
  agents: {
    defaults: { skills: ["github", "weather"] },
    list: [
      { id: "writer" }, // успадковує github, weather
      { id: "docs", skills: ["docs-search"] }, // замінює типові значення
      { id: "locked-down", skills: [] }, // без Skills
    ],
  },
}

• Пропустіть agents.defaults.skills, щоб типово не обмежувати Skills.
• Пропустіть agents.list[].skills, щоб успадкувати типові значення.
• Встановіть agents.list[].skills: [], щоб не використовувати Skills.
• Непорожній список agents.list[].skills є остаточним набором для цього агента; він не об’єднується з типовими значеннями.

​

agents.defaults.skipBootstrap

{
  agents: { defaults: { skipBootstrap: true } },
}

​

agents.defaults.contextInjection

• "continuation-skip": безпечні ходи продовження (після завершеної відповіді асистента) пропускають повторну вставку bootstrap workspace, зменшуючи розмір prompt. Запуски heartbeat і повторні спроби після ущільнення все одно перебудовують контекст.

{
  agents: { defaults: { contextInjection: "continuation-skip" } },
}

​

agents.defaults.bootstrapMaxChars

{
  agents: { defaults: { bootstrapMaxChars: 20000 } },
}

​

agents.defaults.bootstrapTotalMaxChars

{
  agents: { defaults: { bootstrapTotalMaxChars: 150000 } },
}

​

agents.defaults.bootstrapPromptTruncationWarning

• "off": ніколи не вставляти текст попередження в системний prompt.
• "once": вставляти попередження один раз для кожного унікального сигнатурного обрізання (рекомендовано).
• "always": вставляти попередження під час кожного запуску, коли є обрізання.

{
  agents: { defaults: { bootstrapPromptTruncationWarning: "once" } }, // off | once | always
}

​

agents.defaults.imageMaxDimensionPx

{
  agents: { defaults: { imageMaxDimensionPx: 1200 } },
}

​

agents.defaults.userTimezone

{
  agents: { defaults: { userTimezone: "America/Chicago" } },
}

​

agents.defaults.timeFormat

{
  agents: { defaults: { timeFormat: "auto" } }, // auto | 12 | 24
}

​

agents.defaults.model

{
  agents: {
    defaults: {
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "minimax/MiniMax-M2.7": { alias: "minimax" },
      },
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["minimax/MiniMax-M2.7"],
      },
      imageModel: {
        primary: "openrouter/qwen/qwen-2.5-vl-72b-instruct:free",
        fallbacks: ["openrouter/google/gemini-2.0-flash-vision:free"],
      },
      imageGenerationModel: {
        primary: "openai/gpt-image-1",
        fallbacks: ["google/gemini-3.1-flash-image-preview"],
      },
      videoGenerationModel: {
        primary: "qwen/wan2.6-t2v",
        fallbacks: ["qwen/wan2.6-i2v"],
      },
      pdfModel: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["openai/gpt-5.4-mini"],
      },
      params: { cacheRetention: "long" }, // глобальні типові параметри постачальника
      embeddedHarness: {
        runtime: "auto", // auto | pi | зареєстрований id harness, наприклад codex
        fallback: "pi", // pi | none
      },
      pdfMaxBytesMb: 10,
      pdfMaxPages: 20,
      thinkingDefault: "low",
      verboseDefault: "off",
      elevatedDefault: "on",
      timeoutSeconds: 600,
      mediaMaxMb: 5,
      contextTokens: 200000,
      maxConcurrent: 3,
    },
  },
}

• model: приймає або рядок ("provider/model"), або об’єкт ({ primary, fallbacks }).
  • Рядкова форма задає лише основну модель.
  • Об’єктна форма задає основну модель плюс упорядковані failover-моделі.
• imageModel: приймає або рядок ("provider/model"), або об’єкт ({ primary, fallbacks }).
  • Використовується шляхом інструмента image як його конфігурація vision-моделі.
  • Також використовується як резервна маршрутизація, коли вибрана/типова модель не може приймати вхідні зображення.
• imageGenerationModel: приймає або рядок ("provider/model"), або об’єкт ({ primary, fallbacks }).
  • Використовується спільною можливістю генерації зображень і будь-якою майбутньою поверхнею інструмента/плагіна, що генерує зображення.
  • Типові значення: google/gemini-3.1-flash-image-preview для нативної генерації зображень Gemini, fal/fal-ai/flux/dev для fal або openai/gpt-image-1 для OpenAI Images.
  • Якщо ви вибираєте provider/model напряму, також налаштуйте відповідну автентифікацію постачальника/API key (наприклад GEMINI_API_KEY або GOOGLE_API_KEY для google/*, OPENAI_API_KEY для openai/*, FAL_KEY для fal/*).
  • Якщо не вказано, image_generate усе одно може визначити типове значення постачальника з автентифікацією. Спочатку він пробує поточного типового постачальника, а потім — решту зареєстрованих постачальників генерації зображень у порядку provider-id.
• musicGenerationModel: приймає або рядок ("provider/model"), або об’єкт ({ primary, fallbacks }).
  • Використовується спільною можливістю генерації музики та вбудованим інструментом music_generate.
  • Типові значення: google/lyria-3-clip-preview, google/lyria-3-pro-preview або minimax/music-2.5+.
  • Якщо не вказано, music_generate усе одно може визначити типове значення постачальника з автентифікацією. Спочатку він пробує поточного типового постачальника, а потім — решту зареєстрованих постачальників генерації музики в порядку provider-id.
  • Якщо ви вибираєте provider/model напряму, також налаштуйте відповідну автентифікацію постачальника/API key.
• videoGenerationModel: приймає або рядок ("provider/model"), або об’єкт ({ primary, fallbacks }).
  • Використовується спільною можливістю генерації відео та вбудованим інструментом video_generate.
  • Типові значення: qwen/wan2.6-t2v, qwen/wan2.6-i2v, qwen/wan2.6-r2v, qwen/wan2.6-r2v-flash або qwen/wan2.7-r2v.
  • Якщо не вказано, video_generate усе одно може визначити типове значення постачальника з автентифікацією. Спочатку він пробує поточного типового постачальника, а потім — решту зареєстрованих постачальників генерації відео в порядку provider-id.
  • Якщо ви вибираєте provider/model напряму, також налаштуйте відповідну автентифікацію постачальника/API key.
  • Вбудований постачальник генерації відео Qwen підтримує до 1 вихідного відео, 1 вхідного зображення, 4 вхідних відео, тривалість до 10 секунд і параметри рівня постачальника size, aspectRatio, resolution, audio та watermark.
• pdfModel: приймає або рядок ("provider/model"), або об’єкт ({ primary, fallbacks }).
  • Використовується інструментом pdf для маршрутизації моделі.
  • Якщо не вказано, інструмент PDF резервно використовує imageModel, а потім визначену модель сеансу/типову модель.
• pdfMaxBytesMb: типовий ліміт розміру PDF для інструмента pdf, коли maxBytesMb не передано під час виклику.
• pdfMaxPages: типова максимальна кількість сторінок, що враховуються в режимі резервного вилучення інструмента pdf.
• verboseDefault: типовий рівень verbose для агентів. Значення: "off", "on", "full". Типове значення: "off".
• elevatedDefault: типовий рівень elevated-output для агентів. Значення: "off", "on", "ask", "full". Типове значення: "on".
• model.primary: формат provider/model (наприклад openai/gpt-5.4). Якщо ви пропускаєте постачальника, OpenClaw спочатку намагається знайти псевдонім, потім — унікальний збіг точно цього model id серед налаштованих постачальників, і лише після цього резервно використовує налаштованого типового постачальника (застаріла поведінка сумісності, тому надавайте перевагу явному provider/model). Якщо цей постачальник більше не надає налаштовану типову модель, OpenClaw резервно переходить до першого налаштованого provider/model замість показу застарілого типового значення видаленого постачальника.
• models: налаштований каталог моделей і список дозволів для /model. Кожен запис може містити alias (скорочення) і params (специфічні для постачальника, наприклад temperature, maxTokens, cacheRetention, context1m).
• params: глобальні типові параметри постачальника, які застосовуються до всіх моделей. Задаються в agents.defaults.params (наприклад { cacheRetention: "long" }).
• Пріоритет злиття params (конфігурація): agents.defaults.params (глобальна база) перевизначається agents.defaults.models["provider/model"].params (для конкретної моделі), а потім agents.list[].params (для відповідного id агента) перевизначає за ключем. Докладніше див. у Prompt Caching.
• embeddedHarness: типова політика низькорівневого runtime вбудованого агента. Використовуйте runtime: "auto", щоб дозволити зареєстрованим plugin harness-ам перехоплювати підтримувані моделі, runtime: "pi" — щоб примусово використовувати вбудований PI harness, або зареєстрований id harness, наприклад runtime: "codex". Встановіть fallback: "none", щоб вимкнути автоматичний резервний перехід на PI.
• Засоби запису конфігурації, які змінюють ці поля (наприклад /models set, /models set-image і команди додавання/видалення fallback), зберігають канонічну об’єктну форму та за можливості зберігають наявні списки fallback.
• maxConcurrent: максимальна кількість паралельних запусків агентів між сеансами (кожен сеанс усе одно серіалізується). Типове значення: 4.

​

agents.defaults.embeddedHarness

{
  agents: {
    defaults: {
      model: "codex/gpt-5.4",
      embeddedHarness: {
        runtime: "codex",
        fallback: "none",
      },
    },
  },
}

• runtime: "auto", "pi" або id зареєстрованого plugin harness. Bundled плагін Codex реєструє codex.
• fallback: "pi" або "none". "pi" зберігає вбудований PI harness як резервний варіант сумісності. "none" змушує помилку при відсутньому або непідтримуваному виборі plugin harness замість тихого переходу на PI.
• Перевизначення через середовище: OPENCLAW_AGENT_RUNTIME=<id|auto|pi> перевизначає runtime; OPENCLAW_AGENT_HARNESS_FALLBACK=none вимикає резервний перехід на PI для цього процесу.
• Для розгортань лише з Codex встановіть model: "codex/gpt-5.4", embeddedHarness.runtime: "codex" і embeddedHarness.fallback: "none".
• Це керує лише вбудованим chat harness. Генерація медіа, vision, PDF, музика, відео та TTS усе одно використовують власні налаштування provider/model.

​

agents.defaults.cliBackends

{
  agents: {
    defaults: {
      cliBackends: {
        "codex-cli": {
          command: "/opt/homebrew/bin/codex",
        },
        "my-cli": {
          command: "my-cli",
          args: ["--json"],
          output: "json",
          modelArg: "--model",
          sessionArg: "--session",
          sessionMode: "existing",
          systemPromptArg: "--system",
          systemPromptWhen: "first",
          imageArg: "--image",
          imageMode: "repeat",
        },
      },
    },
  },
}

• CLI-бекенди орієнтовані насамперед на текст; інструменти завжди вимкнені.
• Сеанси підтримуються, коли встановлено sessionArg.
• Передача зображень підтримується, коли imageArg приймає шляхи до файлів.

​

agents.defaults.systemPromptOverride

{
  agents: {
    defaults: {
      systemPromptOverride: "You are a helpful assistant.",
    },
  },
}

​

agents.defaults.heartbeat

{
  agents: {
    defaults: {
      heartbeat: {
        every: "30m", // 0m вимикає
        model: "openai/gpt-5.4-mini",
        includeReasoning: false,
        includeSystemPromptSection: true, // типово: true; false прибирає розділ Heartbeat із системного prompt
        lightContext: false, // типово: false; true залишає лише HEARTBEAT.md із bootstrap-файлів workspace
        isolatedSession: false, // типово: false; true запускає кожен heartbeat у новому сеансі (без історії розмов)
        session: "main",
        to: "+15555550123",
        directPolicy: "allow", // allow (типово) | block
        target: "none", // типово: none | варіанти: last | whatsapp | telegram | discord | ...
        prompt: "Read HEARTBEAT.md if it exists...",
        ackMaxChars: 300,
        suppressToolErrorWarnings: false,
        timeoutSeconds: 45,
      },
    },
  },
}

• every: рядок тривалості (ms/s/m/h). Типове значення: 30m (автентифікація через API key) або 1h (автентифікація через OAuth). Встановіть 0m, щоб вимкнути.
• includeSystemPromptSection: якщо false, прибирає розділ Heartbeat із системного prompt і пропускає вставку HEARTBEAT.md у bootstrap-контекст. Типове значення: true.
• suppressToolErrorWarnings: якщо true, пригнічує payload-и попереджень про помилки інструментів під час запусків heartbeat.
• timeoutSeconds: максимальний час у секундах, дозволений для ходу агента heartbeat до його примусового переривання. Якщо не вказано, використовується agents.defaults.timeoutSeconds.
• directPolicy: політика прямої/DM-доставки. allow (типово) дозволяє доставку на пряму ціль. block пригнічує доставку на пряму ціль і генерує reason=dm-blocked.
• lightContext: якщо true, запуски heartbeat використовують полегшений bootstrap-контекст і зберігають лише HEARTBEAT.md із bootstrap-файлів workspace.
• isolatedSession: якщо true, кожен heartbeat запускається в новому сеансі без попередньої історії розмов. Така сама схема ізоляції, як у cron sessionTarget: "isolated". Зменшує вартість одного heartbeat у токенах приблизно зі ~100K до ~2-5K токенів.
• Для окремого агента: задайте agents.list[].heartbeat. Якщо будь-який агент визначає heartbeat, heartbeat запускаються лише для цих агентів.
• Heartbeat запускає повні ходи агента — коротші інтервали витрачають більше токенів.

​

agents.defaults.compaction

{
  agents: {
    defaults: {
      compaction: {
        mode: "safeguard", // default | safeguard
        provider: "my-provider", // id зареєстрованого плагіна-постачальника compaction (необов’язково)
        timeoutSeconds: 900,
        reserveTokensFloor: 24000,
        identifierPolicy: "strict", // strict | off | custom
        identifierInstructions: "Точно зберігайте ID розгортань, ID квитків і пари host:port.", // використовується, коли identifierPolicy=custom
        postCompactionSections: ["Session Startup", "Red Lines"], // [] вимикає повторну вставку
        model: "openrouter/anthropic/claude-sonnet-4-6", // необов’язкове перевизначення моделі лише для compaction
        notifyUser: true, // надіслати коротке сповіщення, коли починається compaction (типово: false)
        memoryFlush: {
          enabled: true,
          softThresholdTokens: 6000,
          systemPrompt: "Сеанс наближається до compaction. Збережіть тривалі спогади зараз.",
          prompt: "Запишіть усі довготривалі нотатки в memory/YYYY-MM-DD.md; дайте відповідь точним тихим токеном NO_REPLY, якщо нічого зберігати.",
        },
      },
    },
  },
}

• mode: default або safeguard (підсумовування шматками для довгих історій). Див. Compaction.
• provider: id зареєстрованого плагіна-постачальника compaction. Якщо встановлено, замість вбудованого LLM-підсумовування викликається summarize() постачальника. У разі помилки використовується вбудований варіант. Встановлення постачальника примусово задає mode: "safeguard". Див. Compaction.
• timeoutSeconds: максимальна кількість секунд, дозволена для однієї операції compaction, після чого OpenClaw її перериває. Типове значення: 900.
• identifierPolicy: strict (типово), off або custom. strict додає вбудовані вказівки щодо збереження непрозорих ідентифікаторів під час підсумовування compaction.
• identifierInstructions: необов’язковий власний текст щодо збереження ідентифікаторів, який використовується, коли identifierPolicy=custom.
• postCompactionSections: необов’язкові назви розділів H2/H3 у AGENTS.md, які потрібно повторно вставити після compaction. Типове значення — ["Session Startup", "Red Lines"]; встановіть [], щоб вимкнути повторну вставку. Якщо не встановлено або явно встановлено цю типову пару, старі заголовки Every Session/Safety також приймаються як застарілий резервний варіант.
• model: необов’язкове перевизначення provider/model-id лише для підсумовування compaction. Використовуйте це, коли основний сеанс має залишатися на одній моделі, а підсумки compaction мають виконуватися на іншій; якщо не встановлено, compaction використовує основну модель сеансу.
• notifyUser: коли true, надсилає користувачу коротке сповіщення, коли починається compaction (наприклад, “Compacting context…”). Типово вимкнено, щоб compaction залишався тихим.
• memoryFlush: тихий агентний хід перед auto-compaction для збереження довготривалих спогадів. Пропускається, коли workspace доступний лише для читання.

​

agents.defaults.contextPruning

{
  agents: {
    defaults: {
      contextPruning: {
        mode: "cache-ttl", // off | cache-ttl
        ttl: "1h", // тривалість (ms/s/m/h), типова одиниця: хвилини
        keepLastAssistants: 3,
        softTrimRatio: 0.3,
        hardClearRatio: 0.5,
        minPrunableToolChars: 50000,
        softTrim: { maxChars: 4000, headChars: 1500, tailChars: 1500 },
        hardClear: { enabled: true, placeholder: "[Вміст старого результату інструмента очищено]" },
        tools: { deny: ["browser", "canvas"] },
      },
    },
  },
}

​

Блокова потокова передача

{
  agents: {
    defaults: {
      blockStreamingDefault: "off", // on | off
      blockStreamingBreak: "text_end", // text_end | message_end
      blockStreamingChunk: { minChars: 800, maxChars: 1200 },
      blockStreamingCoalesce: { idleMs: 1000 },
      humanDelay: { mode: "natural" }, // off | natural | custom (використовуйте minMs/maxMs)
    },
  },
}

• Канали, крім Telegram, потребують явного *.blockStreaming: true, щоб увімкнути блокові відповіді.
• Перевизначення для каналу: channels.<channel>.blockStreamingCoalesce (і варіанти для окремих облікових записів). Для Signal/Slack/Discord/Google Chat типово minChars: 1500.
• humanDelay: випадкова пауза між блоковими відповідями. natural = 800–2500 мс. Перевизначення для окремого агента: agents.list[].humanDelay.

​

Індикатори набору тексту

{
  agents: {
    defaults: {
      typingMode: "instant", // never | instant | thinking | message
      typingIntervalSeconds: 6,
    },
  },
}

• Типові значення: instant для прямих чатів/згадок, message для групових чатів без згадки.
• Перевизначення для сеансу: session.typingMode, session.typingIntervalSeconds.

​

agents.defaults.sandbox

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // off | non-main | all
        backend: "docker", // docker | ssh | openshell
        scope: "agent", // session | agent | shared
        workspaceAccess: "none", // none | ro | rw
        workspaceRoot: "~/.openclaw/sandboxes",
        docker: {
          image: "openclaw-sandbox:bookworm-slim",
          containerPrefix: "openclaw-sbx-",
          workdir: "/workspace",
          readOnlyRoot: true,
          tmpfs: ["/tmp", "/var/tmp", "/run"],
          network: "none",
          user: "1000:1000",
          capDrop: ["ALL"],
          env: { LANG: "C.UTF-8" },
          setupCommand: "apt-get update && apt-get install -y git curl jq",
          pidsLimit: 256,
          memory: "1g",
          memorySwap: "2g",
          cpus: 1,
          ulimits: {
            nofile: { soft: 1024, hard: 2048 },
            nproc: 256,
          },
          seccompProfile: "/path/to/seccomp.json",
          apparmorProfile: "openclaw-sandbox",
          dns: ["1.1.1.1", "8.8.8.8"],
          extraHosts: ["internal.service:10.0.0.5"],
          binds: ["/home/user/source:/source:rw"],
        },
        ssh: {
          target: "user@gateway-host:22",
          command: "ssh",
          workspaceRoot: "/tmp/openclaw-sandboxes",
          strictHostKeyChecking: true,
          updateHostKeys: true,
          identityFile: "~/.ssh/id_ed25519",
          certificateFile: "~/.ssh/id_ed25519-cert.pub",
          knownHostsFile: "~/.ssh/known_hosts",
          // Також підтримуються SecretRef / вбудований вміст:
          // identityData: { source: "env", provider: "default", id: "SSH_IDENTITY" },
          // certificateData: { source: "env", provider: "default", id: "SSH_CERTIFICATE" },
          // knownHostsData: { source: "env", provider: "default", id: "SSH_KNOWN_HOSTS" },
        },
        browser: {
          enabled: false,
          image: "openclaw-sandbox-browser:bookworm-slim",
          network: "openclaw-sandbox-browser",
          cdpPort: 9222,
          cdpSourceRange: "172.21.0.1/32",
          vncPort: 5900,
          noVncPort: 6080,
          headless: false,
          enableNoVnc: true,
          allowHostControl: false,
          autoStart: true,
          autoStartTimeoutMs: 12000,
        },
        prune: {
          idleHours: 24,
          maxAgeDays: 7,
        },
      },
    },
  },
  tools: {
    sandbox: {
      tools: {
        allow: [
          "exec",
          "process",
          "read",
          "write",
          "edit",
          "apply_patch",
          "sessions_list",
          "sessions_history",
          "sessions_send",
          "sessions_spawn",
          "session_status",
        ],
        deny: ["browser", "canvas", "nodes", "cron", "discord", "gateway"],
      },
    },
  },
}

{
  plugins: {
    entries: {
      openshell: {
        enabled: true,
        config: {
          mode: "mirror", // mirror | remote
          from: "openclaw",
          remoteWorkspaceDir: "/sandbox",
          remoteAgentWorkspaceDir: "/agent",
          gateway: "lab", // необов’язково
          gatewayEndpoint: "https://lab.example", // необов’язково
          policy: "strict", // необов’язковий id політики OpenShell
          providers: ["openai"], // необов’язково
          autoProviders: true,
          timeoutSeconds: 120,
        },
      },
    },
  },
}

scripts/sandbox-setup.sh           # основний образ sandbox
scripts/sandbox-browser-setup.sh   # необов’язковий образ браузера

​

agents.list (перевизначення для окремого агента)

{
  agents: {
    list: [
      {
        id: "main",
        default: true,
        name: "Main Agent",
        workspace: "~/.openclaw/workspace",
        agentDir: "~/.openclaw/agents/main/agent",
        model: "anthropic/claude-opus-4-6", // або { primary, fallbacks }
        thinkingDefault: "high", // перевизначення рівня thinking для окремого агента
        reasoningDefault: "on", // перевизначення видимості reasoning для окремого агента
        fastModeDefault: false, // перевизначення fast mode для окремого агента
        embeddedHarness: { runtime: "auto", fallback: "pi" },
        params: { cacheRetention: "none" }, // перевизначає params відповідних defaults.models за ключем
        skills: ["docs-search"], // замінює agents.defaults.skills, якщо встановлено
        identity: {
          name: "Samantha",
          theme: "helpful sloth",
          emoji: "🦥",
          avatar: "avatars/samantha.png",
        },
        groupChat: { mentionPatterns: ["@openclaw"] },
        sandbox: { mode: "off" },
        runtime: {
          type: "acp",
          acp: {
            agent: "codex",
            backend: "acpx",
            mode: "persistent",
            cwd: "/workspace/openclaw",
          },
        },
        subagents: { allowAgents: ["*"] },
        tools: {
          profile: "coding",
          allow: ["browser"],
          deny: ["canvas"],
          elevated: { enabled: true },
        },
      },
    ],
  },
}

• id: стабільний id агента (обов’язково).
• default: якщо встановлено для кількох агентів, перемагає перший (записується попередження). Якщо не встановлено ніде, типово використовується перший елемент списку.
• model: рядкова форма перевизначає лише primary; об’єктна форма { primary, fallbacks } перевизначає обидва ([] вимикає глобальні fallback-и). Cron jobs, які перевизначають лише primary, усе ще успадковують типові fallback-и, якщо ви не встановите fallbacks: [].
• params: параметри потоку для окремого агента, що зливаються поверх вибраного запису моделі в agents.defaults.models. Використовуйте це для перевизначень на рівні агента, таких як cacheRetention, temperature або maxTokens, без дублювання всього каталогу моделей.
• skills: необов’язковий список дозволів Skills для окремого агента. Якщо не вказано, агент успадковує agents.defaults.skills, коли їх задано; явний список замінює типові значення замість злиття, а [] означає відсутність Skills.
• thinkingDefault: необов’язковий типовий рівень thinking для окремого агента (off | minimal | low | medium | high | xhigh | adaptive). Перевизначає agents.defaults.thinkingDefault для цього агента, коли не задано перевизначення для повідомлення або сеансу.
• reasoningDefault: необов’язковий типовий рівень видимості reasoning для окремого агента (on | off | stream). Застосовується, коли не задано перевизначення reasoning для повідомлення або сеансу.
• fastModeDefault: необов’язкове типове значення fast mode для окремого агента (true | false). Застосовується, коли не задано перевизначення fast-mode для повідомлення або сеансу.
• embeddedHarness: необов’язкове перевизначення політики низькорівневого harness для окремого агента. Використовуйте { runtime: "codex", fallback: "none" }, щоб зробити один агент лише Codex, тоді як інші агенти зберігатимуть типовий резервний варіант PI.
• runtime: необов’язковий дескриптор runtime для окремого агента. Використовуйте type: "acp" з типовими значеннями runtime.acp (agent, backend, mode, cwd), коли агент має типово використовувати сеанси ACP harness.
• identity.avatar: шлях відносно workspace, URL http(s) або URI data:.
• identity виводить типові значення: ackReaction із emoji, mentionPatterns із name/emoji.
• subagents.allowAgents: список дозволених id агентів для sessions_spawn (["*"] = будь-який; типово: лише той самий агент).
• Захист успадкування sandbox: якщо сеанс-запитувач виконується в sandbox, sessions_spawn відхиляє цілі, які працювали б без sandbox.
• subagents.requireAgentId: якщо true, блокує виклики sessions_spawn, у яких пропущено agentId (примушує явний вибір профілю; типово: false).

​

Маршрутизація кількох агентів

{
  agents: {
    list: [
      { id: "home", default: true, workspace: "~/.openclaw/workspace-home" },
      { id: "work", workspace: "~/.openclaw/workspace-work" },
    ],
  },
  bindings: [
    { agentId: "home", match: { channel: "whatsapp", accountId: "personal" } },
    { agentId: "work", match: { channel: "whatsapp", accountId: "biz" } },
  ],
}

​

Поля відповідності binding

• type (необов’язково): route для звичайної маршрутизації (якщо тип не вказано, використовується route), acp для постійних ACP-прив’язок розмов.
• match.channel (обов’язково)
• match.accountId (необов’язково; * = будь-який обліковий запис; якщо пропущено = типовий обліковий запис)
• match.peer (необов’язково; { kind: direct|group|channel, id })
• match.guildId / match.teamId (необов’язково; специфічно для каналу)
• acp (необов’язково; лише для записів type: "acp"): { mode, label, cwd, backend }

1. match.peer
2. match.guildId
3. match.teamId
4. match.accountId (точний збіг, без peer/guild/team)
5. match.accountId: "*" (на рівні каналу)
6. Типовий агент

​

Профілі доступу для окремих агентів

{
  agents: {
    list: [
      {
        id: "personal",
        workspace: "~/.openclaw/workspace-personal",
        sandbox: { mode: "off" },
      },
    ],
  },
}

{
  agents: {
    list: [
      {
        id: "family",
        workspace: "~/.openclaw/workspace-family",
        sandbox: { mode: "all", scope: "agent", workspaceAccess: "ro" },
        tools: {
          allow: [
            "read",
            "sessions_list",
            "sessions_history",
            "sessions_send",
            "sessions_spawn",
            "session_status",
          ],
          deny: ["write", "edit", "apply_patch", "exec", "process", "browser"],
        },
      },
    ],
  },
}

{
  agents: {
    list: [
      {
        id: "public",
        workspace: "~/.openclaw/workspace-public",
        sandbox: { mode: "all", scope: "agent", workspaceAccess: "none" },
        tools: {
          allow: [
            "sessions_list",
            "sessions_history",
            "sessions_send",
            "sessions_spawn",
            "session_status",
            "whatsapp",
            "telegram",
            "slack",
            "discord",
            "gateway",
          ],
          deny: [
            "read",
            "write",
            "edit",
            "apply_patch",
            "exec",
            "process",
            "browser",
            "canvas",
            "nodes",
            "cron",
            "gateway",
            "image",
          ],
        },
      },
    ],
  },
}

​

Сеанс

{
  session: {
    scope: "per-sender",
    dmScope: "main", // main | per-peer | per-channel-peer | per-account-channel-peer
    identityLinks: {
      alice: ["telegram:123456789", "discord:987654321012345678"],
    },
    reset: {
      mode: "daily", // daily | idle
      atHour: 4,
      idleMinutes: 60,
    },
    resetByType: {
      thread: { mode: "daily", atHour: 4 },
      direct: { mode: "idle", idleMinutes: 240 },
      group: { mode: "idle", idleMinutes: 120 },
    },
    resetTriggers: ["/new", "/reset"],
    store: "~/.openclaw/agents/{agentId}/sessions/sessions.json",
    parentForkMaxTokens: 100000, // пропустити fork батьківської гілки вище цього ліміту токенів (0 вимикає)
    maintenance: {
      mode: "warn", // warn | enforce
      pruneAfter: "30d",
      maxEntries: 500,
      rotateBytes: "10mb",
      resetArchiveRetention: "30d", // тривалість або false
      maxDiskBytes: "500mb", // необов’язковий жорсткий бюджет
      highWaterBytes: "400mb", // необов’язкова ціль очищення
    },
    threadBindings: {
      enabled: true,
      idleHours: 24, // типове автоматичне зняття фокуса через неактивність у годинах (`0` вимикає)
      maxAgeHours: 0, // типовий жорсткий максимальний вік у годинах (`0` вимикає)
    },
    mainKey: "main", // застаріле (runtime завжди використовує "main")
    agentToAgent: { maxPingPongTurns: 5 },
    sendPolicy: {
      rules: [{ action: "deny", match: { channel: "discord", chatType: "group" } }],
      default: "allow",
    },
  },
}

​

Повідомлення

{
  messages: {
    responsePrefix: "🦞", // або "auto"
    ackReaction: "👀",
    ackReactionScope: "group-mentions", // group-mentions | group-all | direct | all
    removeAckAfterReply: false,
    queue: {
      mode: "collect", // steer | followup | collect | steer-backlog | steer+backlog | queue | interrupt
      debounceMs: 1000,
      cap: 20,
      drop: "summarize", // old | new | summarize
      byChannel: {
        whatsapp: "collect",
        telegram: "collect",
      },
    },
    inbound: {
      debounceMs: 2000, // 0 вимикає
      byChannel: {
        whatsapp: 5000,
        slack: 1500,
      },
    },
  },
}

​

Префікс відповіді

​

Реакція-підтвердження

• Типово береться з identity.emoji активного агента, інакше "👀". Встановіть "", щоб вимкнути.
• Перевизначення для каналу: channels.<channel>.ackReaction, channels.<channel>.accounts.<id>.ackReaction.
• Порядок вирішення: обліковий запис → канал → messages.ackReaction → резервне значення identity.
• Область: group-mentions (типово), group-all, direct, all.
• removeAckAfterReply: видаляє ack після відповіді у Slack, Discord і Telegram.
• messages.statusReactions.enabled: вмикає реакції життєвого циклу статусу у Slack, Discord і Telegram. У Slack і Discord, якщо не встановлено, реакції статусу залишаються ввімкненими, коли активні реакції ack. У Telegram встановіть це явно в true, щоб увімкнути реакції життєвого циклу статусу.

​

Debounce для вхідних повідомлень

​

TTS (перетворення тексту на мовлення)

{
  messages: {
    tts: {
      auto: "always", // off | always | inbound | tagged
      mode: "final", // final | all
      provider: "elevenlabs",
      summaryModel: "openai/gpt-4.1-mini",
      modelOverrides: { enabled: true },
      maxTextLength: 4000,
      timeoutMs: 30000,
      prefsPath: "~/.openclaw/settings/tts.json",
      elevenlabs: {
        apiKey: "elevenlabs_api_key",
        baseUrl: "https://api.elevenlabs.io",
        voiceId: "voice_id",
        modelId: "eleven_multilingual_v2",
        seed: 42,
        applyTextNormalization: "auto",
        languageCode: "en",
        voiceSettings: {
          stability: 0.5,
          similarityBoost: 0.75,
          style: 0.0,
          useSpeakerBoost: true,
          speed: 1.0,
        },
      },
      openai: {
        apiKey: "openai_api_key",
        baseUrl: "https://api.openai.com/v1",
        model: "gpt-4o-mini-tts",
        voice: "alloy",
      },
    },
  },
}