Примеры конфигурации

Приведённые ниже примеры соответствуют текущей схеме конфигурации. Полный справочник и примечания по каждому полю см. в разделе Конфигурация.

Быстрый старт

Абсолютный минимум

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: { whatsapp: { allowFrom: ["+15555550123"] } },
}

Сохраните в ~/.openclaw/openclaw.json, после чего можно будет отправлять боту личные сообщения с этого номера.

Расширенный пример (основные параметры)

JSON5 позволяет использовать комментарии и завершающие запятые. Обычный JSON также поддерживается.

{
  // Окружение + оболочка
  env: {
    OPENROUTER_API_KEY: "sk-or-...",
    vars: {
      GROQ_API_KEY: "gsk-...",
    },
    shellEnv: {
      enabled: true,
      timeoutMs: 15000,
    },
  },

  // Метаданные профилей аутентификации (секреты хранятся в auth-profiles.json)
  auth: {
    profiles: {
      "anthropic:default": { provider: "anthropic", mode: "api_key" },
      "anthropic:work": { provider: "anthropic", mode: "api_key" },
      "openai:default": { provider: "openai", mode: "api_key" },
      "openai:personal": { provider: "openai", mode: "oauth" },
    },
    order: {
      anthropic: ["anthropic:default", "anthropic:work"],
      openai: ["openai:personal", "openai:default"],
    },
  },

  // Идентификация задаётся отдельно для каждого агента — укажите её ниже в agents.list[].identity.

  // Ведение журналов
  logging: {
    level: "info",
    file: "/tmp/openclaw/openclaw.log",
    consoleLevel: "info",
    consoleStyle: "pretty",
    redactSensitive: "tools",
  },

  // Форматирование сообщений
  messages: {
    messagePrefix: "[openclaw]",
    visibleReplies: "automatic",
    responsePrefix: ">",
    ackReaction: "👀",
    ackReactionScope: "group-mentions",
    groupChat: {
      historyLimit: 50,
      visibleReplies: "message_tool", // включите для общих комнат с моделями, надёжно использующими инструменты
      unmentionedInbound: "room_event",
    },
    queue: {
      mode: "followup",
      debounceMs: 500,
      cap: 20,
      drop: "summarize",
      byChannel: {
        whatsapp: "followup",
        telegram: "followup",
        discord: "collect",
        slack: "collect",
        signal: "followup",
        imessage: "followup",
        webchat: "followup",
      },
    },
  },

  // Инструменты
  tools: {
    media: {
      audio: {
        enabled: true,
        maxBytes: 20971520,
        models: [
          { provider: "openai", model: "gpt-4o-transcribe" },
          // Необязательный резервный вариант через CLI (исполняемый файл Whisper):
          // { type: "cli", command: "whisper", args: ["--model", "base", "{{MediaPath}}"] }
        ],
        timeoutSeconds: 120,
      },
      video: {
        enabled: true,
        maxBytes: 52428800,
        models: [{ provider: "google", model: "gemini-3-flash-preview" }],
      },
    },
  },

  // Поведение сеанса
  session: {
    scope: "per-sender",
    dmScope: "per-channel-peer", // рекомендуется для входящих сообщений от нескольких пользователей
    reset: {
      mode: "daily",
      atHour: 4,
      idleMinutes: 60,
    },
    resetByChannel: {
      discord: { mode: "idle", idleMinutes: 10080 },
    },
    resetTriggers: ["/new", "/reset"],
    store: "~/.openclaw/agents/main/sessions/sessions.json",
    maintenance: {
      mode: "warn",
      pruneAfter: "30d",
      maxEntries: 500,
      resetArchiveRetention: "30d", // длительность или false
      maxDiskBytes: "500mb", // необязательно
      highWaterBytes: "400mb", // необязательно (по умолчанию 80% от maxDiskBytes)
    },
    typingIntervalSeconds: 5,
    sendPolicy: {
      default: "allow",
      rules: [{ action: "deny", match: { channel: "discord", chatType: "group" } }],
    },
  },

  // Каналы
  channels: {
    whatsapp: {
      dmPolicy: "pairing",
      allowFrom: ["+15555550123"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["+15555550123"],
      groups: { "*": { requireMention: true } },
    },

    telegram: {
      enabled: true,
      botToken: "YOUR_TELEGRAM_BOT_TOKEN",
      allowFrom: ["123456789"],
      groupPolicy: "allowlist",
      groupAllowFrom: ["123456789"],
      groups: { "*": { requireMention: true } },
    },

    discord: {
      enabled: true,
      token: "YOUR_DISCORD_BOT_TOKEN",
      dm: { enabled: true, allowFrom: ["123456789012345678"] },
      guilds: {
        "123456789012345678": {
          slug: "friends-of-openclaw",
          requireMention: false,
          channels: {
            general: { enabled: true },
            help: { enabled: true, requireMention: true },
          },
        },
      },
    },

    slack: {
      enabled: true,
      botToken: "xoxb-REPLACE_ME",
      appToken: "xapp-REPLACE_ME",
      channels: {
        "#general": { enabled: true, requireMention: true },
      },
      dm: { enabled: true, allowFrom: ["U123"] },
      slashCommand: {
        enabled: true,
        name: "openclaw",
        sessionPrefix: "slack:slash",
        ephemeral: true,
      },
    },
  },

  // Среда выполнения агента
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      userTimezone: "America/Chicago",
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["anthropic/claude-opus-4-6", "openai/gpt-5.4"],
      },
      imageModel: {
        primary: "openrouter/anthropic/claude-sonnet-4-6",
      },
      models: {
        "anthropic/claude-opus-4-6": { alias: "opus" },
        "anthropic/claude-sonnet-4-6": { alias: "sonnet" },
        "openai/gpt-5.4": { alias: "gpt" },
      },
      skills: ["github", "weather"], // наследуется агентами, у которых отсутствует list[].skills
      thinkingDefault: "low",
      verboseDefault: "off",
      toolProgressDetail: "explain",
      reasoningDefault: "off",
      elevatedDefault: "on",
      blockStreamingDefault: "off",
      blockStreamingBreak: "text_end",
      blockStreamingChunk: {
        minChars: 800,
        maxChars: 1200,
        breakPreference: "paragraph",
      },
      blockStreamingCoalesce: {
        idleMs: 1000,
      },
      humanDelay: {
        mode: "natural",
      },
      timeoutSeconds: 600,
      mediaMaxMb: 5,
      typingIntervalSeconds: 5,
      maxConcurrent: 3,
      heartbeat: {
        every: "30m",
        model: "anthropic/claude-sonnet-4-6",
        target: "last",
        directPolicy: "allow", // allow (по умолчанию) | block
        to: "+15555550123",
        prompt: "HEARTBEAT",
        ackMaxChars: 300,
      },
      memorySearch: {
        provider: "gemini",
        model: "gemini-embedding-001",
        remote: {
          apiKey: "${GEMINI_API_KEY}",
        },
        extraPaths: ["../team-docs", "/srv/shared-notes"],
      },
      sandbox: {
        mode: "non-main",
        scope: "session", // предпочтительнее устаревшего perSession: true
        workspaceRoot: "~/.openclaw/sandboxes",
        docker: {
          image: "openclaw-sandbox:bookworm-slim",
          workdir: "/workspace",
          readOnlyRoot: true,
          tmpfs: ["/tmp", "/var/tmp", "/run"],
          network: "none",
          user: "1000:1000",
        },
        browser: {
          enabled: false,
        },
      },
    },
    list: [
      {
        id: "main",
        default: true,
        identity: {
          name: "Samantha",
          theme: "отзывчивый ленивец",
          emoji: "🦥",
        },
        // наследует defaults.skills -> github, weather
        groupChat: {
          mentionPatterns: ["@openclaw", "openclaw"],
        },
        thinkingDefault: "high", // переопределение глубины обдумывания для агента
        reasoningDefault: "on", // видимость рассуждений для агента
        fastModeDefault: false, // быстрый режим для агента
      },
      {
        id: "quick",
        skills: [], // у этого агента нет Skills
        fastModeDefault: true, // этот агент всегда работает в быстром режиме
        thinkingDefault: "off",
      },
    ],
  },

  tools: {
    allow: ["exec", "process", "read", "write", "edit", "apply_patch"],
    deny: ["browser", "canvas"],
    exec: {
      backgroundMs: 10000,
      timeoutSec: 1800,
      cleanupMs: 1800000,
    },
    elevated: {
      enabled: true,
      allowFrom: {
        whatsapp: ["+15555550123"],
        telegram: ["123456789"],
        discord: ["123456789012345678"],
        slack: ["U123"],
        signal: ["+15555550123"],
        imessage: ["user@example.com"],
        webchat: ["session:demo"],
      },
    },
  },

  // Пользовательские поставщики моделей
  models: {
    mode: "merge",
    providers: {
      "custom-proxy": {
        baseUrl: "http://localhost:4000/v1",
        apiKey: "LITELLM_KEY",
        api: "openai-responses",
        authHeader: true,
        headers: { "X-Proxy-Region": "us-west" },
        models: [
          {
            id: "llama-3.1-8b",
            name: "Llama 3.1 8B",
            api: "openai-responses",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 128000,
            maxTokens: 32000,
          },
        ],
      },
    },
  },

  // Задания Cron
  cron: {
    enabled: true,
    store: "~/.openclaw/cron/jobs.json",
    maxConcurrentRuns: 8, // по умолчанию; диспетчеризация Cron + изолированное выполнение хода агента Cron
    sessionRetention: "24h",
  },

  // Webhook
  hooks: {
    enabled: true,
    path: "/hooks",
    token: "shared-secret",
    presets: ["gmail"],
    transformsDir: "~/.openclaw/hooks/transforms",
    mappings: [
      {
        id: "gmail-hook",
        match: { path: "gmail" },
        action: "agent",
        wakeMode: "now",
        name: "Gmail",
        sessionKey: "hook:gmail:{{messages[0].id}}",
        messageTemplate: "От: {{messages[0].from}}\nТема: {{messages[0].subject}}",
        textTemplate: "{{messages[0].snippet}}",
        deliver: true,
        channel: "last",
        to: "+15555550123",
        thinking: "low",
        timeoutSeconds: 300,
        transform: {
          module: "gmail.js",
          export: "transformGmail",
        },
      },
    ],
    gmail: {
      account: "openclaw@gmail.com",
      label: "INBOX",
      topic: "projects/<project-id>/topics/gog-gmail-watch",
      subscription: "gog-gmail-watch-push",
      pushToken: "shared-push-token",
      hookUrl: "http://127.0.0.1:18789/hooks/gmail",
      includeBody: true,
      maxBytes: 20000,
      renewEveryMinutes: 720,
      serve: { bind: "127.0.0.1", port: 8788, path: "/" },
      tailscale: { mode: "funnel", path: "/gmail-pubsub" },
    },
  },

  // Gateway + сеть
  gateway: {
    mode: "local",
    port: 18789,
    bind: "loopback",
    controlUi: { enabled: true, basePath: "/openclaw" },
    auth: {
      mode: "token",
      token: "gateway-token",
      allowTailscale: true,
    },
    tailscale: { mode: "serve", resetOnExit: false },
    remote: { url: "ws://gateway-host.ts.net:18789", token: "remote-token" },
    reload: { mode: "hybrid", debounceMs: 300 },
  },

  skills: {
    allowBundled: ["gemini", "peekaboo"],
    load: {
      extraDirs: ["~/Projects/agent-scripts/skills"],
      allowSymlinkTargets: ["~/Projects/agent-scripts/skills"],
    },
    install: {
      preferBrew: true,
      nodeManager: "npm", // npm | pnpm | yarn | bun
      allowUploadedArchives: false,
    },
    entries: {
      "image-lab": {
        enabled: true,
        apiKey: "GEMINI_KEY_HERE",
        env: { GEMINI_API_KEY: "GEMINI_KEY_HERE" },
      },
      peekaboo: { enabled: true },
    },
  },
}

