Реклама

RawLaunch

Платформа для быстрого запуска MVP и пет-проектов.

OpenClaw: установка, настройка и запуск собственного AI-ассистента

�

Владимир ИТ

06.04.2026

13 4 мин
#openclaw

OpenClaw - это open-source персональный AI-ассистент, который запускается на вашем устройстве и подключается к внешним AI-провайдерам вроде Anthropic, OpenAI и OpenRouter. Если упростить, это не отдельная модель и не просто ещё один чат в браузере, а удобная прослойка между вами, нейросетью и вашими привычными каналами общения.

OpenClaw позволяет сделать AI более прикладным: общаться с моделью не только через сайт провайдера, но и через терминал, локальный web dashboard, Telegram, WhatsApp, Discord, Slack и другие каналы. Такой формат особенно хорошо подходит тем, кто хочет встроить AI в ежедневную работу, а не держать его отдельной вкладкой в браузере.

По сути, OpenClaw это собственный интерфейс к LLM, который можно развернуть локально, настроить под себя и использовать как персонального ассистента для задач, связанных с кодом, исследованиями, рабочими заметками и повседневными запросами.

Зачем вообще нужен OpenClaw

Большинство людей привыкло пользоваться AI через веб-интерфейс: открыл ChatGPT или Claude, задал вопрос, получил ответ. Это удобно, пока AI остаётся отдельным приложением. Но как только хочется встроить его в рабочий процесс, начинают всплывать ограничения: приходится постоянно переключаться между окнами, копировать ответы вручную, отдельно держать мессенджеры, терминал и браузер.

OpenClaw решает эту проблему иначе. Он делает AI ближе к тем инструментам, которыми вы уже пользуетесь каждый день.

  • Для разработчика это удобный вход к модели прямо из терминала.

  • Для personal use это возможность писать своему ассистенту с телефона через Telegram или WhatsApp.

  • Для команды это способ подключить бота в рабочий чат.

  • Для тех, кто любит контроль это локальный gateway, понятный конфиг и явные ограничения безопасности.

В результате OpenClaw это не столько "ещё один AI-сервис", сколько удобный каркас для собственного AI-помощника.

Что понадобится перед установкой

Перед началом лучше сразу проверить базовые требования. Без этого установка может пройти, но запуск или onboard-этап начнут ломаться в самый неподходящий момент.

  • Node.js 22 или новее

  • npm, который обычно уже идёт вместе с Node.js

  • macOS или Linux

  • Windows - только через WSL2

  • API-ключ от одного из поддерживаемых провайдеров

Если у вас Windows без WSL2, лучше сначала поднять именно его. Нативный запуск без WSL2 не считается поддерживаемым сценарием.

Проверяем Node.js

node --version

Если в ответ вы видите что-то вроде v22.x.x, всё в порядке. Если Node.js ещё не установлен, нужно установить:

# macOS через Homebrew
brew install node

# macOS или Linux через fnm
curl -fsSL https://fnm.vercel.app/install | bash
fnm install 22

Либо можно скачать официальный установщик с nodejs.org.

Как установить OpenClaw

Базовая установка делается одной командой:

npm install -g openclaw@latest

После установки стоит сразу проверить, что CLI действительно появился в системе:

openclaw --version

Если на этапе установки возникает ошибка с правами доступа, на macOS и Linux иногда помогает запуск через sudo:

sudo npm install -g openclaw@latest

Если пакет поставился, но команда openclaw не находится, скорее всего глобальная папка npm не попала в PATH. В таком случае помогает:

export PATH="$(npm config get prefix)/bin:$PATH"

Если после этого всё заработало, эту строку стоит добавить в ~/.zshrc или ~/.bashrc.

Какого AI-провайдера выбрать

OpenClaw сам по себе не является моделью. Он работает как интерфейс и orchestration-слой, а сами ответы идут через внешний API. На практике выбор сводится к трём популярным вариантам.

Anthropic

Хороший старт, если основной сценарий разработка, длинный reasoning, анализ задач, code review и многошаговые диалоги. Для такого формата Claude часто оказывается очень удобным вариантом.

OpenAI

Подходит тем, кто и так уже сидит в экосистеме OpenAI или хочет строить основной workflow вокруг GPT-моделей.

OpenRouter

Удобен, если хочется гибкости: один слой доступа, один ключ и возможность переключаться между провайдерами без отдельного зоопарка настроек.

