OpenClaw: руководство по автономному агенту, Docker и ценам

### Краткий ответ: Что такое OpenClaw и чем он отличается?

OpenClaw — это персональный автономный AI-ассистент с открытым исходным кодом, архитектурой Gateway, поддержкой 20+ мессенджеров и изолированной мультиагентной средой. В отличие от проприетарных SaaS-агентов за $20–$50 в месяц, self-hosted OpenClaw не требует подписки ($0), а стоимость задачи составляет $0.003–$0.042 при прямом подключении API моделей.

1. Обзор: Что представляет собой OpenClaw в 2026 году?

Экосистема AI-агентов в 2026 году преодолела фундаментальный рубеж: переход от изолированных диалоговых окон к непрерывным, управляемым событиями автономным циклам выполнения. В то время как Claude Code и OpenAI Codex ориентированы преимущественно на локальные терминалы разработчиков, OpenClaw (ранее openclaw.ai) зарекомендовал себя как ведущий open-source фреймворк для персонального AI-ассистента, функционирующего в круглосуточном режиме (24/7) через десятки каналов связи, cron-расписания и изолированные задачи.

В отличие от тяжеловесных десктопных надстроек, OpenClaw базируется на трех архитектурных компонентах:

1. Декуплированный шлюз (Gateway Protocol): Центральный демон на порту 18789, обеспечивающий маршрутизацию каналов, персистентность сессий, cron-планировщик и обработку вебхуков.
2. Мультиканальная маршрутизация: Нативная поддержка 20+ платформ, включая Telegram, WhatsApp (Baileys), Discord (Bot API + Gateway), Slack (Bolt SDK), Signal (signal-cli), iMessage, Matrix и WebChat.
3. Модульные навыки и изолированные агенты: Стандарт навыков в формате Markdown (SKILL.md) из реестра ClawHub в сочетании с контейнерной изоляцией Docker и ограничением POSIX-привилегий.

В условиях роста цен на корпоративные SaaS-подписки и ужесточения требований к хранению данных, self-hosted развертывание OpenClaw на собственных Linux-серверах стало индустриальным стандартом.

2. Архитектура OpenClaw: Gateway, каналы и рабочая область

Основа OpenClaw — разделенная клиент-серверная архитектура. Центральным звеном выступает фоновый сервис (OpenClaw Gateway), взаимодействующий по WebSockets и сокетам Unix с клиентскими интерфейсами и внешними API.

+-----------------------------------------------------------------------------------+
|                            Внешние каналы сообщений                               |
|   Telegram  |  WhatsApp  |  Discord  |  Slack  |  Signal  |  iMessage  |  Matrix  |
+-----------------------------------------------------------------------------------+
                                          | (Webhook / WebSocket / Bot API)
                                          v
+-----------------------------------------------------------------------------------+
|                            OpenClaw Gateway (Порт 18789)                          |
|  - DM Pairing и механизм Allowlist        - Хранилище контекста и сессий          |
|  - Планировщик задач (CronTab Engine)     - Маршрутизатор входящих Webhook        |
|  - Hot-Reload конфигурации (Hybrid Watch) - Отказоустойчивость и переключение LLM |
+-----------------------------------------------------------------------------------+
       |                                      |                              |
       v                                      v                              v
+------------------+                  +------------------+         +-------------------+
|  Агент: Home     |                  |  Агент: Work     |         |  Агент: DevOps    |
|  - Workspace-Home|                  |  - Workspace-Work|         |  - Workspace-Ops  |
|  - SOUL.md       |                  |  - SOUL.md       |         |  - SOUL.md        |
|  - Личный CRM    |                  |  - Jira / Linear |         |  - Kubernetes/SSH |
+------------------+                  +------------------+         +-------------------+
       |                                      |                              |
       +--------------------------------------+------------------------------+
                                          |
                                          v
+-----------------------------------------------------------------------------------+
|                      Слой изолированного исполнения (Sandbox)                     |
|  - Изоляция в Docker-контейнерах (`mode: non-main` / `mode: all`)                 |
|  - Сброс POSIX-привилегий (`cap_drop: ALL`, непривилегированный UID 10001)        |
|  - Read-Only монтирование томов (`:ro`) и Tmpfs (`/tmp:noexec`)                   |
|  - Рантайм навыков ClawHub (`SKILL.md`, динамическая проверка бинарников)         |
+-----------------------------------------------------------------------------------+

