OpenClaw — не только чат-бот. С профилем coding агент получает доступ к файловой системе, терминалу, браузеру и может выполнять задачи разработчика: писать код, запускать команды, работать с Git, тестировать и деплоить.
В этой статье — какие инструменты доступны, как их настроить и какие задачи агент может решать.
Профиль coding
OpenClaw использует профили для управления тем, какие инструменты доступны агенту. Профиль coding включает всё необходимое для разработки.
Источник: профили инструментов описаны в документации Tools.
| Профиль | Что включает |
|---|---|
minimal | Только session_status — для read-only сценариев |
coding | group:fs, group:runtime, group:sessions, group:memory, image |
messaging | group:messaging, сессии — для мессенджеров |
full | Всё без ограничений |
Как включить
// ~/.openclaw/openclaw.json
{
tools: {
profile: "coding",
},
}
Профиль можно задать для конкретного агента:
{
agents: {
list: [
{
id: "developer",
tools: {
profile: "coding",
},
},
{
id: "support",
tools: {
profile: "messaging",
},
},
],
},
}
Что входит в группы
| Группа | Инструменты | Назначение |
|---|---|---|
group:fs | read, write, edit, apply_patch | Работа с файлами |
group:runtime | exec, process | Выполнение команд |
group:sessions | sessions_spawn и другие | Субагенты |
group:memory | search, get | Поиск по памяти агента |
Дополнительно в профиль coding входит инструмент image — анализ изображений (скриншоты, схемы).
Выполнение команд: exec
Основной инструмент для запуска shell-команд в рабочей директории.
Источник: параметры
execописаны в документации Tools.
Ключевые параметры:
| Параметр | Тип | По умолчанию | Описание |
|---|---|---|---|
command | string | — | Команда (обязательный) |
timeout | секунды | 1800 | Максимальное время выполнения |
yieldMs | мс | 10000 | Автоматический перевод в фон |
background | boolean | false | Немедленный запуск в фоне |
elevated | boolean | false | Запуск на хосте (вне песочницы) |
Если команда выполняется дольше yieldMs (по умолчанию 10 секунд), она автоматически уходит в фон и возвращает sessionId для дальнейшего мониторинга через process.
Что агент может запускать
Агент с профилем coding может выполнять любые команды в терминале:
npm install,pip install,cargo build— установка зависимостейnpm test,pytest,go test— запуск тестовgit status,git commit,git push— работа с Gitdocker build,docker-compose up— контейнерыcurl,wget— HTTP-запросы- Любые другие CLI-утилиты
Управление фоновыми процессами: process
Инструмент process позволяет работать с длительными задачами:
| Действие | Что делает |
|---|---|
list | Список активных фоновых процессов |
poll | Проверка статуса и новый вывод |
log | Просмотр логов (с offset/limit) |
write | Отправка ввода в процесс |
kill | Остановка процесса |
clear | Очистка завершённых процессов |
Это полезно для задач вроде npm run dev (dev-сервер) или docker-compose up — агент запускает их в фоне и продолжает работу.
Работа с файлами
Группа group:fs даёт агенту полный доступ к файловой системе рабочей директории.
| Инструмент | Что делает |
|---|---|
read | Чтение содержимого файла |
write | Создание или перезапись файла |
edit | Редактирование существующего файла |
apply_patch | Применение патча к нескольким файлам (экспериментальный) |
Агент может читать код, вносить изменения, создавать новые файлы — всё что нужно для рефакторинга, написания кода и исправления багов.
apply_patch
Экспериментальный инструмент для применения structured patches к нескольким файлам одновременно (multi-hunk edits). Требует включения:
{
tools: {
exec: {
applyPatch: {
enabled: true,
workspaceOnly: true, // только в рабочей директории
},
},
},
}
Источник:
apply_patchописан в документации Tools как экспериментальная функция.
Браузер
Инструмент browser позволяет агенту управлять браузером — открывать страницы, делать скриншоты, взаимодействовать с UI.
Источник: действия
browserописаны в документации Tools.
Основные действия:
| Действие | Описание |
|---|---|
open | Открыть URL |
navigate | Перейти по ссылке |
snapshot | Получить структуру страницы (режимы aria или ai) |
screenshot | Сделать скриншот |
act | Кликнуть, ввести текст, нажать клавишу |
console | Прочитать консоль браузера |
pdf | Сохранить страницу в PDF |
Где это полезно для разработчика:
- Тестирование UI после изменений
- Скриншоты для документации
- Проверка responsive-дизайна
- Автоматизация действий на веб-страницах
Для работы браузера нужно расширение Browser Relay.
Субагенты: sessions_spawn
Агент может запускать субагентов для параллельного выполнения задач.
Источник: параметры
sessions_spawnописаны в документации Tools.
Ключевые параметры:
| Параметр | Описание |
|---|---|
task | Описание задачи (обязательный) |
label | Метка для идентификации |
runtime | subagent (по умолчанию) или acp |
model | Модель для субагента (можно отличную от основной) |
sandbox | Запуск в песочнице |
thread | Thread-bound режим |
Вызов неблокирующий — возвращает status: 'accepted' немедленно.
Примеры использования:
- Параллельный запуск тестов для разных модулей
- Один субагент пишет код, другой пишет тесты
- Ревью нескольких PR одновременно
- Поиск по документации во время написания кода
Песочница (Sandbox)
Для безопасного выполнения кода OpenClaw поддерживает Docker-песочницу.
Источник: конфигурация песочницы описана в документации Sandbox.
Режимы
| Режим | Поведение |
|---|---|
off | Без песочницы — команды выполняются напрямую |
non-main | Только субагенты в песочнице |
all | Все агенты в песочнице |
Конфигурация
// ~/.openclaw/openclaw.json
{
agents: {
defaults: {
sandbox: {
mode: "non-main",
scope: "agent", // контейнер на агента
docker: {
image: "openclaw-sandbox:bookworm-slim",
containerPrefix: "openclaw-sbx-",
},
pruning: {
idleHours: 24, // удалять неактивные через 24ч
maxAgeDays: 7, // максимальный возраст 7 дней
},
},
},
},
}
Область видимости контейнера (scope)
| Значение | Поведение |
|---|---|
session | Контейнер привязан к сессии |
agent | Контейнер привязан к агенту |
shared | Общий контейнер для нескольких агентов |
После изменения конфигурации пересоздайте контейнеры:
openclaw sandbox recreate
Веб-инструменты
Профиль coding не включает веб-инструменты по умолчанию, но их можно добавить через tools.allow.
Источник:
web_searchиweb_fetchописаны в документации Tools.
web_search
Поиск в интернете через Perplexity, Brave, Gemini, Grok или Kimi.
{
tools: {
profile: "coding",
allow: ["web_search", "web_fetch"],
web: {
search: {
enabled: true,
maxResults: 5,
},
fetch: {
enabled: true,
maxCharsCap: 50000,
},
},
},
}
web_fetch
Получение содержимого веб-страниц (HTML → markdown/text). Параметры:
url— адрес страницыextractMode—markdownилиtextmaxChars— ограничение длины (по умолчанию до 50000)
Результаты кешируются на 15 минут.
Где полезно: чтение документации, проверка API, поиск решений на Stack Overflow.
Скиллы для разработки
Скиллы (skills) — готовые наборы инструкций, которые учат агента выполнять конкретные задачи. Для разработки доступны тысячи скиллов в реестре ClawHub.
Источник: установка скиллов описана в документации Skills. Реестр скиллов — clawhub.ai.
Установка скилла:
clawhub install <skill-slug>
Категории скиллов для разработки:
| Категория | Количество скиллов | Примеры задач |
|---|---|---|
| Git и GitHub | 170+ | PR, code review, автоматизация workflow |
| Coding Agents | 1200+ | Написание кода, рефакторинг, отладка |
| Web и Frontend | 930+ | Автоматизация браузера, скриншоты, скрапинг |
| DevOps и Cloud | 400+ | Docker, деплой, мониторинг |
Пример: агент-разработчик
Собираем конфигурацию для агента, заточенного под разработку:
// ~/.openclaw/openclaw.json
{
agent: {
model: "anthropic/claude-sonnet-4",
},
tools: {
profile: "coding",
allow: ["web_search", "web_fetch"],
web: {
search: { enabled: true },
fetch: { enabled: true },
},
},
agents: {
defaults: {
sandbox: {
mode: "non-main",
},
},
},
}
С этой конфигурацией агент может:
- Читать и редактировать файлы проекта
- Запускать команды в терминале (тесты, сборка, линтеры)
- Работать с Git (коммиты, ветки, диффы)
- Искать информацию в интернете
- Запускать субагентов для параллельных задач
- Делать скриншоты через браузер (если установлен Browser Relay)
Типичные сценарии
Исправление бага
- Вы описываете баг в Telegram
- Агент читает код, находит проблему
- Вносит исправление через
edit - Запускает тесты через
exec - Если тесты прошли — делает коммит
Код-ревью
- Агент получает номер PR
- Через
execвыполняетgit diff - Анализирует изменения
- Пишет развёрнутый отзыв с замечаниями
Рефакторинг
- Вы описываете, что нужно переделать
- Агент читает затронутые файлы
- Вносит изменения через
edit - Запускает тесты для проверки
Создание проекта с нуля
- Вы описываете проект
- Агент создаёт структуру через
write - Устанавливает зависимости через
exec - Пишет код, запускает и тестирует
Ограничения
- Рабочая директория — агент работает в пределах одной директории (workspace). Доступ за её пределы возможен только с
elevated: true - Таймаут — команды по умолчанию ограничены 1800 секундами (30 минут)
- Модель — качество кода зависит от выбранной модели. Для серьёзной разработки рекомендуется Claude Sonnet 4 или выше
- apply_patch — экспериментальный, работает не со всеми моделями
Что дальше
- Все инструменты OpenClaw — полный справочник CLI-команд
- Скиллы OpenClaw — как устанавливать и создавать скиллы
- Браузер — настройка Browser Relay
- Кейсы использования — другие сценарии
- Безопасность — настройка безопасности агента