Решение проблем OpenClaw — установка, настройка, ошибки

OpenClaw — AI-агент, который работает на вашем компьютере, сервере или в облаке и общается через Telegram, Discord или веб-чат. При самостоятельной установке OpenClaw и настройке неизбежно возникают вопросы: не ставится, не запускается gateway, ошибка "pairing required", модели не подключаются. В этой статье собраны решения самых частых проблем — от установки до подключения моделей и мессенджеров.

1. Установка OpenClaw

Linux / Ubuntu / VPS

Самый распространённый вариант — установка OpenClaw на VPS с Ubuntu. Два способа:

Способ 1: через npm

# Убедитесь, что Node.js >= 18 установлен
node -v

# Глобальная установка
npm install -g openclaw

# Проверка
openclaw --version

Способ 2: через curl-скрипт

curl -fsSL https://get.openclaw.ai | bash

Скрипт автоматически установит зависимости, скачает последнюю версию и добавит openclaw в PATH.

После установки запустите первичную настройку:

openclaw configure

Windows

OpenClaw на Windows работает через WSL (Windows Subsystem for Linux) — это рекомендуемый способ. Нативная установка на Windows возможна, но менее стабильна.

Через WSL (рекомендуется):

# Установите WSL, если ещё нет
wsl --install

# Внутри WSL (Ubuntu) — стандартная установка
npm install -g openclaw
openclaw configure

Нативно через PowerShell:

# Убедитесь, что Node.js установлен
node -v

# Установка
npm install -g openclaw
openclaw configure

На Windows могут быть проблемы с правами доступа и путями. Если возникают ошибки — переходите на WSL.

Docker

Установка OpenClaw через Docker — удобный вариант для изоляции и быстрого развёртывания:

# Запуск контейнера
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -p 6901:6901 \
  -v openclaw-data:/data \
  --restart unless-stopped \
  openclaw/openclaw-desktop:latest

После запуска контейнера gateway и VNC-интерфейс будут доступны по портам 18789 и 6901 соответственно. Конфигурацию можно передать через переменные окружения или примонтировать файл config.json.

Mac

На macOS установка аналогична Linux:

# Через Homebrew (если Node.js не установлен)
brew install node

# Установка OpenClaw
npm install -g openclaw
openclaw configure

2. Настройка OpenClaw

После установки OpenClaw нужно пройти настройку. Команда openclaw configure запустит интерактивный мастер, который создаст файл конфигурации.

Файл конфигурации config.json обычно находится в ~/.openclaw/config.json. Основные параметры:

{
  "gateway": {
    "port": 18789,
    "token": "ваш-секретный-токен"
  },
  "llm": {
    "provider": "openrouter",
    "apiKey": "sk-or-..."
  },
  "channels": {
    "telegram": {
      "botToken": "123456:ABC-..."
    }
  },
  "allowedSenders": [
    "telegram:123456789"
  ]
}

Важные параметры:

• gateway.token — секретный токен для доступа к gateway OpenClaw. Генерируется автоматически при openclaw configure
• llm.provider — провайдер моделей: openrouter, anthropic, openai, ollama
• llm.apiKey — API-ключ провайдера
• channels — настройки мессенджеров
• allowedSenders — список разрешённых пользователей (защита от несанкционированного доступа)

3. Подключение моделей

OpenRouter (рекомендуется для России)

OpenRouter — агрегатор AI-моделей: Claude, GPT, Gemini, DeepSeek, Qwen и другие. Главное преимущество — не нужен VPN для доступа из России (на март 2026).

# В config.json:
"llm": {
  "provider": "openrouter",
  "apiKey": "sk-or-ваш-ключ"
}

Ключ можно получить на openrouter.ai. Через OpenRouter доступны модели DeepSeek, Qwen и сотни других — достаточно указать нужную модель в настройках.

Ollama (локальные модели)

Ollama позволяет запускать модели локально — без интернета и API-ключей. Подходит для приватности и экономии.

# Установите Ollama
curl -fsSL https://ollama.ai/install.sh | sh

# Скачайте модель
ollama pull llama3.1
ollama pull deepseek-coder-v2
ollama pull qwen2.5

# В config.json OpenClaw:
"llm": {
  "provider": "ollama",
  "baseUrl": "http://localhost:11434"
}

Связка Ollama + OpenClaw работает полностью локально. Учтите: для комфортной работы нужна видеокарта с минимум 8 ГБ VRAM или 16+ ГБ ОЗУ для CPU-режима.

