«`markdown
# Оркестрация рабочих процессов OpenClaw + n8n

Позволять AI-агенту напрямую управлять API-ключами и вызывать внешние сервисы — рецепт инцидентов безопасности. Каждая новая интеграция означает ещё один ключ в `.env.local`, ещё одну поверхность для случайной утечки или неправильного использования.

Этот кейс описывает паттерн, в котором OpenClaw делегирует все взаимодействия с внешними API n8n workflow через вебхуки — агент никогда не касается ключей, и каждая интеграция визуально инспектируема и блокируема.

## Проблема

Когда OpenClaw обрабатывает всё напрямую, возникают три нарастающих проблемы:

— **Нет видимости**: сложно проверить, что агент реально собрал, когда логика зарыта в JavaScript-файлах скиллов или shell-скриптах
— **Разрастание секретов**: каждый API-ключ живёт в окружении агента — один неосторожный коммит до утечки
— **Транжирство токенов**: детерминированные подзадачи (отправить письмо, обновить таблицу) сжигают LLM-токены, хотя могли бы выполняться как простые workflow

## Что он делает

— **Прокси-паттерн**: OpenClaw создаёт n8n workflow с входящими вебхуками, затем вызывает эти вебхуки для всех будущих взаимодействий с API
— **Изоляция ключей**: API-ключи живут в хранилище учётных данных n8n — агент знает только URL вебхука
— **Визуальная отладка**: каждый workflow инспектируется в drag-and-drop интерфейсе n8n
— **Блокировка workflow**: после сборки и тестирования вы блокируете workflow, чтобы агент не мог изменить логику взаимодействия с API
— **Шаги защиты**: можно добавить валидацию, rate limiting и одобрения в n8n перед любым внешним вызовом

## Как это работает

1. **Агент проектирует workflow**: скажите OpenClaw, что нужно (например, «создай workflow, который отправляет сообщение в Slack, когда новый GitHub issue помечен `urgent`»)
2. **Агент собирает его в n8n**: OpenClaw создаёт workflow через n8n API, включая входящий вебхук-триггер
3. **Вы добавляете ключи**: откройте интерфейс n8n, добавьте Slack-токен / GitHub-токен вручную
4. **Вы блокируете workflow**: предотвращаете дальнейшие изменения со стороны агента
5. **Агент вызывает вебхук**: отныне OpenClaw вызывает `http://n8n:5678/webhook/my-workflow` с JSON-полезной нагрузкой — он никогда не видит API-ключ

«`text
┌──────────────┐ webhook call ┌─────────────────┐ API call ┌──────────────┐
│ OpenClaw │ ───────────────────→ │ n8n Workflow │ ─────────────→ │ External │
│ (agent) │ (no credentials) │ (locked, with │ (credentials │ Service │
│ │ │ API keys) │ stay here) │ (Slack, etc)│
└──────────────┘ └─────────────────┘ └──────────────┘
«`

## Необходимые скиллы

— Доступ к `n8n` API (для создания/запуска workflow)
— `fetch` или `curl` для вызовов вебхуков
— Docker (при использовании предварительно настроенного стека)
— Управление учётными данными n8n (ручная одноразовая настройка для каждой интеграции)

## Как настроить

### Вариант 1: Предварительно настроенный Docker Stack

Готовый Docker Compose стек от сообщества ([openclaw-n8n-stack](https://github.com/caprihan/openclaw-n8n-stack)) соединяет всё на общей Docker-сети:

«`bash
git clone https://github.com/caprihan/openclaw-n8n-stack.git
cd openclaw-n8n-stack
cp .env.template .env
# Добавьте ваш Anthropic API key в .env
docker-compose up -d
«`

Это даёт:
— OpenClaw на порту 3456
— n8n на порту 5678
— Общую Docker-сеть, чтобы OpenClaw мог вызывать `http://n8n:5678/webhook/…` напрямую
— Готовые шаблоны workflow (проверка фактов через несколько LLM, рассылка почты, мониторинг соцсетей)

### Вариант 2: Ручная настройка

1. Установите n8n (`npm install n8n -g` или запустите через Docker)
2. Настройте OpenClaw — укажите базовый URL n8n
3. Добавьте это в ваш AGENTS.md:

«`text
## n8n Integration Pattern

Когда мне нужно работать с внешними API:

1. НИКОГДА не хранить API-ключи в окружении или файлах скиллов
2. Проверить, существует ли уже n8n workflow для этой интеграции
3. Если нет — создать через n8n API с вебхук-триггером
4. Уведомить пользователя: добавить ключи и заблокировать workflow
5. Все последующие вызовы — через webhook URL с JSON-полезной нагрузкой

Именование workflow: openclaw-{сервис}-{действие}
Пример: openclaw-slack-send-message

Формат вызова вебхука:
curl -X POST http://n8n:5678/webhook/{workflow-name} \
-H «Content-Type: application/json» \
-d ‘{«channel»: «#general», «message»: «Hello from OpenClaw»}’
«`

## Ключевые инсайты

— **Три победы в одном**: наблюдаемость (визуальный UI), безопасность (изоляция ключей) и производительность (детерминированные workflow не сжигают токены)
— **Блокировка после тестирования**: цикл «собрать → протестировать → заблокировать» критичен — без блокировки агент может тихо модифицировать workflow
— **У n8n 400+ интеграций**: большинство внешних сервисов, которые вы хотите подключить, уже имеют ноды в n8n, избавляя агента от написания собственных API-вызовов
— **Аудит-трейл бесплатно**: n8n логирует каждый запуск workflow с входными и выходными данными

## Вдохновлено

Этот паттерн описал [Simon Høiberg](https://x.com/SimonHoiberg/status/2020843874382487959), который выделил три причины, почему этот подход лучше прямых API-вызовов OpenClaw: наблюдаемость через визуальный UI n8n, безопасность через изоляцию ключей и производительность за счёт выполнения детерминированных подзадач как workflow вместо LLM-вызовов. Репозиторий [openclaw-n8n-stack](https://github.com/caprihan/openclaw-n8n-stack) предоставляет готовый Docker Compose стек, реализующий этот паттерн.

## Ссылки

— [Документация n8n](https://docs.n8n.io/)
— [openclaw-n8n-stack (Docker setup)](https://github.com/caprihan/openclaw-n8n-stack)
— [Документация n8n Webhook Trigger](https://docs.n8n.io/integrations/builtin/core-nodes/n8n-nodes-base.webhook/)
«`