Структура каталогов рабочей области (Workspace)

Каждый агент OpenClaw размещается в файловой иерархии ~/.openclaw/:

~/.openclaw/
├── openclaw.json          # Главная декларативная конфигурация (JSON5)
├── cron.json              # Задачи cron и расписания фонового запуска
├── state/                 # Сессии SQLite, кэш key-value, токены доступа
├── skills/                # Глобально управляемые разделяемые навыки
└── workspace/             # Основной рабочий каталог агента
    ├── AGENTS.md          # Системные правила и инструкции поведения
    ├── SOUL.md            # Характер, тон, стиль общения и ограничения
    ├── TOOLS.md           # Инструкции к локальным утилитам и окружению
    └── skills/            # Навыки уровня воркспейса
        └── repo-analyzer/
            └── SKILL.md   # Декларация исполняемого навыка

Базовые команды управления Gateway

Управление службой OpenClaw Gateway выполняется через встроенный CLI:

# Проверить статус Gateway, привязку портов и потребление RAM
openclaw gateway status

# Запустить Gateway в фоновом режиме демона
openclaw gateway start

# Запустить Gateway в foreground с подробными логами отладки
openclaw gateway --port 18789 --verbose

# Запустить системную диагностику и аудит окружения
openclaw doctor

# Автоматически исправить права доступа и отсутствующие каталоги
openclaw doctor --fix

3. Развертывание в Docker: Инструкция для продакшена

Для надежной изоляции запуск AI-агентов с доступом к командной строке на хостовой системе недопустим из-за риска эскалации привилегий. Стандартом является развертывание через Docker Compose с разделением сетевых контуров и минимальными правами доступа.

Рабочий docker-compose.yml

version: "3.9"