Как получить API-ключ

API-ключ здесь это фактически пароль для доступа к модели. Его нельзя хранить в публичном репозитории, отправлять в скриншотах и вставлять в открытые конфиги, если вы не уверены, где эти файлы окажутся.

Anthropic

  1. Откройте console.anthropic.com.

  2. Перейдите в Settings → API Keys.

  3. Нажмите Create Key.

  4. Скопируйте ключ сразу после создания.

  5. Проверьте, что в аккаунте включён billing.

Обычно такой ключ начинается с sk-ant-.

OpenAI

  1. Откройте platform.openai.com/api-keys.

  2. Создайте новый secret key.

  3. Скопируйте его сразу после создания.

  4. Убедитесь, что настроен billing.

Обычно ключ OpenAI начинается с sk-.

OpenRouter

  1. Откройте openrouter.ai/keys.

  2. Создайте ключ.

  3. Скопируйте его.

  4. При необходимости пополните credits.

Обычно ключ OpenRouter начинается с sk-or-.

Первый запуск и initial setup

Самая важная команда в начале - onboard. Она делает сразу несколько вещей:

  • настраивает аутентификацию с выбранным провайдером;

  • поднимает локальный gateway;

  • устанавливает и запускает daemon;

  • делает health check, чтобы убедиться, что всё работает.

Anthropic

openclaw onboard --install-daemon --anthropic-api-key "sk-ant-your-key-here"

OpenAI

openclaw onboard --install-daemon --openai-api-key "sk-your-key-here"

OpenRouter

openclaw onboard --install-daemon --auth-choice apiKey --token-provider openrouter --token "sk-or-your-key-here"

Если non-interactive режим почему-то не сработал, можно просто запустить onboarding в интерактивном виде:

openclaw onboard --install-daemon

После этого останется выбрать провайдера и вставить ключ через prompts.

Где лежит основной конфиг

Главный конфигурационный файл находится по пути:

~/.openclaw/openclaw.json

В нём задаются модель, параметры агентов, настройки gateway, каналы, правила доступа и другие системные параметры.

Как выбрать модель по умолчанию

После первой настройки полезно сразу указать default model, именно она будет использоваться в новых сессиях, если не задано иное.

Пример для Anthropic

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6"
      }
    }
  }
}

Пример для OpenAI

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openai/gpt-5.2"
      }
    }
  }
}

Пример для OpenRouter

Формат модели у OpenRouter выглядит как openrouter/provider/model.

{
  "agents": {
    "defaults": {
      "model": {
        "primary": "openrouter/anthropic/claude-sonnet-4-6"
      }
    }
  }
}

Какие настройки стоит добавить сразу

Есть несколько параметров, которые заметно улучшают повседневную работу и делают поведение ассистента более предсказуемым.

{
  "agents": {
    "defaults": {
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    }
  }
}

Что означают эти параметры

  • compaction.mode: "safeguard" - помогает не терять контекст в длинных диалогах и сложных задачах.

  • maxConcurrent: 4 - ограничивает число параллельных задач. Если машина слабая, значение можно уменьшить. Если у вас мощное железо и реальная нагрузка, увеличить.

  • subagents.maxConcurrent: 8 - полезно для сценариев, где запускаются вспомогательные подпроцессы.

  • ackReactionScope: "group-mentions" - в групповых чатах бот будет реагировать только там, где его явно упомянули.

  • native: "auto" и nativeSkills: "auto" - делают встроенное поведение удобнее без лишней ручной настройки.

Как обезопасить OpenClaw

Безопасность это не опциональная секция, а обязательная часть настройки. У OpenClaw правильная идея "local by default", но эти настройки всё равно стоит проверить вручную.

{
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token"
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  }
}

На что обратить внимание

  • bind: "loopback" - gateway слушает только 127.0.0.1, то есть доступен только на вашей машине.

  • auth.mode: "token" - включает обязательную аутентификацию для запросов.

  • denyCommands - заранее блокирует чувствительные действия вроде камеры, записи экрана, календаря и контактов.

Практическое правило очень простое: если не уверены, оставляйте OpenClaw максимально локальным и максимально закрытым.

Как подключить Telegram

Из всех каналов Telegram один из самых простых вариантов для старта.

Шаг 1. Создайте бота через BotFather

Откройте Telegram, найдите @BotFather и отправьте:

/newbot

После этого BotFather выдаст вам токен.

Шаг 2. Добавьте конфиг

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-bot-token-here",
      "dmPolicy": "pairing"
    }
  }
}

Шаг 3. Перезапустите daemon

openclaw daemon restart

Шаг 4. Подтвердите pairing

Отправьте боту любое сообщение, затем выполните:

openclaw pairing list telegram
openclaw pairing approve telegram YOUR_CODE

Как подключить WhatsApp

Подключение WhatsApp работает через QR-код - примерно как WhatsApp Web.

Шаг 1. Добавьте конфиг

{
  "channels": {
    "whatsapp": {
      "enabled": true,
      "dmPolicy": "pairing",
      "allowFrom": ["+your-phone-number"],
      "groupPolicy": "allowlist",
      "groupAllowFrom": ["+your-phone-number"]
    }
  }
}

Телефон нужно указывать в международном формате, например +12125551234.

Шаг 2. Запустите логин

openclaw daemon restart
openclaw channels login --channel whatsapp

Шаг 3. Отсканируйте QR-код

В WhatsApp откройте Settings → Linked Devices → Link a Device.

Шаг 4. Подтвердите pairing

openclaw pairing list whatsapp
openclaw pairing approve whatsapp YOUR_CODE

Как подключить Discord

В Discord потребуется создать bot application в developer portal.

  1. Откройте discord.com/developers/applications.

  2. Создайте New Application.

  3. На вкладке Bot получите token.

  4. Включите Message Content Intent.

  5. В разделе OAuth2 → URL Generator выдайте боту права:

    • Send Messages

    • Read Message History

    • Add Reactions

    • Attach Files

    • Embed Links

  6. Добавьте бота на сервер.

Конфиг

{
  "channels": {
    "discord": {
      "enabled": true,
      "botToken": "your-bot-token-here",
      "dmPolicy": "pairing"
    }
  }
}

Проверка

openclaw daemon restart
openclaw channels status --probe

Как подключить Slack

Для Slack нужен и bot token, и app token для socket mode.

Что понадобится

  • xapp-... - App Token

  • xoxb-... - Bot User OAuth Token

Базовые шаги

  1. Откройте api.slack.com/apps.

  2. Создайте новое приложение.

  3. Включите Socket Mode.

  4. Сгенерируйте App Token.

  5. Добавьте bot scopes:

    • chat:write

    • channels:history

    • im:history

    • app_mention

  6. Установите приложение в workspace.

  7. Включите события message.im и app_mention.

Конфиг

{
  "channels": {
    "slack": {
      "enabled": true,
      "botToken": "xoxb-your-bot-token",
      "appToken": "xapp-your-app-token",
      "dmPolicy": "pairing"
    }
  }
}

После настройки

openclaw daemon restart
openclaw channels status --probe

Как подключить Lark / Feishu

Если нужен этот канал, схема тоже достаточно прямая: создаётся Custom App, копируются App ID и App Secret, после чего данные добавляются в конфиг.

{
  "channels": {
    "feishu": {
      "enabled": true,
      "domain": "lark",
      "accounts": {
        "main": {
          "appId": "cli_your-app-id",
          "appSecret": "your-app-secret"
        }
      }
    }
  }
}

Если используется именно Feishu, а не международный Lark, значение domain нужно поменять на feishu.

Как подключить iMessage

Этот вариант доступен только на macOS и требует дополнительный CLI-инструмент и системные разрешения.

Шаг 1. Установите helper tool

brew install steipete/tap/imsg

Шаг 2. Выдайте разрешения

  • Full Disk Access для терминала

  • Automation для Messages

Шаг 3. Добавьте конфиг

{
  "channels": {
    "imessage": {
      "enabled": true,
      "cliPath": "/usr/local/bin/imsg",
      "dbPath": "/Users/YOUR_USERNAME/Library/Messages/chat.db"
    }
  }
}

Шаг 4. Перезапустите daemon

openclaw daemon restart

Как ограничить доступ к каналам

У разных каналов используется общая логика контроля доступа.

  • pairing - новый контакт должен быть подтверждён вручную. Это хороший default для личного использования.

  • allowlist - более жёсткий режим, в котором доступ есть только у явно перечисленных идентификаторов.

Если OpenClaw используется как персональный ассистент, pairing обычно достаточно. Если он разворачивается на более общем сервере или в командной среде, лучше двигаться в сторону allowlist.

