🚀 Быстрый старт с OpenClaw

Установите и настройте OpenClaw за 5 минут с помощью этого руководства.

Шаг 1: Установка OpenClaw

Вариант A: Установка через npm (рекомендуется)

# Установите Node.js 18+ если еще не установлен
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt-get install -y nodejs

# Установите OpenClaw глобально
npm install -g openclaw

# Проверьте установку
openclaw --version

Вариант B: Установка через Docker

# Создайте директорию для конфигурации
mkdir -p ~/.openclaw

# Запустите OpenClaw в Docker
docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v ~/.openclaw:/root/.openclaw \
  -e NODE_ENV=production \
  ghcr.io/openclaw/openclaw:latest

Вариант C: Установка из исходников

# Клонируйте репозиторий
git clone https://github.com/openclaw/openclaw.git
cd openclaw

# Установите зависимости
npm install

# Соберите проект
npm run build

# Установите глобально
npm link

Шаг 2: Первоначальная конфигурация

Создайте базовый конфигурационный файл:

# Создайте директорию для конфигурации
mkdir -p ~/.openclaw

# Создайте минимальный конфиг
cat > ~/.openclaw/openclaw.json << 'EOF'
{
  "gateway": {
    "bind": "127.0.0.1",
    "port": 18789
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "pairing"
    }
  }
}
EOF

Настройте переменные окружения:

# Добавьте в ~/.bashrc или ~/.zshrc
export TELEGRAM_BOT_TOKEN="ваш_токен_бота"
export OPENAI_API_KEY="sk-ваш_ключ_api"

# Примените изменения
source ~/.bashrc

Шаг 3: Запуск шлюза

Запустите шлюз OpenClaw:

# Запустите в фоновом режиме
openclaw gateway start

# Или запустите в терминале
openclaw gateway run

Проверьте статус:

# Проверьте статус шлюза
openclaw gateway status

# Посмотрите логи
tail -f ~/.openclaw/logs/gateway.log

Шаг 4: Настройка Telegram бота

1. Создайте бота через @BotFather:

• Отправьте /newbot
• Выберите имя (например, MyOpenClaw Assistant)
• Сохраните токен

2. Получите ваш Telegram ID:

# Используйте @userinfobot или
curl -s "https://api.telegram.org/botВАШ_ТОКЕН/getMe"

3. Обновите конфигурацию:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "pairing",
      "allowFrom": ["tg:ВАШ_ID"]
    }
  }
}

4. Перезапустите шлюз:

openclaw gateway restart

Шаг 5: Первое подключение

1. Отправьте /start вашему боту

2. Получите pairing code в терминале

3. Подтвердите подключение

4. Начните общение!

Шаг 6: Базовая проверка

Проверьте работоспособность:

# Проверьте здоровье системы
curl http://127.0.0.1:18789/health

# Проверьте доступные команды
openclaw --help

# Проверьте список каналов
openclaw channels list

Шаг 7: Добавление навыков

Установите базовые навыки:

# Установите навык для работы с GitHub
openclaw skills install github

# Установите навык для работы с терминалом
openclaw skills install terminal

# Установите навык для погоды
openclaw skills install weather

Настройте навыки в конфигурации:

{
  "skills": {
    "github": {
      "enabled": true,
      "token": "${GITHUB_TOKEN}"
    },
    "weather": {
      "enabled": true,
      "apiKey": "${WEATHER_API_KEY}"
    }
  }
}

Шаг 8: Расширенная настройка

Добавьте дополнительные каналы:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "allowlist",
      "allowFrom": ["tg:ВАШ_ID"]
    },
    "discord": {
      "enabled": true,
      "botToken": "${DISCORD_BOT_TOKEN}",
      "guildId": "ВАШ_GUILD_ID",
      "dmPolicy": "pairing"
    }
  }
}

Настройте безопасность:

{
  "security": {
    "bind": "127.0.0.1",
    "requireAuth": true,
    "maxConnections": 10
  },
  "commands": {
    "bash": false,
    "config": false,
    "allowFrom": {
      "*": ["tg:ВАШ_ID"]
    }
  }
}

Шаг 9: Мониторинг и обслуживание

Создайте скрипт для автоматического обновления:

#!/bin/bash
# update-openclaw.sh
echo "Обновление OpenClaw..."
npm update -g openclaw
openclaw gateway restart
echo "OpenClaw обновлен!"

Настройте автоматический перезапуск:

# Создайте systemd сервис
sudo nano /etc/systemd/system/openclaw.service

# Добавьте:
[Unit]
Description=OpenClaw Gateway
After=network.target

[Service]
Type=simple
User=$USER
Environment="TELEGRAM_BOT_TOKEN=ваш_токен"
Environment="OPENAI_API_KEY=ваш_ключ"
ExecStart=/usr/bin/openclaw gateway run
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target

Шаг 10: Решение проблем

Частые проблемы и решения:

❌ "Gateway not running"

# Проверьте порт
sudo netstat -tlnp | grep 18789

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

❌ "Pairing required"

1. Отправьте /start боту
2. Подтвердите код в терминале
3. Проверьте dmPolicy в конфигурации

❌ "Invalid token"

1. Проверьте токен: echo $TELEGRAM_BOT_TOKEN
2. Обновите токен в BotFather
3. Перезапустите шлюз

Примеры использования

Пример 1: Личный помощник

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "pairing",
      "allowFrom": ["tg:336940264"],
      "systemPrompt": "Ты мой персональный помощник. Помогай с задачами, напоминаниями и поиском информации."
    }
  },
  "skills": ["calendar", "weather", "github"]
}

Пример 2: Командный бот

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "groups": {
        "-1001234567890": {
          "requireMention": true,
          "allowFrom": ["@team_lead", "@dev1", "@dev2"],
          "systemPrompt": "Ты помощник команды разработки. Помогай с кодом, деплоем и мониторингом."
        }
      }
    }
  },
  "skills": ["github", "terminal", "docker"]
}

Пример 3: Production конфигурация

{
  "gateway": {
    "bind": "127.0.0.1",
    "port": 18789,
    "logLevel": "info"
  },
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "${TELEGRAM_BOT_TOKEN}",
      "dmPolicy": "allowlist",
      "allowFrom": ["tg:336940264", "tg:987654321"],
      "groups": {
        "*": {
          "requireMention": true,
          "allowFrom": ["@admin"]
        }
      }
    }
  },
  "security": {
    "commands": {
      "bash": false,
      "config": false
    }
  }
}

Дальнейшие шаги

Что делать после настройки:

1. Изучите документацию: openclaw --help
2. Добавьте больше каналов: WhatsApp, Discord, Slack
3. Установите дополнительные навыки: openclaw skills list
4. Настройте мониторинг: логи, метрики, алерты
5. Присоединитесь к сообществу: Discord OpenClaw

Полезные команды

# Основные команды
openclaw --help                    # Справка
openclaw gateway status            # Статус шлюза
openclaw channels list             # Список каналов
openclaw skills list               # Список навыков

# Управление
openclaw gateway start             # Запустить шлюз
openclaw gateway stop              # Остановить шлюз
openclaw gateway restart           # Перезапустить шлюз

# Конфигурация
openclaw config show               # Показать конфигурацию
openclaw config validate           # Проверить конфигурацию
openclaw config backup             # Создать бэкап конфигурации

# Отладка
openclaw doctor                    # Диагностика системы
tail -f ~/.openclaw/logs/*.log     # Просмотр логов

Ресурсы

• Официальная документация
• GitHub репозиторий
• Сообщество Discord
• Примеры конфигураций

Совет: Начните с минимальной конфигурации и постепенно добавляйте функциональность по мере необходимости.