services:
  openclaw-gateway:
    image: ghcr.io/openclaw/openclaw:latest
    container_name: openclaw-gateway
    restart: unless-stopped
    user: "10001:10001"
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    cap_add:
      - CHOWN
      - SETUID
      - SETGID
    environment:
      - NODE_ENV=production
      - OPENCLAW_HOME=/home/openclaw/.openclaw
      - OPENCLAW_STATE_DIR=/home/openclaw/.openclaw/state
      - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_GATEWAY_TOKEN}
      - OPENCLAW_GATEWAY_PASSWORD=${OPENCLAW_GATEWAY_PASSWORD}
      - ANTHROPIC_API_KEY=${ANTHROPIC_API_KEY}
      - OPENAI_API_KEY=${OPENAI_API_KEY}
      - DEEPSEEK_API_KEY=${DEEPSEEK_API_KEY}
    volumes:
      - openclaw-config:/home/openclaw/.openclaw
      - openclaw-workspace:/home/openclaw/.openclaw/workspace
      - /var/run/docker.sock:/var/run/docker.sock:ro
    ports:
      - "127.0.0.1:18789:18789"
    networks:
      - openclaw-net
    healthcheck:
      test: ["CMD", "openclaw", "health"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 20s

  openclaw-sandbox:
    image: ghcr.io/openclaw/sandbox-runner:latest
    container_name: openclaw-sandbox
    restart: always
    network_mode: none
    read_only: true
    tmpfs:
      - /tmp:rw,noexec,nosuid,size=256m
    security_opt:
      - no-new-privileges:true
    cap_drop:
      - ALL
    volumes:
      - openclaw-workspace:/workspace:rw
    environment:
      - RUNNER_UID=10001
      - RUNNER_GID=10001

volumes:
  openclaw-config:
    driver: local
  openclaw-workspace:
    driver: local

networks:
  openclaw-net:
    driver: bridge

Конфигурация openclaw.json для продакшена

Файл настроек OpenClaw оформляется в синтаксисе JSON5, поддерживающем комментарии:

{
  agents: {
    defaults: {
      workspace: "/home/openclaw/.openclaw/workspace",
      model: {
        primary: "anthropic/claude-sonnet-4-6",
        fallbacks: ["deepseek/deepseek-chat", "openai/gpt-5.4"],
      },
      thinking: "high",
      sandbox: {
        mode: "non-main", // off | non-main | all
        scope: "agent",   // session | agent | shared
        dockerImage: "ghcr.io/openclaw/sandbox-runner:latest",
        timeoutSeconds: 300,
        memoryLimitMb: 1024,
      },
    },
    list: [
      {
        id: "main",
        default: true,
        workspace: "/home/openclaw/.openclaw/workspace",
      },
      {
        id: "devops",
        workspace: "/home/openclaw/.openclaw/workspace-devops",
        sandbox: { mode: "all" },
      },
    ],
  },
  channels: {
    telegram: {
      enabled: true,
      botToken: "7123456789:AAFq_example_token_secret",
      dmPolicy: "pairing", // pairing | allowlist | open | disabled
      allowFrom: ["tg:987654321"],
    },
    discord: {
      enabled: true,
      botToken: "MTI4OTexampleDiscordBotToken",
      dmPolicy: "allowlist",
      allowFrom: ["dc:382910394857291029"],
    },
  },
  cron: {
    enabled: true,
    maxConcurrentRuns: 4,
  },
  hotReload: "hybrid", // hybrid | hot | restart | off
}

4. Мультиагентность и безопасность песочниц

Критический недостаток ранних фреймворков — бесконтрольное выполнение команд (eval, exec) в одном окружении с секретами API и базами данных. В OpenClaw реализована двухуровневая система защиты:

Политики доступа (DM Policy) и изоляция контейнеров

1. Контроль входящих сообщений (DM Policy):

• pairing (по умолчанию): Неизвестные пользователи получают код сопряжения. Администратор должен явно одобрить подключение командой openclaw pairing approve .
• allowlist: Только аккаунты из списка allowFrom могут отдавать команды ассистенту.
• open: Доступ открыт всем отправителям (рекомендуется исключительно для публичных ботов с режимом песочницы all).
• disabled: Отключение обработки входящих личных сообщений (только исходящие уведомления cron).

{
  bindings: [
    {
      agentId: "main",
      match: { channel: "telegram", accountId: "personal" }
    },
    {
      agentId: "devops",
      match: { channel: "discord", accountId: "engineering-guild" }
    }
  ]
}

---
name: github-pr-analyzer
description: Анализирует пулл-реквесты на GitHub, запускает тесты и формирует ревью.
metadata: {
  "openclaw": {
    "requires": {
      "bins": ["gh", "jq", "git"],
      "env": ["GITHUB_TOKEN"],
      "config": ["sandbox.enabled"]
    },
    "os": ["linux", "darwin"],
    "always": false,
    "primaryEnv": "GITHUB_TOKEN"
  }
}
---

# GitHub Pull Request Analyzer Skill

При вызове пользователем или триггере вебхука:
1. Получи diff целевого PR через `gh pr diff <pr_number>`.
2. Определи измененные файлы с помощью `git diff --name-only origin/main...HEAD`.
3. Проанализируй покрытие тестами.
4. Сформируй структурированный отчет в Markdown с указанием строк кода.

# Просмотреть доступные навыки
openclaw skills list

# Установить навык из официального каталога ClawHub
openclaw skills install web-researcher

# Установить навык напрямую из репозитория GitHub
openclaw skills install git:github.com/openclaw-community/postgres-inspector@v1.4.0

# Установить локальный навык глобально для всех профилей
openclaw skills install ./custom-skills/security-auditor --global

# Проверить цифровую подпись и права установленного навыка
openclaw skills verify web-researcher

# Обновить все установленные навыки
openclaw skills update --all

# Проверить статус Gateway и активных подключений
openclaw gateway status

# Просмотр логов в реальном времени с фильтрацией
openclaw logs --follow --lines 50

# Валидация файлов конфигурации
openclaw config validate

# Отправить запрос агенту с углубленным анализом (thinking)
openclaw agent --message "Проведи аудит безопасности репозитория" --thinking high

# Отправить уведомление в Telegram
openclaw message send --target "tg:987654321" --message "Деплой успешно завершен."