← Университет

OpenClaw: Полная документация и конспект

Дата исследования: 12 июля 2026
Источник: docs.openclaw.ai и официальная документация

1. Обзор и основные концепции

Что такое OpenClaw?

OpenClaw — это самостоятельно размещаемый (self-hosted) шлюз, который соединяет приложения для обмена сообщениями (Discord, Telegram, WhatsApp, Signal и другие) с агентами ИИ. Проект имеет слоган "Your own personal AI assistant. Any OS. Any Platform. The lobster way. 🦞" и представляет собой открытый исходный код (open-source) агентского фреймворка, разработанный на основе философии персональных ассистентов, работающих локально.

Ключевая архитектура основана на трёх принципах:

  1. Самостоятельное размещение (Self-hosting) — система работает на вашем оборудовании, полностью под вашим контролем
  2. Мультиканальность (Multi-channel) — один Gateway обслуживает несколько каналов обмена сообщениями одновременно
  3. Ориентация на агентов (Agent-centric) — встроенная поддержка использования инструментов (tools), сессий (sessions) и маршрутизации (routing)

Главные характеристики


2. Установка и начало работы

Системные требования

Минимальные требования для запуска OpenClaw: - Node.js версия 22.19+, 23.11+ или 24+ (версия 24 рекомендуется) - API-ключ от провайдера ИИ (Anthropic Claude, OpenAI GPT, Google Gemini или других) - Операционная система: macOS, Linux, Windows (включая WSL2)

Процесс установки

Официальная документация утверждает: "Install OpenClaw, run onboarding, and chat with your AI assistant in about 5 minutes."

Установка для macOS/Linux:

curl -fsSL https://openclaw.ai/install.sh | bash

Установка для Windows (PowerShell):

iwr -useb https://openclaw.ai/install.ps1 | iex

Четыре основных этапа установки:

  1. Установка OpenClaw — автоматический скрипт обнаруживает ОС и обрабатывает Node.js автоматически
  2. Запуск onboardingopenclaw onboard --install-daemon для конфигурации провайдера моделей и API-ключей
  3. Верификация Gateway — команда openclaw gateway status проверяет статус операции
  4. Доступ к интерфейсуopenclaw dashboard запускает веб-интерфейс для тестирования первого сообщения

Альтернативные методы установки

Для опытных пользователей доступны: - Установка через npm: npm install -g openclaw - Установка через package managers: pnpm или bun - Установка из исходного кода: с GitHub используя git и pnpm - Локальная префиксная установка: install-cli.sh сохраняет всё в ~/.openclaw без системных прав

Проверка после установки

После успешной установки выполните:

openclaw --version      # Проверка версии
openclaw doctor         # Диагностика окружения
openclaw gateway status # Статус Gateway

3. Провайдеры моделей (Model Providers)

Поддерживаемые провайдеры

OpenClaw поддерживает множество провайдеров LLM (Large Language Model). Модели указываются в формате provider/model (пример: openai/gpt-5.5 или anthropic/claude-opus-4).

Официальные провайдеры: - Anthropic — Claude модели (Opus, Sonnet, Haiku) с поддержкой CLI-бэкенда - OpenAI — GPT-4, GPT-4o через API ключ или ChatGPT OAuth - Google — Gemini API, Vertex AI, локальный CLI режим - Специализированные: MiniMax, Qwen (Alibaba), Z.AI, Volcano Engine, BytePlus, DeepSeek

Локальные и самохостируемые: - Ollama — локальный сервер моделей с OpenAI-совместимым API - vLLM — самохостируемый OpenAI-совместимый inference сервер - LM Studio — десктопное приложение для запуска локальных моделей

Управление ключами API

Система поддерживает ротацию ключей при ответах 429 (rate limit exceeded) или превышении квоты. Приоритет установки ключей: 1. OPENCLAW_LIVE_<PROVIDER>_KEY (переменная окружения) 2. <PROVIDER>_API_KEYS (массив ключей) 3. <PROVIDER>_API_KEY (единственный ключ)

Команды управления:

openclaw onboard                    # Интерактивная конфигурация
openclaw models list                # Список доступных моделей
openclaw models set anthropic/claude-opus-4  # Установить модель по умолчанию