Репозиторий Skills в соседнем каталоге, подключённый символической ссылкой

Используйте эту конфигурацию, если корневой каталог встроенного Skills содержит символическую ссылку на соседний репозиторий, например ~/.agents/skills/manager -> ~/Projects/manager/skills.

{
  skills: {
    load: {
      extraDirs: ["~/Projects/manager/skills"],
      allowSymlinkTargets: ["~/Projects/manager/skills"],
    },
  },
}

extraDirs сканирует соседний репозиторий как явно заданный корневой каталог Skills.
allowSymlinkTargets позволяет каталогам Skills, подключённым символическими ссылками, разрешаться в этот доверенный реальный корневой каталог, не допуская произвольного выхода через символические ссылки.
Чтобы Skill Workshop мог записывать данные через тот же доверенный целевой каталог символической ссылки, задайте skills.workshop.allowSymlinkTargetWrites: true.

Распространённые шаблоны

Общий базовый набор Skills с одним переопределением

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      skills: ["github", "weather"],
    },
    list: [
      { id: "main", default: true },
      { id: "docs", workspace: "~/.openclaw/workspace-docs", skills: ["docs-search"] },
    ],
  },
}

agents.defaults.skills — общая базовая конфигурация.
agents.list[].skills заменяет эту базовую конфигурацию для одного агента.
Используйте skills: [], если агент не должен видеть никаких навыков.

