Агенты: обзор

Агент в OpenClaw — это «мозг» с собственным рабочим пространством, настройками и историей. По умолчанию работает один агент, но можно запустить несколько.

Что такое агент

Каждый агент имеет:

**Рабочее пространство** — папка с файлами (AGENTS.md, SOUL.md, MEMORY.md)

**Профили авторизации** — API-ключи моделей

**Сессии** — история разговоров

**Модель** — какую ИИ-модель использует

Один агент (по умолчанию)

Если вы ничего не настраивали, работает один агент main:

Рабочее пространство: `~/.openclaw/workspace`

Сессии: `~/.openclaw/agents/main/sessions`

Модель: та, что указали при онбординге

Несколько агентов

Можно создать нескольких агентов — каждый со своей личностью, моделью и правами:

openclaw agents add рабочий
openclaw agents add личный

Каждый агент получает:

Отдельное рабочее пространство (`~/.openclaw/workspace-рабочий`)

Отдельные сессии

Отдельные профили авторизации

Привязка каналов к агентам

Через bindings можно направить сообщения из разных каналов к разным агентам. Например: Telegram-бот «Рабочий» → агент рабочий, WhatsApp → агент личный.

openclaw agents list --bindings

Контекст

Контекст — это всё, что OpenClaw отправляет модели при каждом запуске. Ограничение — окно контекста модели (лимит токенов).

Упрощённая модель:

**Системный промпт** (собирается OpenClaw): правила, инструменты, список скиллов, время/рантайм и содержимое файлов воркспейса

**История диалога**: сообщения пользователя и ответы ассистента в текущей сессии

**Вызовы инструментов + вложения**: вывод команд, чтение файлов, изображения/аудио

Контекст — это не то же самое, что «память»: память хранится на диске и может быть перезагружена; контекст — то, что внутри текущего окна модели.

Проверка контекста

`/status` — быстрый обзор «насколько заполнено окно»

`/context list` — что встроено + примерные размеры

`/context detail` — подробный разбор по файлам, инструментам, скиллам

`/compact` — сжать старую историю, освободив место

Контекстный движок

Контекстный движок (Context Engine) — компонент, который управляет сборкой контекста модели для каждого запуска. Он решает, какие сообщения включать, как сжимать старую историю и как управлять контекстом на границах субагентов.

OpenClaw поставляется со встроенным движком legacy. Плагины могут регистрировать альтернативные движки.

Настройка:

{
  agents: {
    defaults: {
      contextEngine: "legacy",  // или имя плагина
    },
  },
}

Поток сообщений

Входящее сообщение проходит несколько этапов:

Входящее сообщение
  → маршрутизация/bindings → ключ сессии
  → очередь (если запуск активен)
  → запуск агента (стриминг + инструменты)
  → исходящие ответы (ограничения канала + чанкинг)

Ключевые настройки:

`messages.*` — префиксы, очереди, поведение в группах

`messages.queue.mode` — как обрабатывать входящие во время активного запуска

Стриминг и чанкинг

В OpenClaw два отдельных слоя стриминга:

**Блочный стриминг (каналы):** отправляет завершённые блоки по мере написания. Это обычные сообщения канала (не дельты токенов).

**Превью-стриминг (Telegram/Discord/Slack):** обновляет временное превью-сообщение в процессе генерации.

Сегодня нет потокового стриминга токенов в сообщения каналов — это ограничение протоколов мессенджеров.

Настройка стриминга

{
  messages: {
    streaming: {
      enabled: true,         // включить превью-стриминг
      chunkDelayMs: 500,     // задержка между обновлениями
      minChunkChars: 100,    // минимальный размер чанка
    },
  },
}

Инструменты сессий

OpenClaw предоставляет агентам инструменты для работы между сессиями:

Инструмент	Назначение
`sessions_list`	Список сессий с фильтрами (тип, активность)
`sessions_history`	Чтение транскрипта конкретной сессии
`sessions_send`	Отправка сообщения в другую сессию
`sessions_spawn`	Запуск субагента
`subagents`	Управление субагентами (list, steer, kill)

CLI: запуск агента из командной строки

openclaw agent запускает один ход агента без входящего сообщения. Удобно для автоматизации, тестирования и скриптов.

# Простой запуск
openclaw agent --message "Какая сегодня погода?"

# Целевой агент
openclaw agent --agent ops --message "Сводка по логам"

# Доставка ответа в канал
openclaw agent --to +15555550123 --message "Отчёт готов" --deliver

# Переиспользование сессии
openclaw agent --session-id abc123 --message "Продолжи задачу"

Что дальше

**[Персонализация](/personalizaciya)** — настройка характера агента (SOUL.md)

**[Мультиагентность](/multiagentnost)** — подробное руководство по нескольким агентам

**[Конфигурация Gateway](/konfiguraciya-gateway)** — все настройки агентов