4. Каналы интеграции (Chat Channels)

Архитектура каналов

Один Gateway процесс может обслуживать несколько каналов одновременно. OpenClaw реализует принцип: "OpenClaw can talk to you on any chat app you already use." Текст поддерживается везде, а медиа (изображения, видео, реакции) варьируются в зависимости от платформы.

Поддерживаемые платформы

Мейнстрим-мессенджеры: - Telegram, Discord, WhatsApp, Signal, Slack, Microsoft Teams, Google Chat, iMessage, Matrix

Разработчицкие и самохостируемые: - IRC, Mattermost, Nextcloud Talk, Nostr, Raft (децентрализованная платформа), Tlon, Synology Chat, Twitch

Региональные платформы: - LINE, WeChat, QQ Bot, Feishu (Bytedance), Yuanbao, Zalo

Интеграция Telegram

Telegram обеспечивает самую простую конфигурацию среди всех каналов. Требуется только bot token, созданный через BotFather.

Ключевые возможности Telegram: - Политики доступа к DM: pairing (требуется код подтверждения), allowlist (белый список), open (публичный), disabled - Управление группами: поддержка forum topics для маршрутизации на разных агентов - Форматирование: поддержка formatted text, inline buttons, аудио/видео сообщений, стикеров - Обогащённое форматирование: таблицы, блоки деталей, продвинутое оформление - Режимы доставки: long polling (по умолчанию) или webhook для real-time событий - Streaming preview: показ частичных результатов во время генерации - Реакции и уведомления: native реакции на сообщения, уведомления о выполнении

Конфигурация Telegram:

channels:
  telegram:
    enabled: true
    botToken: "YOUR_BOT_TOKEN"
    dmPolicy: "pairing"          # pairing, allowlist, open, disabled
    groupAllowlist: [123456789]  # ID групп
    useRichMessages: true        # Поддержка обогащённого форматирования

Устранение неполадок: - Privacy mode ограничивает видимость сообщений группы — требуется отключение или админ-статус - Сетевые timeout могут требовать IPv4/IPv6 регулировок - Overflow меню команд при большом количестве включённых плагинов


5. Система Skills (Навыки)

Концепция Skills

Skills — это файлы с инструкциями в формате Markdown, которые "учат" агентов использовать инструменты и выполнять задачи. Каждый skill состоит из директории с основным файлом SKILL.md, содержащим YAML frontmatter и Markdown описание.

Структура Skill

Минимальный SKILL.md требует:

---
name: my-skill           # Уникальный идентификатор
description: "Brief description"
---

# Skill Documentation
- How to use this capability
- When to apply it
- Examples

Опциональный frontmatter включает: - metadata.openclaw — правила активации (требуемые бинарники, переменные окружения) - tags — категоризация скиллов - version — версионирование

Приоритет загрузки Skills

OpenClaw загружает skills из 6 источников в порядке приоритета (первый победил):

  1. Workspace skills — специфичные для текущего агента
  2. Project agent skills — специфичные для проекта
  3. Personal agent skills — персональные skills агента
  4. Managed/local skills — управляемые skills
  5. Bundled skills — встроенные skills
  6. Extra directories и plugin skills — дополнительные источники

Установка Skills

Из ClawHub (публичного реестра):

openclaw skills install @owner/slug          # В рабочее пространство
openclaw skills install @owner/slug --global # Для всех локальных агентов
openclaw skills verify @owner/slug           # Проверка целостности

Из других источников:

openclaw skills install git:owner/repo@ref       # Из Git репозитория
openclaw skills install ./path/to/skill          # Из локальной директории

Управление доступом Agents к Skills

Allowlists контролируют, какие skills имеют доступ конкретные агенты, независимо от расположения файлов:

agents:
  myAgent:
    allowedSkills:
      - @owner/skill1
      - @owner/skill2

Можно установить общий baseline skills или ограничить конкретные агенты.

Skill Workshop

Функция Skill Workshop позволяет агентам предложить новые skills для рецензии перед применением изменений, обеспечивая контроль качества.


6. Система памяти (Memory)

Архитектура памяти

OpenClaw использует файловую архитектуру памяти, хранящуюся в обычном Markdown в рабочем пространстве (workspace). Система состоит из трёх компонентов:

MEMORY.md — Долгосрочное хранилище

Файл MEMORY.md содержит "durable facts, preferences, and decisions" (долгосрочные факты, предпочтения, решения), которые автоматически загружаются в начале сессии. Это хранилище должно быть компактным и курируемым, содержащим только проверенную информацию, а не необработанные стенограммы.

Daily Notes — Рабочий контекст

Дневники в memory/YYYY-MM-DD.md фиксируют текущий рабочий контекст и наблюдения. Система автоматически загружает файлы сегодняшнего дня и вчерашнего дня. Файлы индексируются для поиска, но не автоматически инжектируются в каждый prompt, что позволяет избежать перегрузки контекста.

DREAMS.md — Синтезированные выводы

Опциональный файл содержит "dreaming summaries" — синтезированные выводы из многодневного анализа для человеческой рецензии.

Процесс дистилляции памяти

Со временем агенты ожидаются "distill" (дистиллировать) ценный материал из дневных заметок вверх в MEMORY.md. Система разделяет постоянную и временную информацию:

Action-Sensitive Boundaries

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

Инструменты работы с памятью

Система предоставляет два основных инструмента: - memory_search — семантический поиск через встроенные (embedding) вектора и ключевые слова (hybrid methodology) - memory_get — получение конкретного файла памяти

При конфигурации с embeddings используется гибридный поиск, комбинирующий векторное сходство с keyword matching.

Automatic Memory-Flush

Перед компактизацией разговора (conversation compaction) OpenClaw запускает автоматический turn, промптирующий агента сохранить важный контекст, предотвращая потерю информации во время суммаризации.


7. Автоматизация и Cron/Triggers

Встроенный планировщик (Cron)

Cron — это встроенный в Gateway планировщик, управляющий автоматизированными задачами с персистентностью и точным контролем времени. Важный факт: "Cron runs inside the Gateway process, not inside the model" — это означает, что задачи выполняются непосредственно в Gateway, независимо от взаимодействий с LLM.

Ключевые характеристики

Типы расписаний (Schedule Types)

Тип Назначение Пример
at Одноразовое выполнение "20m" (через 20 минут) или ISO timestamp
every Фиксированный интервал "10m", "1h", "1d"
cron Cron-выражение (5-6 полей) "0 9 * * 1" (каждый понедельник в 09:00)
on-exit Триггер завершения команды Event-based автоматизация

Стили выполнения (Execution Styles)

Типы Payload

Задачи могут нести один из типов payload: - System events — очередь в основную сессию - Agent messages — вызов модели в отдельной сессии - Commands — shell скрипты без участия модели

Опции доставки (Delivery Options)

Примеры Cron команд

# Создать задачу на 07:00 каждый день
openclaw cron create "0 7 * * *" "Morning brief" --session isolated --announce

# Список всех задач
openclaw cron list

# Запустить задачу немедленно и ждать результата
openclaw cron run <jobId> --wait

# Создать одноразовую задачу через 30 минут
openclaw cron create "at 30m" "Send report" --session isolated

Pro Tips


8. Безопасность (Security)

Модель доверия

OpenClaw строится на модели персонального ассистента для одиночных развёртываний. Критически важный момент из документации: "OpenClaw is NOT a hostile multi-tenant security boundary for multiple adversarial users." Система предполагает доверенную сингл-юзер среду, а не враждебную мультитенант архитектуру.

Три основных принципа безопасности

  1. Identity First — контролировать, кто может контактировать бот через DM pairing, allowlists, явную политику доступа
  2. Scope Next — ограничить, где агенты могут действовать: group allowlists, tool policies, sandboxing
  3. Model Last — предположить, что модели можно манипулировать; спроектировать так, чтобы вред был содержан

Основные управляющие элементы (Core Controls)

DM Access Policy (четыре режима)

Tool Policy

Заблокировать high-risk tools по умолчанию; включить selectively:

tools:
  exec: disabled        # Shell execution — HIGH RISK
  browser: disabled     # Web browsing — MEDIUM RISK
  process: disabled     # Process management — HIGH RISK
  fileWrite: true       # Ограниченная запись файлов — MEDIUM
  fileRead: true        # Чтение файлов — LOW RISK

Sandboxing

Authentication

