Настройка Clawdbot на Linux

Обзор Clawdbot на Linux

Gateway Clawdbot полностью поддерживается на Linux. Node — рекомендуемая среда выполнения. Bun не рекомендуется для Gateway из-за багов с WhatsApp/Telegram.

Нативные приложения-компаньоны для Linux запланированы. Вклады приветствуются.

Быстрый путь для начинающих (VPS)

# Установить Node 22+
npm i -g clawdbot@latest
clawdbot onboard --install-daemon

С вашего ноутбука:

ssh -N -L 18789:127.0.0.1:18789 <user>@<host>

Откройте http://127.0.0.1:18789/ и вставьте ваш токен.

Установка

Смотрите основные руководства по установке:

• Начало работы
• Установка и обновления

Дополнительные варианты:

• Docker
• Nix

Установка службы Gateway (CLI)

Используйте один из этих методов:

# Вариант 1: Во время первичной настройки
clawdbot onboard --install-daemon

# Вариант 2: Прямая установка
clawdbot gateway install

# Вариант 3: Интерактивная настройка
clawdbot configure
# Выберите "Gateway service" при запросе

Восстановление/миграция:

clawdbot doctor

Управление системой (пользовательский юнит systemd)

Clawdbot по умолчанию устанавливает пользовательскую службу systemd. Используйте системную службу для общих или постоянно работающих серверов.

Минимальная настройка

Создайте ~/.config/systemd/user/clawdbot-gateway.service:

[Unit]
Description=Clawdbot Gateway
After=network-online.target
Wants=network-online.target

[Service]
ExecStart=/usr/local/bin/clawdbot gateway --port 18789
Restart=always
RestartSec=5

[Install]
WantedBy=default.target

Включите её:

systemctl --user enable --now clawdbot-gateway.service

Управление службой

# Проверить статус
systemctl --user status clawdbot-gateway

# Просмотр логов
journalctl --user -u clawdbot-gateway -f

# Перезапустить
systemctl --user restart clawdbot-gateway

# Остановить
systemctl --user stop clawdbot-gateway

Включить Lingering

Чтобы служба продолжала работать после выхода из системы:

sudo loginctl enable-linger $USER

Развёртывание на VPS

Для развёртывания на VPS смотрите подробные руководства:

• SSH-туннель для удалённого доступа
• Tailscale для безопасной сети
• Docker для контейнеризированного развёртывания

Базовая настройка VPS

1. Установите Clawdbot на ваш VPS
2. Настройте Gateway
3. Настройте SSH-туннель или Tailscale
4. Удалённый доступ к панели управления

Проверки работоспособности

clawdbot status
clawdbot health
clawdbot doctor

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

• Clawdbot macOS - Настройка macOS
• Clawdbot Windows - Настройка Windows WSL2
• Clawdbot Gateway - Настройка Gateway