OpenClaw — это self-hosted шлюз, который связывает ваши мессенджеры (Telegram, Discord, WhatsApp и другие) с ИИ-агентом. Вы устанавливаете один процесс на свой компьютер или сервер, и он становится мостом между вашими чатами и AI-ассистентом.
Что нужно для начала:
Быстрая установка (рекомендуемый способ)
Это самый простой путь: скрипт сам определит вашу ОС, установит Node.js (если нужно), установит OpenClaw и запустит первоначальную настройку.
macOS / Linux / WSL2:
curl -fsSL https://openclaw.ai/install.sh | bash
Windows (PowerShell):
iwr -useb https://openclaw.ai/install.ps1 | iex
Мне нужно установить без онбординга (без мастера настройки)
Если вы хотите установить OpenClaw, но настроить его позже:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard
Шаг 2: Первоначальная настройка (онбординг)
После установки скрипт автоматически запустит мастер настройки. Если вы запускали вручную:
openclaw onboard --install-daemon
Мастер проведёт вас через несколько шагов (занимает ~2 минуты):
~/.openclaw/workspace)QuickStart или Advanced — что выбрать?
QuickStart (по умолчанию) — для большинства пользователей. Настроит:
codingAdvanced — если вам нужен полный контроль: выбор порта, адреса привязки, режима авторизации, exposure через Tailscale и другие параметры.
Что делать, если нет API-ключа?
API-ключ нужен для работы с ИИ-моделью. Получить его можно у провайдеров:
| Провайдер | Где получить | Бесплатный тир | OpenAI | platform.openai.com | Нет (pay-as-you-go) | Anthropic | console.anthropic.com | Нет (pay-as-you-go) | Google (Gemini) | aistudio.google.com | Да (ограниченно) | OpenRouter | openrouter.ai | Да (ограниченно) | DeepSeek | platform.deepseek.com | Да (ограниченно) |
|---|
Для начала рекомендуем Google Gemini или OpenRouter — у них есть бесплатный тир, которого хватит для тестирования.
Полная справка по визарду (openclaw onboard)
Режимы
- Локальный (по умолчанию) — настройка модели, workspace, Gateway, каналов, демона, скиллов
- Remote — настройка подключения к Gateway на другом хосте (ничего не меняет на удалённой машине)
Сброс (—reset)
--resetпо умолчанию: config + creds + sessions--reset-scope full: также удаляет workspace- Reset использует
trash(можно восстановить)
Обнаружение конфига
Если ~/.openclaw/openclaw.json существует — выбор: Keep, Modify, Reset. Повторный запуск не стирает данные без явного Reset.
Опции авторизации
| API-ключ | Стандартный ключ провайдера |
| OAuth | OpenAI Codex (ChatGPT OAuth) |
| Ollama | Локальные модели |
| Custom | Кастомный endpoint + ключ |
Каналы (пошагово)
- WhatsApp: QR-логин
- Telegram: bot token
- Discord: bot token
- Google Chat: service account JSON
- Signal: signal-cli + account config
Демон
- macOS: LaunchAgent
- Linux/WSL2: systemd user unit (+
loginctl enable-linger) - Windows: Scheduled Task
Автоматизация онбординга (non-interactive)
Для скриптов и CI/CD используйте --non-interactive:
openclaw onboard --non-interactive --mode local --auth-choice apiKey --anthropic-api-key "$ANTHROPIC_API_KEY" --secret-input-mode plaintext --gateway-port 18789 --gateway-bind loopback --install-daemon --daemon-runtime node --skip-skills
--secret-input-mode ref — хранение env-backed refs вместо plaintext. Переменные окружения должны быть установлены.
Примеры по провайдерам:
| Anthropic | --auth-choice apiKey --anthropic-api-key "$KEY" |
| Gemini | --auth-choice gemini-api-key --gemini-api-key "$KEY" |
| OpenAI | --auth-choice openai-api-key --openai-api-key "$KEY" |
| OpenRouter | --auth-choice openrouter-api-key --openrouter-api-key "$KEY" |
| Ollama | --auth-choice ollama |
--json для машинно-читаемого вывода. --accept-risk для подтверждения.
Шаг 3: Проверяем, что всё работает
openclaw gateway status
Вы должны увидеть, что Gateway слушает порт 18789.
Откройте дашборд в браузере:
openclaw dashboard
Если страница загрузилась — всё работает. Напишите сообщение в чат и получите ответ от ИИ.
Хочу общаться с агентом с телефона
Самый быстрый способ — подключить Telegram. Нужно лишь создать бота через @BotFather и получить токен. Подробнее: Telegram.
Все доступные каналы: Discord, WhatsApp, Signal, Slack, Telegram, iMessage, Matrix, Microsoft Teams, Google Chat, Feishu, IRC, LINE, Nostr, Twitch, Zalo и другие.
Альтернативные способы установки
Через npm (если вы уже управляете Node.js)
npm install -g openclaw@latest
openclaw onboard --install-daemon
Используете pnpm или bun?
pnpm:
pnpm add -g openclaw@latest
pnpm approve-builds -g
openclaw onboard --install-daemon
bun:
bun add -g openclaw@latest
openclaw onboard --install-daemon
Docker
Если вы предпочитаете контейнеры — отдельная статья: Установка на VPS.
Из исходного кода (для разработчиков)
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install && pnpm build && pnpm ui:build
pnpm link --global
openclaw onboard --install-daemon
Если что-то пошло не так
`openclaw: command not found`
Скорее всего, npm не знает, куда установить глобальные пакеты. Проверьте:
node -v # Node установлен?
npm prefix -g # Куда ставятся глобальные пакеты?
echo "$PATH" # Этот путь есть в PATH?
Если пути нет — добавьте в ~/.zshrc или ~/.bashrc:
export PATH="$(npm prefix -g)/bin:$PATH"
Затем откройте новый терминал.
Ошибки прав при установке на Linux (EACCES)
Если видите EACCES, перенастройте npm на пользовательскую директорию:
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"
export PATH="$HOME/.npm-global/bin:$PATH"
Добавьте export PATH=... в ваш ~/.bashrc или ~/.zshrc, чтобы сохранить навсегда.
Gateway не запускается
openclaw doctor
Эта команда проверит конфигурацию и покажет, что не так.
Обновление OpenClaw
Когда выйдет новая версия:
openclaw update
Эта команда сама определит тип установки (npm или git), обновит, запустит openclaw doctor и перезапустит Gateway.
Если хотите обновиться до бета-версии:
openclaw update --channel beta
Как включить автообновление
Добавьте в ~/.openclaw/openclaw.json:
{
"update": {
"channel": "stable",
"auto": {
"enabled": true,
"stableDelayHours": 6
}
}
}
OpenClaw будет проверять обновления и устанавливать их автоматически с задержкой 6 часов (чтобы вышла стабильная версия).
Что дальше?
После установки рекомендуем: