Обзор платформы
OpenClaw - это универсальный высокоуровневый шлюз (AI Gateway), спроектированный для того, чтобы стать связующим звеном между передовыми большими языковыми моделями (LLM) и повседневными инструментами коммуникации. Платформа обеспечивает бесшовную интеграцию нейросетевого интеллекта в мессенджеры, социальные сети и системы автоматизации, такие как n8n.
В отличие от простых оберток для API, OpenClaw предоставляет разработчикам и системным архитекторам комплексный инструментарий «из коробки». Основные возможности включают:
Управление контекстом и памятью: Поддержка сессий позволяет ИИ-агентам помнить историю диалога, создавая ощущение осмысленного общения.
Анализ документов: Встроенные механизмы обработки файлов позволяют «скармливать» агенту документацию для извлечения данных или суммаризации.
Динамические навыки (Skills): Выполнение сложных логических цепочек и команд в режиме реального времени.
Безопасность и маршрутизация: Шлюз берет на себя все технические сложности: авторизацию у провайдеров (OpenAI, Anthropic и др.), управление защищенными соединениями и эффективную пересылку сообщений.
OpenClaw - это идеальный фундамент для построения масштабируемых чат-ботов, корпоративных ассистентов и систем автоматизации бизнес-коммуникаций, ориентированных на долгосрочную эксплуатацию и высокую нагрузку.
Инструкция по началу работы
1. Подготовительный этап: Развертывание и доступ к серверу
Процесс начинается с выбора и установки образа OpenClaw из нашего Маркетплейса. Система автоматически подготовит среду, установит необходимые зависимости и подготовит сервер к работе.
После завершения инсталляции вам необходимо подключиться к серверу по протоколу SSH. Это ваш основной инструмент для администрирования. В зависимости от вашей операционной системы, используйте следующие рекомендации:
Для пользователей Linux и MacOS: Откройте системный терминал и используйте стандартную команду
ssh root@IP_сервера. Подробный гайд доступен по ссылке: Подключение через SSH.Для пользователей Windows: Мы рекомендуем использовать встроенный клиент (PowerShell/CMD) или профессиональные утилиты, такие как PuTTY. Инструкция: Подключение из Windows.
Для входа используйте пароль, указанный в панели управления при создании сервера, или предварительно настроенный SSH-ключ (этот метод является более предпочтительным с точки зрения кибербезопасности).
2. Инициализация системы и базовая конфигурация
Как только вы окажетесь в консоли сервера, необходимо запустить интерактивный мастер настройки. Он выполнит «чистовую» установку фонового процесса (демона) и поможет задать основные параметры работы шлюза. Введите команду:
openclaw onboard --install-daemon
В процессе работы мастера (режим QuickStart) система предложит вам выбрать несколько ключевых параметров. Для стабильной работы рекомендуем следующие значения:
Onboarding mode: Выберите
QuickStartдля автоматизированной настройки.Gateway port: Оставьте стандартный порт
18789. Это внутренний канал связи для веб-интерфейса и API.Gateway bind: Установите адрес
127.0.0.1. Это критически важная настройка безопасности - она ограничивает доступ к шлюзу из внешней сети, защищая вашу панель управления от несанкционированных попыток входа.
3. Выбор ИИ-провайдера и модели (Model/auth provider)
OpenClaw является мультипровайдерной платформой и поддерживает более 30 различных сервисов. Вы можете гибко переключаться между ними в зависимости от задач и бюджета. Список поддерживаемых систем включает:
Глобальные лидеры: OpenAI (GPT-4), Anthropic (Claude), Google Gemini, xAI (Grok).
Специализированные и открытые платформы: Mistral AI, Hugging Face, Together AI, Ollama (для локальных моделей), DeepSeek, Qwen и многие другие.
Шлюзы-агрегаторы: OpenRouter, Vercel AI Gateway, Cloudflare AI Gateway.
Совет для тестирования: Если вы хотите проверить работоспособность бота прямо сейчас, не имея под рукой API-ключа, выберите опцию
Skip for nowили установите модель в режимecho. В этом режиме бот будет просто дублировать ваши сообщения, подтверждая, что связь с мессенджером установлена успешно.
4. Подключение каналов связи (мессенджеров)
OpenClaw позволяет объединить множество каналов общения в одном интерфейсе. Поддерживаются: Telegram, WhatsApp (через QR-линк), Discord, Slack, Microsoft Teams, Signal, а также более экзотические протоколы, такие как Matrix или Nostr.
Самый быстрый способ запустить проект - подключить Telegram-бота:
В меню выбора каналов (Select channel) выберите
Telegram (Bot API).Введите токен вашего бота (Bot Token). Если у вас его нет, создайте его в Telegram через официального бота
@BotFather.После ввода токена система автоматически создаст рабочую директорию по адресу
~/.openclaw/workspace, где будут храниться логи и временные данные сессий.На этапе настройки поиска (Web-search) выберите
Skip for now, если вам не требуется мгновенный доступ бота к актуальной информации из интернета.
5. Авторизация модели и подтверждение связи (Pairing)
Чтобы ваш бот «ожил» и начал использовать интеллект (на примере Google Gemini 2.5 Flash), необходимо активировать модель и пройти процедуру сопряжения.
Выполните команды в терминале:
Установите ваш API-ключ:
openclaw config set providers.google.apiKey "ВАШ_API_КЛЮЧ"Назначьте модель по умолчанию для сессий:
openclaw config set session.defaultModel "google/gemini-2.5-flash"
Процедура Pairing (Безопасное сопряжение): Это механизм защиты, гарантирующий, что управлять ботом будете именно вы. Отправьте любое текстовое сообщение вашему созданному боту в Telegram. В ответ бот пришлет уникальный код безопасности. Вернитесь в терминал сервера и введите команду подтверждения:
openclaw pairing approve telegram <КОД_ИЗ_ЧАТА>6. Доступ к Web UI через безопасный SSH-туннель
Поскольку в шаге №2 мы ограничили доступ к панели управления адресом 127.0.0.1, вы не сможете открыть её просто по IP сервера. Для безопасного входа используется SSH-туннелирование. Оно создает «виртуальный мост» между вашим компьютером и сервером.
На вашем локальном компьютере (не на сервере!) откройте новое окно терминала и выполните:
ssh -L 18789:127.0.0.1:18789 root@IP_ВАШЕГО_СЕРВЕРА
Держите это окно терминала открытым, пока работаете в браузере.
Откройте браузер и перейдите по ссылке, которую сгенерировала система при установке. Она выглядит примерно так: http://127.0.0.1:18789/#token=ВАШ_УНИКАЛЬНЫЙ_ТОКЕН
Что дает Web UI:
Chat Test: Живое тестирование логики бота.
Visual Logs: Детальная отладка каждого запроса - вы видите, какие данные ушли в нейросеть и что пришло в ответ.
Skills Management: Управление навыками и инструментами агента через графический интерфейс, без правок конфигов в консоли.
Важное примечание по сетевым настройкам: Для обеспечения безопасности инфраструктуры исходящий порт 25 (используемый для прямой отправки почты SMTP) закрыт по умолчанию. Если ваша логика автоматизации требует рассылки уведомлений через этот порт, пожалуйста, обратитесь в нашу службу технической поддержки для его разблокировки после проверки целей использования.
Заключение
OpenClaw - это мощный, гибкий и профессиональный инструмент, который стирает границы между сложными нейросетевыми технологиями и прикладными задачами бизнеса. Благодаря четкой архитектуре и поддержке множества провайдеров, вы строите проект, который легко масштабировать и адаптировать под меняющийся рынок ИИ.
Более подробную информацию, примеры сложных воркфлоу и API-документацию вы всегда можете найти на официальном портале: https://docs.openclaw.ai