Настройка для нескольких платформ

{
  agents: { defaults: { workspace: "~/.openclaw/workspace" } },
  channels: {
    whatsapp: { allowFrom: ["+15555550123"] },
    telegram: {
      enabled: true,
      botToken: "YOUR_TOKEN",
      allowFrom: ["123456789"],
    },
    discord: {
      enabled: true,
      token: "YOUR_TOKEN",
      dm: { allowFrom: ["123456789012345678"] },
    },
  },
}

Автоматическое одобрение в доверенной сети узлов

Оставьте сопряжение устройств ручным, если не контролируете сетевой маршрут. Для выделенной лабораторной сети или подсети tailnet можно включить автоматическое одобрение первичного сопряжения устройства узла, указав точные CIDR или IP-адреса:

{
  gateway: {
    nodes: {
      pairing: {
        autoApproveCidrs: ["192.168.1.0/24", "fd00:1234:5678::/64"],
      },
    },
  },
}

Если параметр не задан, эта функция остаётся отключённой. Она применяется только к первичному сопряжению role: node без запрошенных областей доступа. Клиенты оператора и браузера, а также изменение роли, области доступа, метаданных или открытого ключа по-прежнему требуют ручного одобрения.

Безопасный режим личных сообщений (общий почтовый ящик / многопользовательские личные сообщения)