DeepSeek и Qwen

Популярные модели DeepSeek и Qwen можно подключить двумя способами:

• Через OpenRouter — самый простой путь, модели уже доступны в каталоге
• Через Ollama — для локального запуска (ollama pull deepseek-coder-v2, ollama pull qwen2.5)
• Напрямую через API — для DeepSeek: api.deepseek.com, для Qwen: dashscope.aliyuncs.com

Claude и OpenAI

Для прямого доступа к Claude (Anthropic) или OpenAI нужен зарубежный API-ключ:

# Claude:
"llm": {
  "provider": "anthropic",
  "apiKey": "sk-ant-..."
}

# OpenAI:
"llm": {
  "provider": "openai",
  "apiKey": "sk-..."
}

Из России потребуется VPN или прокси для доступа к API. Альтернатива — подключить эти модели через OpenRouter без VPN.

4. Подключение Telegram

OpenClaw Telegram pairing — процесс привязки Telegram-бота к вашему агенту. Пошагово:

1. Откройте @BotFather в Telegram
2. Создайте нового бота: /newbot
3. Скопируйте токен (формат: 123456:ABC-DEF...)
4. Добавьте токен в config.json в секцию channels.telegram.botToken
5. Запустите или перезапустите gateway: openclaw gateway restart
6. Напишите боту в Telegram любое сообщение
7. Подтвердите pairing: openclaw pairing approve

После успешного pairing ваш Telegram-аккаунт будет добавлен в allowedSenders, и агент начнёт отвечать на ваши сообщения.

5. Частые ошибки и решения

"pairing required"

Ошибка openclaw pairing required означает, что агент получил сообщение от пользователя, которого не знает. Это защита от несанкционированного доступа.

Решение:

# Посмотрите список ожидающих pairing-запросов
openclaw pairing list

# Подтвердите нужный запрос
openclaw pairing approve

# Или подтвердите конкретного пользователя по ID
openclaw pairing approve --user telegram:123456789

"access not configured"

Ошибка openclaw access not configured говорит о том, что в конфигурации не указан список разрешённых отправителей.

Решение: добавьте раздел allowedSenders в config.json:

"allowedSenders": [
  "telegram:ваш_telegram_id"
]

Узнать свой Telegram ID можно через бота @userinfobot.

"openclaw: command not found"

Ошибка openclaw not found означает, что система не может найти исполняемый файл.

Решения:

• Проверьте, что установка прошла успешно: npm list -g openclaw
• Проверьте PATH: echo $PATH — должна быть директория с npm-бинарниками
• Узнайте, куда npm ставит глобальные пакеты: npm prefix -g
• Добавьте путь в PATH: export PATH="$(npm prefix -g)/bin:$PATH"
• Для постоянного сохранения добавьте эту строку в ~/.bashrc или ~/.zshrc

Gateway не запускается

Если OpenClaw gateway не стартует, проверьте:

• Порт занят: lsof -i :18789 — если порт занят другим процессом, остановите его или измените порт в config.json
• Токен не задан: убедитесь, что в config.json указан gateway.token. Без токена gateway откажется запускаться
• Права доступа: проверьте права на файл конфигурации и рабочую директорию
• Логи: запустите gateway в режиме отладки: openclaw gateway start --verbose

Gateway restart

Если gateway работает нестабильно или вы изменили конфигурацию, перезапустите его:

# Перезапуск gateway
openclaw gateway restart

# Если не помогает — остановите и запустите заново
openclaw gateway stop
openclaw gateway start

Другие проблемы

• Агент не отвечает в Telegram — проверьте, что gateway запущен (openclaw gateway status), токен бота корректен, и ваш Telegram ID есть в allowedSenders
• Модель не отвечает — проверьте API-ключ и доступ к провайдеру. Для Anthropic/OpenAI может потребоваться VPN
• Высокий расход токенов — настройте лимиты в config.json или используйте более дешёвые модели через OpenRouter

Не хочется разбираться? Попробуйте облако

Все описанные выше проблемы — установка, настройка PATH, подключение моделей, pairing, gateway — решены в облачной версии OpenClaw. На HelloWorld Cloud агент уже установлен, настроен и готов к работе. Модели подключены через OpenRouter без VPN, Telegram настраивается за 30 секунд из веб-интерфейса.