Security Audit

Команда проверяет потенциальные уязвимости:

openclaw security audit

Проверяет: - Открытый inbound доступ + включённые инструменты - Публичное сетевое exposure без аутентификации - Чрезмерно разрешительная загрузка файлов/плагинов - Опасные debug флаги

Рекомендация: запускайте эту команду после любого изменения конфигурации перед exposure сетевых поверхностей.

Baseline развёртывания

Соблюдайте эти правила: - Держите gateways на loopback (127.0.0.1) - Требуйте DM pairing для новых юзеров - Отключите exec/elevated tools для недоверенных отправителей - Поддерживайте tight permissions: 600 на config, 700 на директориях - Никогда не коммитьте .env, API ключи, secrets в git

Для враждебных окружений

Вместо полагания на разделённые controls в единственном Gateway, запустите отдельные Gateway процессы на разные trust boundaries. Каждый Gateway получит отдельный набор secrets, skills, tools.


9. Мульти-агентность (Multi-Agent Routing)

Концепция мульти-агентности

OpenClaw позволяет запускать несколько изолированных агентов в единственном Gateway процессе. Каждый агент работает полностью независимо с собственным workspace, state directory и session store.

Маршрутизация сообщений

Сообщения маршрутизируются к правильному агенту через bindings — отображения, связывающие аккаунты канала с конкретными агентами.

Документация утверждает: "if multiple bindings match within the same tier, the first one in config order wins." Существует иерархия (tier) совпадений: 1. Channel + account ID + peer информация 2. Channel + account ID 3. Channel только

Структура агента

Один агент состоит из: - Workspace — файлы, личностные гайды (SOUL.md, AGENTS.md), система памяти - State directory — хранение auth профилей, конфигурации - Dedicated session store — история чатов в JSONL формате под ~/.openclaw/agents/<agentId>/sessions/

Практические примеры маршрутизации

Маршрутизация на WhatsApp: Разные номера телефонов → разные агенты (быстрый для одного, мощный для другого)

Маршрутизация на Discord: Использовать отдельные bot tokens для каждого агента

Разделение DM на одном аккаунте: Одна личность может отправлять сообщения от одного телефонного номера разным агентам по sender ID

Конфигурация мульти-агента

agents:
  - id: support
    workspace: ~/.openclaw/workspaces/support
    defaultModel: anthropic/claude-opus-4
    allowedSkills:
      - @vendor/customer-support

  - id: developer
    workspace: ~/.openclaw/workspaces/dev
    defaultModel: anthropic/claude-opus-4
    allowedSkills:
      - @vendor/coding
      - @vendor/debugging

bindings:
  - channel: telegram
    accountId: "123456789"
    peerId: { type: user, id: "USER_1" }
    agentId: support

  - channel: telegram
    accountId: "123456789"
    peerId: { type: user, id: "USER_2" }
    agentId: developer

  - channel: discord
    accountId: "DISCORD_BOT_TOKEN_1"
    agentId: support

  - channel: discord
    accountId: "DISCORD_BOT_TOKEN_2"
    agentId: developer

Безопасность мульти-агентности

Каждый агент поддерживает полностью отдельные аутентификацию и session data, предотвращая столкновения состояния (state collision). Это позволяет: - Ограничивать skills для недоверенных агентов - Использовать разные модели для разных агентов - Изолировать рабочие пространства для повышенной безопасности


10. Agent Workspace

Обзор рабочего пространства

Agent workspace — это первичная рабочая директория агента и центр памяти, находящаяся по умолчанию в ~/.openclaw/workspace. Документация описывает её как "the only working directory used for file tools and for workspace context."

Структура файлов workspace

~/.openclaw/workspace/
├── AGENTS.md          # Инструкции и рекомендации по поведению
├── SOUL.md            # Персона, стиль общения, границы
├── USER.md            # Профиль пользователя, предпочтения, контакты
├── IDENTITY.md        # Имя агента, emoji, идентичность
├── TOOLS.md           # Конвенции использования инструментов
├── BOOTSTRAP.md       # Первичная настройка (удаляется после завершения)
├── MEMORY.md          # Курируемые долгосрочные факты (optional)
├── DREAMS.md          # Синтезированные выводы (optional)
├── memory/            # Дневные логи
│   ├── 2026-07-12.md  # Сегодняшние заметки
│   ├── 2026-07-11.md  # Вчерашние заметки
│   └── ...
└── skills/            # Workspace-специфичные skills (optional)
    ├── custom-skill-1/
    └── SKILL.md