Если вашему боту могут отправлять личные сообщения несколько человек (несколько записей в allowFrom, одобрения сопряжения для нескольких человек или dmPolicy: "open"), включите безопасный режим личных сообщений, чтобы личные сообщения от разных отправителей по умолчанию не использовали общий контекст:

{
  // Безопасный режим личных сообщений (рекомендуется для многопользовательских агентов и агентов, обрабатывающих конфиденциальные личные сообщения)
  session: { dmScope: "per-channel-peer" },

  channels: {
    // Пример: многопользовательский почтовый ящик WhatsApp
    whatsapp: {
      dmPolicy: "allowlist",
      allowFrom: ["+15555550123", "+15555550124"],
    },

    // Пример: многопользовательский почтовый ящик Discord
    discord: {
      enabled: true,
      token: "YOUR_DISCORD_BOT_TOKEN",
      dm: { enabled: true, allowFrom: ["123456789012345678", "987654321098765432"] },
    },
  },
}

Для Discord/Google Chat/IRC/Mattermost/Microsoft Teams/Slack авторизация отправителя по умолчанию выполняется прежде всего по идентификатору. Включайте прямое сопоставление по изменяемому имени, адресу электронной почты или псевдониму с помощью dangerouslyAllowNameMatching: true каждого канала, только если явно принимаете этот риск.

Ключ API Anthropic и резервная модель MiniMax

