Как проявляется
При запуске мастера настройки выводится сообщение об ошибке подключения к systemd user bus и пропуске установки сервиса.
Из-за чего возникает
Ошибка связана с отсутствием пользовательской systemd сессии и переменных окружения $DBUS_SESSION_BUS_ADDRESS и $XDG_RUNTIME_DIR, которые не определены при запуске через su/sudo без полноценной сессии.
Как исправить
- Установите пакет для поддержки пользовательских сессий systemd:
sudo apt install -y dbus-user-session
- Включите lingering для вашего пользователя (замените ubuntu на имя пользователя):
sudo loginctl enable-linger ubuntu
- Проверьте, что пользовательская systemd сессия запущена:
systemctl --user status
- Если вы подключаетесь через su или sudo, используйте вместо них ssh или machinectl для полноценной сессии:
sudo machinectl shell ubuntu@.host
systemctl --user status
Или
ssh ubuntu@localhost
systemctl --user status
- В качестве временного обхода можно вручную экспортировать переменную окружения:
sudo -iu ubuntu
export XDG_RUNTIME_DIR="/run/user/$(id -u)"
systemctl --user status
- Для запуска шлюза вручную (обход systemd):
clawdbot gateway run
- (Опционально) Запускайте в screen, чтобы процесс не завершался при выходе:
screen -R clawdbot
clawdbot gateway run
- Можно создать собственный systemd unit файл для запуска сервиса как системного:
[Unit]
Description=Clawdbot Gateway
After=network-online.target
Wants=network-online.target
[Service]
User=ваш_пользователь
WorkingDirectory=/путь/к/директории
ExecStart=/путь/к/clawdbot gateway --port 18789
Restart=always
RestartSec=5
[Install]
WantedBy=multi-user.target
- Запустите и включите этот сервис через systemctl:
sudo systemctl daemon-reload
sudo systemctl enable --now имя_сервиса.service
Обратите внимание, что текущий мастер настройки не устанавливает systemd сервис корректно из-за описанной проблемы.
Как не столкнуться снова
Используйте полноценные пользовательские сессии при работе с systemd —user, включайте lingering для пользователя и устанавливайте dbus-user-session.
Источник
Разбор основан на обсуждении в репозитории проекта: issue #1818.
Другие типичные проблемы — в разделе ошибок и решений, а базовая настройка разобрана в первом запуске.