Важное замечание о песочнице

Документация подчёркивает: "the workspace is the default cwd, not a hard sandbox" — это значит, что абсолютные пути могут получить доступ к файлам вне workspace, если sandboxing не включена. Это требует явной конфигурации sandbox контейнеров для полной изоляции.

Bootstrap файл

Файл BOOTSTRAP.md содержит инструкции первичной настройки и автоматически удаляется после первого запуска, что позволяет "одноразовым" инструкциям выполниться только один раз.

Стратегия резервной копии

OpenClaw рекомендует поддерживать приватный Git репозиторий для резервной копии workspace:

cd ~/.openclaw/workspace
git init
git remote add origin <private-repo>
git add .
git commit -m "Workspace backup"
git push -u origin main

Это сохраняет память и позволяет восстановление через машины. Критично: никогда не коммитьте secrets, API ключи, или что-либо под ~/.openclaw/ (конфигурация).

Миграция workspace

Для переноса workspace на другую машину: 1. Клонировать приватный Git репозиторий 2. Обновить agents.defaults.workspace в конфиге 3. Заново установить API ключи в отдельное хранилище (не в git)


11. Интеграция компонентов и примеры использования

Типичный lifecycle сессии

  1. Инициализация — Gateway загружает agent workspace, инжектирует AGENTS.md, SOUL.md, USER.md, IDENTITY.md в system prompt
  2. Загрузка памяти — MEMORY.md и дневные заметки загружаются в контекст
  3. Skill loading — Skills загружаются согласно приоритету
  4. Обработка сообщения — Инпут маршрутизируется к правильному агенту через bindings
  5. Выполнение — Агент использует инструменты, обновляет память, генерирует ответ
  6. Delivery — Ответ отправляется обратно через соответствующий канал

Полный стек фреймворка

┌─────────────────────────────────────────────────────────┐
│         OpenClaw Gateway Process (Node.js)              │
├─────────────────────────────────────────────────────────┤
│                                                           │
│  ┌──────────────────────────────────────────────────┐   │
│  │ Multi-Agent Router                                 │   │
│  │ - Bindings Configuration                           │   │
│  │ - Channel-to-Agent Mapping                         │   │
│  └──────────────────────────────────────────────────┘   │
│                        ↓                                  │
│  ┌──────────────────────────────────────────────────┐   │
│  │ Individual Agents (Isolated Sessions)             │   │
│  │ - Workspace (AGENTS.md, SOUL.md, etc.)            │   │
│  │ - Memory System (MEMORY.md, daily notes)          │   │
│  │ - Session Store (JSONL chat history)              │   │
│  │ - Model Provider (Claude, GPT, Gemini, etc.)      │   │
│  │ - Tool Execution (sandboxed tools)                │   │
│  └──────────────────────────────────────────────────┘   │
│                        ↓                                  │
│  ┌──────────────────────────────────────────────────┐   │
│  │ Cron Scheduler & Automation                      │   │
│  │ - Persistent Task Queue (SQLite)                 │   │
│  │ - Event-triggered Workflows                      │   │
│  │ - System Notifications                           │   │
│  └──────────────────────────────────────────────────┘   │
│                        ↓                                  │
│  ┌──────────────────────────────────────────────────┐   │
│  │ Channel Integrations Layer                        │   │
│  │ - Telegram (grammY), Discord, WhatsApp, etc.     │   │
│  │ - Media Handling (images, audio, files)          │   │
│  │ - Message Streaming & Real-time Updates          │   │
│  └──────────────────────────────────────────────────┘   │
│                        ↓                                  │
└─────────────────────────────────────────────────────────┘
     ↓                    ↓                    ↓
 Telegram            Discord             WhatsApp
 (grammY lib)        (discord.js)        (Baileys/Official)

Пример: Мульти-канальный клиентский сервис

