Агенти — це ізольовані AI-помічники, які аналізують проблеми, виконують завдання та спілкуються через різні платформи. Кожен агент має власний простір роботи, історію сесій, конфігурацію моделі та прив'язки каналів.
На відміну від простих чат-ботів, агенти мають повні інструменти: вони можуть виконувати код, читати та записувати файли, керувати браузером, надсилати повідомлення в канали та використовувати зовнішні сервіси через плагіни та навички.
Кожен агент отримує власний ізольований простір роботи — директорію на хості Gateway, де можна безпечно зберігати файли, скрипти та тимчасові дані. Інструменти файлових операцій агента читають та записують до цієї директорії за замовчуванням.
Системний запит визначає особистість, роль, можливості та обмеження агента. Він встановлює загальний контекст для кожної розмови і може посилатися на файли, навички та поточний стан оточення.
Кожен агент налаштований на використання конкретної AI-моделі (наприклад, Claude Sonnet 4, GPT-4o, Gemini 2 Flash). Ви можете змінити модель агента в будь-який час — це впливає лише на нові повідомлення; попередні відповіді зберігаються незмінними.
Агенти прив'язуються до каналів — Telegram-бот, Discord-сервер, Slack-простір, WhatsApp-акаунт і т.д. Повідомлення, отримані будь-яким прив'язаним каналом, потрапляють до агента. Агент може також надсилати повідомлення до прив'язаних каналів.
Агенти можуть виконувати дії в кількох категоріях:
| Категорія | Приклади | |---|---| | Файли | Читання, запис, редагування файлів у просторі роботи | | Код | Виконання команд оболонки, скриптів, тестів | | Браузер | Навігація, взаємодія, зняття скріншотів веб-сторінок | | Повідомлення | Надсилання та редагування в підключених каналах | | Пам'ять | Зберігання та пошук у векторній базі знань | | Пристрої | Камера, екран, розташування через додатки-компаньйони | | Плагіни | Голосові дзвінки, SIP-телефонія та інші розширення | | Навички | Google, Notion, Slack, 1Password та інші інтеграції |
Сесія — це одна безперервна розмова між користувачем і агентом. Кожна сесія:
Агенти можуть також відкривати суб-сесії — запускати ізольований цикл агента для підзавдань, а потім повертати результати.
Агентів визначено в openclaw.json у розділі agents. Приклад мінімальної конфігурації:
{
"agents": [
{
"id": "assistant",
"name": "Assistant",
"model": "claude-sonnet-4-5",
"systemPrompt": "You are a helpful assistant.",
"channels": ["telegram-main"]
}
]
}
| Поле | Опис |
|---|---|
| id | Унікальний ідентифікатор агента |
| name | Відображуване ім'я |
| model | ID AI-моделі для використання |
| systemPrompt | Особистість та інструкції агента |
| channels | Список прив'язаних каналів |
| tools | Дозволені групи інструментів (або all) |
| memory | Конфігурація пам'яті |
| sandbox | Параметри ізоляції виконання |
Ви контролюєте, які інструменти може використовувати кожен агент через поле tools:
{
"tools": ["fs", "web", "messaging"]
}
Доступні групи: runtime, fs, sessions, memory, web, ui, automation, messaging, nodes.
Встановіть "tools": "all" щоб дозволити доступ до всіх інструментів (лише для довірених агентів).
Для агентів, яким потрібно виконувати ненадійний код, увімкніть режим sandbox:
{
"sandbox": {
"enabled": true,
"image": "openclaw-sandbox:latest"
}
}
У режимі sandbox команди оболонки виконуються в ізольованому Docker-контейнері з обмеженнями ресурсів і без доступу до мережі хосту.
Агенти можуть зберігати та отримувати інформацію між сесіями через векторну пам'ять:
{
"memory": {
"enabled": true,
"topK": 10
}
}
Докладніше про пам'ять — у розділі Сесії та пам'ять.