Как проверить, что всё работает

После настройки полезно сделать минимальную sanity-check проверку.

openclaw daemon restart
sleep 3
openclaw models list

Если всё в порядке, вы увидите доступные модели. Например:

anthropic/claude-sonnet-4-6

Если список пустой, самые частые причины такие:

  • неверный API-ключ;

  • не включён billing;

  • ошибка в конфиге;

  • провайдер не был корректно настроен на этапе onboarding.

Проверка каналов

openclaw channels status --probe

Эта команда проверяет каналы и показывает, живы ли соединения.

Как использовать OpenClaw каждый день

После установки OpenClaw обычно используют минимум в двух основных режимах.

1. Терминальный интерфейс

openclaw tui

Это удобный terminal UI. Самый естественный вариант для разработчиков и тех, кто много времени проводит в shell.

2. Web dashboard

openclaw dashboard

После запуска откройте в браузере:

http://127.0.0.1:18789

Такой вариант удобен для более длинных диалогов и визуального взаимодействия.

3. Мессенджеры

Если подключены Telegram, WhatsApp или другие каналы, общаться с OpenClaw можно буквально как с обычным ботом. Это удобно, когда нужен быстрый вопрос с телефона, короткое напоминание, уточнение по рабочей задаче или AI-помощь вне ноутбука.

Пример хорошего базового конфига

Ниже аккуратный базовый шаблон, который можно взять за основу и адаптировать под себя.

{
  "env": {
    "ANTHROPIC_API_KEY": "sk-ant-your-key-here"
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "anthropic/claude-sonnet-4-6"
      },
      "compaction": {
        "mode": "safeguard"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "123456:ABC-your-bot-token",
      "dmPolicy": "pairing"
    },
    "whatsapp": {
      "enabled": true,
      "dmPolicy": "pairing",
      "allowFrom": ["+1234567890"]
    }
  },
  "gateway": {
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token"
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "calendar.add",
        "contacts.add",
        "reminders.add"
      ]
    }
  },
  "messages": {
    "ackReactionScope": "group-mentions"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto"
  },
  "skills": {
    "install": {
      "nodeManager": "npm"
    }
  }
}

Что делать, если что-то не работает

У OpenClaw, как и у большинства CLI-инструментов с daemon и внешними интеграциями, основные проблемы обычно довольно типовые.

  • неправильный API-ключ;

  • не включён billing;

  • ошибка в openclaw.json;

  • daemon не был перезапущен после изменений;

  • канал подключён, но pairing ещё не подтверждён;

  • не хватает системных разрешений на macOS.

Самая полезная команда для диагностики выглядит так:

openclaw daemon logs

Именно она чаще всего помогает быстрее всего понять реальную причину проблемы.

Итог

OpenClaw - это очень практичный способ превратить большую языковую модель в собственного ассистента, который живёт ближе к вашим реальным инструментам и привычкам. Он запускается локально, подключается к разным AI-провайдерам, умеет работать через CLI, web dashboard и мессенджеры, а при аккуратной настройке остаётся достаточно безопасным и контролируемым.

0

Комментарии (0)

Войдите, чтобы оставить комментарий

Похожие статьи

Разработка и инструменты • 2 месяца назад

Как скачивать файлы по URL в Laravel

Подробное руководство по скачиванию файлов из внешних URL в Laravel: от простого стриминга до продакшен-ориентированных подходов с сохранением и раздачей файлов пользователям.

�
Владимир ИТ
96 0 2 мин
#laravel #php
Разработка и инструменты • 2 месяца назад

Типичные ошибки безопасности в Laravel-приложениях и как их правильно исправить

Распространённые ошибки безопасности в Laravel-приложениях и способы их устранения. Разбираем CSRF, SQL-инъекции, XSS, массовое заполнение, загрузку файлов и настройки окружения.

�
Владимир ИТ
141 0 1 мин
#laravel #php
Разработка и инструменты • 1 месяц назад

Laravel Cloud научился отдавать Markdown специально для ИИ-агентов

Платформа Laravel Cloud получила новую функцию "Markdown for Agents", которая позволяет отдавать страницы в Markdown-формате специально для ИИ-агентов. Это делает контент легче для анализа, экономит токены и ускоряет работу автоматических систем.

�
Владимир ИТ
96 0 1 мин
#AI #laravel