Установка на свой компьютер

Быстрый старт описывает готовый облачный сервис Neria.Cloud — там ничего устанавливать не нужно. Эта страница — для тех, кто хочет вместо этого развернуть агента на своём сервере и управлять им самостоятельно. В таком варианте нужен свой собственный доступ к AI-модели (шлюз/ключ), в отличие от облачного сервиса, где доступ к AI уже включён в подписку.

Требования

Linux или macOS с установленным Docker (и плагином docker compose), ~10 ГБ свободного места и 4 ГБ RAM.

Установите nb

nb — утилита, которая разворачивает и обслуживает агента. См. Утилиту nb для установки.

Соберите три значения

1. Токен Telegram-бота — напишите @BotFather в Telegram, отправьте /newbot и следуйте инструкциям.
2. Свой Telegram ID — напишите @userinfobot, он пришлёт числовой ID.
3. URL и ключ AI-шлюза — адрес и API-ключ вашего AI-провайдера.

Создайте config.yaml

ai:
  gateway:
    url: https://gateway.example.com/v1
    api_key: sk-ваш-ключ
    model: agent-default
users:
  me:
    telegram: "ваш-telegram-id"
openclaw:
  workspaces:
    - id: default
      owner: me
      channels:
        telegram:
          bot_token: "токен-от-botfather"

Запустите агента

./nb agent run --config config.yaml

Первый запуск займёт несколько минут — агент скачает образ и настроит инструменты. Затем напишите своему боту в Telegram /status или просто «привет».

Автозапуск как сервис

Чтобы агент запускался сам после перезагрузки или входа в систему — вместо разового запуска командой выше:

# Ноутбук — сервис стартует при входе в систему:
./nb agent install --config config.yaml --scope login

# Постоянный сервер — сервис стартует при загрузке ОС (нужен root):
sudo ./nb agent install --config config.yaml --scope boot

На Linux это системный или пользовательский systemd-юнит, на macOS — launchd-агент. --scope boot на Linux дополнительно выделяет постоянное хранилище на loopback-файле ext4 с квотой (resources.data_size_gib в конфигурации).

Несколько рабочих пространств

Один агент может обслуживать несколько ботов сразу — для этого в config.yaml описывается несколько openclaw.workspaces[], у каждого свой bot_token и список пользователей:

users:
  alice:
    telegram: "626711000"
openclaw:
  workspaces:
    - id: default
      owner: alice
      channels:
        telegram:
          bot_token: ${BOT_DEFAULT}
    - id: work
      owner: alice
      channels:
        telegram:
          bot_token: ${BOT_WORK}

Секреты — только через ${ENV}-ссылки или переменные окружения, никогда через флаги командной строки.

AI-шлюз за приватным CA

Если шлюз находится за собственным корневым сертификатом:

security:
  host_ca: true   # довериться сертификатам хоста
  # либо: ca_cert: /path/to/cert.pem

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

nb agent status --dir <каталог-агента>