← Назад

openclaw-install

🔐 Войти для редактирования

Установка и настройка OpenClaw на Ubuntu 24.04

Что такое OpenClaw

OpenClaw — это персональный AI-ассистент с доступом к файлам, терминалу, мессенджерам и инструментам. Работает локально на вашем сервере, поддерживает разные модели (Ollama, OpenAI, Anthropic и др.).


Шаг 1 — Требования


Шаг 2 — Установка Node.js

# Установка Node 24 (рекомендуется)
curl -fsSL https://deb.nodesource.com/setup_24.x | sudo -E bash -
sudo apt-get install -y nodejs

# Проверка
node -v   # должно быть v24.15.0 или новее
npm -v

Шаг 3 — Установка OpenClaw

Вариант A — Установочный скрипт (рекомендуется)

# Установка с запуском onboarding
curl -fsSL https://openclaw.ai/install.sh | bash

# Или без onboarding (для автоматизации)
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --no-onboard

Скрипт сам:
- Установит Node если нужно
- Установит OpenClaw через npm
- Запустит onboarding (настройка)

Вариант B — Через npm вручную

# Настройка папки для глобальных пакетов (чтобы без sudo)
mkdir -p "$HOME/.npm-global"
npm config set prefix "$HOME/.npm-global"

# Добавить в PATH
echo 'export PATH="$HOME/.npm-global/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

# Установка
npm install -g openclaw@latest
openclaw onboard --install-daemon

Вариант C — Локальная установка в ~/.openclaw

curl -fsSL https://openclaw.ai/install-cli.sh | bash

Всё ставится в ~/.openclaw, не требует system-wide Node.


Шаг 4 — Проверка установки

openclaw --version       # версия установлена
openclaw doctor           # проверка конфигурации
openclaw gateway status   # шлюз запущен?

Шаг 5 — Onboarding (первичная настройка)

Если onboarding не запускался автоматически:

openclaw onboard

Во время onboarding:
1. Выбор модели — укажите провайдера (Ollama, OpenAI, Anthropic и т.д.)
2. API ключ — введите ключ если нужен (для OpenAI/Anthropic)
3. Telegram — можно подключить бот для общения через Telegram
4. Демон — установите как systemd-сервис для автозапуска


Шаг 6 — Настройка модели

Ollama (локальная модель, бесплатно)

# Установка Ollama
curl -fsSL https://ollama.com/install.sh | bash

# Загрузка модели
ollama pull llama3.2    # или другая модель

# В config OpenClaw укажите:
# model: ollama/llama3.2
# ollama baseUrl: http://127.0.0.1:11434

OpenAI / Anthropic / другие

В onboarding выберите провайдера и введите API-ключ.


Шаг 7 — Подключение Telegram

  1. Создайте бота через @BotFather в Telegram:
    - Отправьте /newbot
    - Задайте имя и username
    - Получите BOT_TOKEN

  2. Узнайте свой Telegram ID:
    - Напишите @userinfobot → получите числовой ID

  3. Настройте в OpenClaw:
    bash openclaw config
    Или через конфиг-файл:
    yaml channels: telegram: botToken: "ВАШ_BOT_TOKEN" authorizedSenders: - "ВАШ_TELEGRAM_ID"

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

  5. Напишите боту в Telegram — он должен ответить.


Шаг 8 — Настройка шлюза как сервиса

# Установка как systemd-сервис (автозапуск)
openclaw onboard --install-daemon

# Или вручную
openclaw gateway install

Проверка:

openclaw gateway status    # статус
openclaw gateway restart   # перезапуск
openclaw gateway stop      # остановка
openclaw gateway start     # запуск

Шаг 9 — Рабочая папка (workspace)

Рабочая папка по умолчанию: ~/.openclaw/workspace/

Ключевые файлы:
- AGENTS.md — инструкции для ассистента (поведение, правила)
- SOUL.md — личность, тон, характер
- USER.md — информация о пользователе
- MEMORY.md — долгосрочная память ассистента
- TOOLS.md — заметки о локальных инструментах
- memory/ — ежедневные заметки (memory/YYYY-MM-DD.md)

