Концепции

Этот раздел объясняет термины, которые встречаются в остальной документации.

Агент

Агент — это запущенный в Docker процесс на базе OpenClaw, который отвечает на сообщения в Telegram и умеет выполнять задачи с помощью навыков.

Рабочее пространство (workspace)

Одно рабочее пространство = один агент = один Telegram-бот. Один хост может обслуживать несколько рабочих пространств одновременно — например, отдельный бот для личных задач и отдельный для рабочей команды. Первое рабочее пространство всегда называется default и не может быть удалено.

Владелец и пользователи

У каждого рабочего пространства есть owner — единственный пользователь, который может отдавать боту команды, и необязательный список users — дополнительные участники, которым бот отвечает в личных сообщениях.

Постоянное хранилище (durable data)

История переписки, файлы рабочего пространства и системные настройки сохраняются в отдельном каталоге на диске и переживают перезапуск и обновление образа агента.

Начальная настройка (bootstrap)

При первом запуске и при каждом обновлении образа агент донастраивает окружение: устанавливает системные документы, наполняет рабочее пространство и, если нужно, голосовые модели. Процесс идемпотентен — повторный запуск трогает только то, что изменилось.

config.yaml

Единый файл, описывающий агента: адрес и ключ AI-шлюза, список пользователей и рабочих пространств, токены Telegram-ботов. Любое значение можно переопределить переменной окружения — подробнее в Утилите nb и Установке на свой компьютер.