Компания может развернуть OpenClaw с: - Telegram bot для quick support (быстрый Claude Haiku) - WhatsApp bot для сложных issues (Claude Opus) - Discord bot для разработчицких запросов (Claude Opus + coding skills) - Email интеграция для escalation (webhook triggers) - Ночная кронная работа для отчётов и аналитики

Каждый канал маршрутизируется на специализированного агента, использующего разные модели, skills, и tool policies согласно случаю.


12. Дополнительные ресурсы и команды

Полезные CLI команды

# Общие
openclaw --help                 # Справка
openclaw --version              # Версия
openclaw doctor                 # Диагностика окружения

# Onboarding и конфигурация
openclaw onboard                # Интерактивная настройка
openclaw onboard --install-daemon  # Установить в daemon режиме

# Gateway управление
openclaw gateway status         # Статус Gateway
openclaw gateway start          # Запустить Gateway
openclaw gateway stop           # Остановить Gateway
openclaw gateway logs           # Просмотр логов

# Модели
openclaw models list            # Список доступных моделей
openclaw models set <provider/model>  # Установить модель

# Skills
openclaw skills install @owner/slug   # Установить skill
openclaw skills list            # Список installed skills
openclaw skills verify @owner/slug    # Проверить skill

# Cron
openclaw cron list              # Список scheduled tasks
openclaw cron create "0 9 * * *" "Task name" --session isolated
openclaw cron run <jobId>       # Запустить task сейчас

# Безопасность
openclaw security audit         # Проверить уязвимости

# Интерфейс
openclaw dashboard              # Запустить веб-интерфейс

Требования для второго кандидата в ядро

Соискатель должен глубоко разбираться в:

  1. Архитектура многоагентной системы — как работает маршрутизация, binding, изоляция
  2. Система памяти — механизмы дистилляции, семантический поиск, компактизация сессий
  3. Tool execution и sandboxing — безопасность, доверие, модель threat
  4. Интеграции каналов — protocol-specific особенности (Telegram long polling vs webhook, WhatsApp QR pairing)
  5. Планировщик Cron — execution в Gateway, типы payload, обработка ошибок
  6. Model provider abstraction — как система коммутирует между Claude, GPT, Gemini
  7. Session management — JSONL формат, compaction, context window управление

Заключение

OpenClaw представляет собой зрелую, production-ready платформу для развёртывания многоканальных агентов ИИ. Её архитектура сбалансирована между мощностью (20+ каналов, мульти-агент, rich memory) и безопасностью (модель персонального доверия, tool policies, sandboxing).

Ключевые преимущества: - Полный контроль через self-hosting - Гибкая мультиканальность без перекодирования - Встроенная система памяти с дневниками и долгосрочным хранилищем - Native планировщик автоматизации (Cron) - Поддержка мульти-агентности с изоляцией - Open-source код для прозрачности и расширяемости

Критические точки для развёртывания: - Используйте DM pairing для Telegram/WhatsApp по умолчанию - Запускайте security audit перед production exposure - Поддерживайте приватный Git backup workspace - Изолируйте высокорисковые инструменты (exec, browser) - Отдельные Gateway на разные trust boundaries при необходимости

Платформа подходит как для личных ассистентов, так и для enterprise интеграций с правильной конфигурацией.


Источники документации

  1. https://docs.openclaw.ai/ — официальный портал документации
  2. https://docs.openclaw.ai/start/getting-started — руководство начала работы
  3. https://docs.openclaw.ai/install — инструкции установки
  4. https://docs.openclaw.ai/channels/telegram — интеграция Telegram
  5. https://docs.openclaw.ai/channels — поддерживаемые каналы
  6. https://docs.openclaw.ai/tools/skills — система Skills
  7. https://docs.openclaw.ai/concepts/memory — система памяти
  8. https://docs.openclaw.ai/automation/cron-jobs — Cron и автоматизация
  9. https://docs.openclaw.ai/gateway/security — безопасность
  10. https://docs.openclaw.ai/concepts/multi-agent — мульти-агентность
  11. https://docs.openclaw.ai/concepts/agent-workspace — рабочее пространство агента
  12. https://docs.openclaw.ai/concepts/agent — runtime агентов
  13. https://docs.openclaw.ai/concepts/model-providers — поддерживаемые модели
  14. https://github.com/openclaw/openclaw — исходный код на GitHub