Установка Clawdbot через Docker

Обзор Clawdbot Docker

Docker является опциональным для Clawdbot. Используйте его только если вам нужен контейнеризированный шлюз или для проверки работы Docker.

Подходит ли мне Docker?

Примечание: Песочница агентов тоже использует Docker, но не требует запуска полного шлюза в Docker.

Требования

• Docker Desktop (или Docker Engine) + Docker Compose v2
• Достаточно дискового пространства для образов + логов

Контейнеризированный шлюз (Docker Compose)

Быстрый старт (Рекомендуется)

Из корня репозитория:

./docker-setup.sh

Этот скрипт:

1. Собирает образ шлюза
2. Запускает мастер начальной настройки
3. Выводит подсказки по настройке провайдеров
4. Запускает шлюз через Docker Compose
5. Генерирует токен шлюза и записывает его в .env

Опциональные переменные окружения:

После завершения:

1. Откройте http://127.0.0.1:18789/ в браузере
2. Вставьте токен в UI управления (Настройки → токен)

Нужен URL с токеном снова?

docker compose run --rm clawdbot-cli dashboard --no-open

Ручной процесс (Compose)

docker build -t clawdbot:local -f Dockerfile .
docker compose run --rm clawdbot-cli onboard
docker compose up -d clawdbot-gateway

Токен UI управления + Сопряжение (Docker)

Если вы видите "не авторизован" или "отключено (1008): требуется сопряжение":

docker compose run --rm clawdbot-cli dashboard --no-open
docker compose run --rm clawdbot-cli devices list
docker compose run --rm clawdbot-cli devices approve <requestId>

Дополнительные монтирования (Опционально)

Монтирование дополнительных каталогов хоста в контейнеры:

export CLAWDBOT_EXTRA_MOUNTS="$HOME/.codex:/home/node/.codex:ro,$HOME/github:/home/node/github:rw"
./docker-setup.sh

Сохранение Home контейнера (Опционально)

Сохранение /home/node при пересоздании контейнера:

export CLAWDBOT_HOME_VOLUME="clawdbot_home"
./docker-setup.sh

Установка дополнительных пакетов (Опционально)

Установка системных пакетов внутри образа:

export CLAWDBOT_DOCKER_APT_PACKAGES="ffmpeg build-essential"
./docker-setup.sh

Песочница агента (Docker-инструменты)

Clawdbot может использовать Docker для песочницы агентов, изолируя инструменты агентов в контейнерах.

Что это делает

• Запускает инструменты агентов (exec, browser и т.д.) в изолированных Docker-контейнерах
• Обеспечивает границы безопасности между агентами
• Позволяет использовать профили песочницы для каждого агента

Включение песочницы

В вашем clawdbot.json:

{
  "agents": {
    "defaults": {
      "sandbox": {
        "mode": "non-main"
      }
    }
  }
}

Сборка образа песочницы

clawdbot sandbox build

Профили песочницы для каждого агента

{
  "routing": {
    "agents": {
      "main": {
        "workspace": "~/.clawdbot/workspace",
        "sandbox": {
          "mode": "off"
        }
      },
      "untrusted": {
        "sandbox": {
          "mode": "always"
        }
      }
    }
  }
}

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

docker compose run --rm clawdbot-cli health
docker compose run --rm clawdbot-cli status

Устранение неполадок

Ошибки прав доступа (EACCES)

Если вы видите ошибки прав доступа, проверьте, что смонтированные каталоги имеют правильные разрешения.

Контейнер не запускается

1. Проверьте логи Docker: docker compose logs clawdbot-gateway
2. Убедитесь, что порт 18789 не занят
3. Убедитесь, что Docker имеет достаточно ресурсов

Проблемы с токеном

Перегенерируйте токен шлюза:

docker compose run --rm clawdbot-cli configure --reset-token

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

• Установка Clawdbot - Другие методы установки
• Шлюз Clawdbot - Настройка шлюза
• Настройка Clawdbot - Полное руководство по настройке