Первая конфигурация OpenClaw

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

Шаг 1: Создание Telegram бота

1.1. Получение токена бота

Откройте Telegram и найдите @BotFather
Отправьте команду /newbot
Выберите имя бота (например, MyOpenClawBot)
Выберите username бота (должен заканчиваться на bot, например myopenclaw_bot)
Сохраните полученный токен:
1234567890:ABCdefGHIjklMNOpqrsTUVwxyz

1.2. Настройка бота

Рекомендуемые настройки в BotFather:

/setcommands - добавьте команды
/setuserpic - установите аватар
/setdescription - описание бота
/setabouttext - информация о боте

Шаг 2: Базовая конфигурация

2.1. Создание конфигурационного файла

Создайте файл ~/.openclaw/openclaw.json:

{
  // Безопасность: всегда используйте 127.0.0.1
  "gateway": {
    "bind": "127.0.0.1",
    "port": 18789
  },

  // Настройка Telegram канала
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "ВАШ_ТОКЕН_БОТА", // Замените на ваш токен
      "dmPolicy": "pairing", // Безопасный режим
      "allowFrom": ["tg:ВАШ_TELEGRAM_ID"], // Ваш ID
      "groups": {
        "*": {
          "requireMention": true // Отвечать только при упоминании
        }
      }
    }
  },

  // Настройки агента
  "agents": {
    "defaults": {
      "model": "openai/gpt-4" // Или другая модель
    }
  }
}

2.2. Получение вашего Telegram ID

Отправьте сообщение боту @userinfobot
Скопируйте ваш ID (число, например 336940264)
Используйте в формате tg:336940264

Шаг 3: Настройка API ключей

3.1. Создание файла моделей

Создайте ~/.openclaw/models.json:

{
  "openai": {
    "apiKey": "sk-ВАШ_OPENAI_КЛЮЧ",
    "models": {
      "gpt-4": {
        "maxTokens": 8192,
        "temperature": 0.7
      }
    }
  },
  "anthropic": {
    "apiKey": "sk-ant-ВАШ_ANTHROPIC_КЛЮЧ"
  }
}

3.2. Альтернатива: переменные окружения

# В ~/.bashrc или ~/.zshrc
export OPENAI_API_KEY="sk-..."
export ANTHROPIC_API_KEY="sk-ant-..."
export TELEGRAM_BOT_TOKEN="1234567890:ABC..."

# Или создайте .env файл
echo "OPENAI_API_KEY=sk-..." >> ~/.openclaw/.env
echo "TELEGRAM_BOT_TOKEN=1234567890:ABC..." >> ~/.openclaw/.env

Шаг 4: Запуск и проверка

4.1. Запуск шлюза

# Запуск в foreground (для тестирования)
openclaw gateway start

# Или как служба
openclaw gateway install
openclaw gateway start

4.2. Проверка статуса

openclaw gateway status

Ожидаемый вывод:

✅ Gateway running (pid: 12345)
📡 Bind: 127.0.0.1:18789
🔄 Channels: telegram (connected)

4.3. Проверка Telegram бота

Найдите вашего бота в Telegram
Отправьте /start
Вы должны получить pairing code
В терминале с запущенным OpenClaw появится запрос на подтверждение

Шаг 5: Дополнительные настройки безопасности

5.1. Ограничение доступа

Добавьте в конфигурацию:

{
  "commands": {
    "bash": false, // Отключить выполнение bash команд
    "config": false, // Отключить изменение конфигурации через чат
    "allowFrom": {
      "*": ["tg:ВАШ_TELEGRAM_ID"] // Только вы можете использовать команды
    }
  },

  "tools": {
    "elevated": {
      "enabled": true,
      "requireApproval": true, // Требовать подтверждение для опасных команд
      "allowFrom": {
        "telegram": ["tg:ВАШ_TELEGRAM_ID"]
      }
    }
  }
}

5.2. Настройка логов

{
  "logging": {
    "level": "info",
    "file": "~/.openclaw/logs/gateway.log",
    "maxSize": "10MB",
    "maxFiles": 5
  }
}

Шаг 6: Веб-панель управления

6.1. Доступ к Control UI

Откройте в браузере: http://127.0.0.1:18789

6.2. Настройка удаленного доступа

Внимание: Безопасный доступ только через Tailscale или VPN!

{
  "web": {
    "enabled": true,
    "bind": "127.0.0.1", // Не меняйте!
    "port": 18789,
    "auth": {
      "enabled": true,
      "username": "admin",
      "password": "strong_password" // Используйте сложный пароль
    }
  }
}

Шаг 7: Тестирование функционала

7.1. Проверка команд в Telegram

Отправьте боту:
- /help - список команд
- /status - статус системы
- /models - список доступных моделей

7.2. Проверка ответов

Отправьте сообщение:

Привет! Как дела?

Бот должен ответить (после pairing).

7.3. Проверка группового чата

Добавьте бота в группу
Упомяните бота: @myopenclaw_bot привет
Бот должен ответить

Шаг 8: Автоматизация запуска

8.1. Systemd служба (Linux)

# Создание службы
sudo tee /etc/systemd/system/openclaw.service << EOF
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=$USER
WorkingDirectory=$HOME
Environment="PATH=$HOME/.nvm/versions/node/v22.14.0/bin:$PATH"
ExecStart=$(which openclaw) gateway start
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

# Запуск службы
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw

8.2. Launchd (macOS)

Создайте ~/Library/LaunchAgents/com.user.openclaw.plist:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>com.user.openclaw</string>
    <key>ProgramArguments</key>
    <array>
        <string>/usr/local/bin/openclaw</string>
        <string>gateway</string>
        <string>start</string>
    </array>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
    <key>StandardOutPath</key>
    <string>/tmp/openclaw.log</string>
    <key>StandardErrorPath</key>
    <string>/tmp/openclaw-error.log</string>
</dict>
</plist>

Загрузите службу:

launchctl load ~/Library/LaunchAgents/com.user.openclaw.plist

Частые проблемы

❓ Бот не отвечает

Проверьте токен бота
Проверьте статус шлюза: openclaw gateway status
Проверьте логи: tail -f ~/.openclaw/logs/gateway.log

❓ "Pairing required"

Отправьте /start боту
Подтвердите pairing code в терминале
Если код не появляется, проверьте dmPolicy в конфигурации

❓ Бот не отвечает в группе

Убедитесь, что упомянули бота правильно
Проверьте настройки requireMention
Убедитесь, что бот добавлен в группу как администратор (рекомендуется)

❓ "Gateway not running"

# Перезапустите шлюз
openclaw gateway stop
openclaw gateway start

# Или убейте процесс
pkill -f "openclaw gateway"

Следующие шаги

После базовой настройки:

Конфигурационные файлы - подробное описание всех параметров
Безопасность - критически важные настройки безопасности
Другие каналы - подключение WhatsApp, Discord и других
Мульти-агенты - настройка нескольких агентов

Важно: Не забудьте прочитать руководство по безопасности перед использованием в production!

OpenClaw Docs

Первая конфигурация