Отредактируйте их под себя:

cd ~/.openclaw/workspace/
nano AGENTS.md    # правила поведения
nano SOUL.md     # личность
nano USER.md      # ваше имя, часовой пояс, язык

Шаг 10 — Настройка конфигурации

Основной конфиг: ~/.openclaw/config.yaml

Просмотр текущей конфигурации:

openclaw config

Ключевые настройки:

# Модель
model: ollama/llama3.2

# Провайдер Ollama
providers:
  ollama:
    baseUrl: http://127.0.0.1:11434

# Таймаут (важно для медленных моделей!)
timeoutSeconds: 300

# Порт шлюза
gateway:
  port: 18789
  host: 127.0.0.1   # только локальный доступ

# Telegram
channels:
  telegram:
    botToken: "ТОКЕН"
    authorizedSenders:
      - "ID_ПОЛЬЗОВАТЕЛЯ"

После изменений:

openclaw gateway restart

Шаг 11 — Таймауты (важно!)

Если модель отвечает медленно (особенно локальная Ollama), увеличьте таймаут:

# В config.yaml
timeoutSeconds: 300   # 5 минут

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


Шаг 12 — Память ассистента

OpenClaw хранит память в двух уровнях:

Дневные заметки: ~/.openclaw/workspace/memory/YYYY-MM-DD.md
- Создаются каждый день автоматически
- Хранят что произошло в течение дня

Долговременная память: ~/.openclaw/workspace/MEMORY.md
- Кураторская выборка важного
- Обновляется ассистентом периодически

Индексация памяти:

openclaw memory index --force    # пересобрать индекс
openclaw memory status            # статус индекса

Шаг 13 — Бекапы

# Ручной бекап
openclaw backup

# Автоматический бекап (в config.yaml)
backups:
  enabled: true
  schedule: "0 6 * * *"    # каждый день в 06:00
  keepCopies: 5             # хранить 5 копий

Бекапы хранятся в ~/.openclaw/backups/.


Шаг 14 — Логи и диагностика

# Логи шлюза
openclaw gateway logs

# Проверка состояния
openclaw doctor

# Статус
openclaw status

# Подробные логи systemd
journalctl -u openclaw-gateway -f --no-pager

Шаг 15 — Обновление

# Обновить OpenClaw
openclaw update

# Или через npm
npm update -g openclaw

# Проверить версию
openclaw --version

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

openclaw: command not found

# Проверить PATH
npm prefix -g
echo $PATH

# Добавить глобальные пакеты в PATH
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

Таймауты при ответах

# Увеличить timeoutSeconds в config.yaml
timeoutSeconds: 300

Telegram-бот не отвечает

# Проверить токен и ID
openclaw config

# Проверить логи
openclaw gateway logs

# Перезапустить
openclaw gateway restart

Ollama не отвечает

# Проверить что Ollama запущена
systemctl status ollama

# Проверить порт
curl http://127.0.0.1:11434/api/tags

# Перезапустить
sudo systemctl restart ollama

Шлюз не запускается

# Проверить конфиг
openclaw doctor

# Проверить порт не занят
ss -tlnp | grep 18789

# Логи
journalctl -u openclaw-gateway --no-pager -n 50

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

openclaw status              # общий статус
openclaw doctor              # диагностика
openclaw gateway status      # статус шлюза
openclaw gateway restart     # перезапуск
openclaw config              # конфигурация
openclaw memory index --force  # пересобрать память
openclaw backup              # ручной бекап
openclaw --version           # версия
openclaw update              # обновление

Структура папок

~/.openclaw/
├── config.yaml          # основной конфиг
├── workspace/           # рабочая папка
│   ├── AGENTS.md        # правила ассистента
│   ├── SOUL.md          # личность
│   ├── USER.md          # информация о пользователе
│   ├── MEMORY.md        # долгосрочная память
│   ├── TOOLS.md         # локальные инструменты
│   ├── memory/          # дневные заметки
│   └── scripts/         # скрипты
├── backups/             # бекапы
└── plugins/             # плагины