{
  auth: {
    profiles: {
      "anthropic:api": {
        provider: "anthropic",
        mode: "api_key",
      },
    },
    order: {
      anthropic: ["anthropic:api"],
    },
  },
  models: {
    providers: {
      minimax: {
        baseUrl: "https://api.minimax.io/anthropic",
        api: "anthropic-messages",
        apiKey: "${MINIMAX_API_KEY}",
      },
    },
  },
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      model: {
        primary: "anthropic/claude-opus-4-6",
        fallbacks: ["minimax/MiniMax-M2.7"],
      },
    },
  },
}

Рабочий бот (ограниченный доступ)

{
  agents: {
    defaults: {
      workspace: "~/work-openclaw",
      elevatedDefault: "off",
    },
    list: [
      {
        id: "main",
        identity: {
          name: "WorkBot",
          theme: "professional assistant",
        },
      },
    ],
  },
  channels: {
    slack: {
      enabled: true,
      botToken: "xoxb-...",
      channels: {
        "#engineering": { enabled: true, requireMention: true },
        "#general": { enabled: true, requireMention: true },
      },
    },
  },
}

Только локальные модели

{
  agents: {
    defaults: {
      workspace: "~/.openclaw/workspace",
      model: { primary: "lmstudio/my-local-model" },
    },
  },
  models: {
    mode: "merge",
    providers: {
      lmstudio: {
        baseUrl: "http://127.0.0.1:1234/v1",
        apiKey: "lmstudio",
        api: "openai-responses",
        models: [
          {
            id: "my-local-model",
            name: "Local Model",
            reasoning: false,
            input: ["text"],
            cost: { input: 0, output: 0, cacheRead: 0, cacheWrite: 0 },
            contextWindow: 196608,
            maxTokens: 8192,
          },
        ],
      },
    },
  },
}

Советы

Если задан параметр dmPolicy: "open", соответствующий список allowFrom должен включать "*".
Идентификаторы провайдеров различаются (номера телефонов, идентификаторы пользователей и каналов). Сверьтесь с документацией провайдера, чтобы уточнить формат.
Необязательные разделы, которые можно добавить позже: web, browser, ui, discovery, plugins, talk, signal, imessage.
Подробные сведения о настройке см. в разделах Провайдеры и Устранение неполадок.

Gateway

Remote access

Security

Nodes and media

Web interfaces

Примеры конфигурации

Быстрый старт

Абсолютный минимум

Рекомендуемая начальная конфигурация

Расширенный пример (основные параметры)

Репозиторий Skills в соседнем каталоге, подключённый символической ссылкой

Распространённые шаблоны

Общий базовый набор Skills с одним переопределением

Настройка для нескольких платформ

Автоматическое одобрение в доверенной сети узлов

Безопасный режим личных сообщений (общий почтовый ящик / многопользовательские личные сообщения)

Ключ API Anthropic и резервная модель MiniMax

Рабочий бот (ограниченный доступ)

Только локальные модели

Советы

Связанные материалы

​Быстрый старт

​Абсолютный минимум

​Рекомендуемая начальная конфигурация

​Расширенный пример (основные параметры)

​Репозиторий Skills в соседнем каталоге, подключённый символической ссылкой

​Распространённые шаблоны

​Общий базовый набор Skills с одним переопределением

​Настройка для нескольких платформ

​Автоматическое одобрение в доверенной сети узлов

​Безопасный режим личных сообщений (общий почтовый ящик / многопользовательские личные сообщения)

​Ключ API Anthropic и резервная модель MiniMax

​Рабочий бот (ограниченный доступ)

​Только локальные модели

​Советы

​Связанные материалы

Быстрый старт

Абсолютный минимум

Рекомендуемая начальная конфигурация

Расширенный пример (основные параметры)

Репозиторий Skills в соседнем каталоге, подключённый символической ссылкой

Распространённые шаблоны

Общий базовый набор Skills с одним переопределением

Настройка для нескольких платформ

Автоматическое одобрение в доверенной сети узлов

Безопасный режим личных сообщений (общий почтовый ящик / многопользовательские личные сообщения)

Ключ API Anthropic и резервная модель MiniMax

Рабочий бот (ограниченный доступ)

Только локальные модели

Советы

Связанные материалы