Containers

ClawDock

ClawDock — это небольшой слой вспомогательных shell-команд для установок OpenClaw на базе Docker.

Он предоставляет короткие команды, такие как clawdock-start, clawdock-dashboard и clawdock-fix-token, вместо более длинных вызовов docker compose ....

Если вы ещё не настроили Docker, начните с раздела Docker.

Установка

bash
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.shecho 'source ~/.clawdock/clawdock-helpers.sh' >> ~/.zshrc && source ~/.zshrc

Если ранее вы устанавливали ClawDock из scripts/shell-helpers/clawdock-helpers.sh, переустановите его из текущего пути scripts/clawdock/clawdock-helpers.sh; старый прямой путь GitHub был удалён.

При первом использовании вспомогательные команды автоматически определяют расположение вашей рабочей копии OpenClaw (проверяя распространённые пути, такие как ~/openclaw и ~/projects/openclaw) и сохраняют результат в ~/.clawdock/config. Если рабочая копия находится в другом месте, задайте CLAWDOCK_DIR самостоятельно.

Доступные возможности

Основные операции

Команда Описание
clawdock-start Запустить Gateway
clawdock-stop Остановить Gateway
clawdock-restart Перезапустить Gateway
clawdock-status Проверить состояние контейнера
clawdock-logs Отслеживать журналы Gateway

Доступ к контейнеру

Команда Описание
clawdock-shell Открыть оболочку внутри контейнера Gateway
clawdock-cli <command> Выполнить команды CLI OpenClaw в Docker
clawdock-exec <command> Выполнить произвольную команду в контейнере

Веб-интерфейс и сопряжение

Команда Описание
clawdock-dashboard Открыть URL интерфейса управления
clawdock-devices Показать ожидающие сопряжения устройств
clawdock-approve <id> Одобрить запрос на сопряжение

Настройка и обслуживание

Команда Описание
clawdock-fix-token Записать токен Gateway в конфигурацию контейнера
clawdock-update Загрузить изменения, пересобрать и перезапустить
clawdock-rebuild Только пересобрать образ Docker
clawdock-clean Удалить контейнеры и тома

Утилиты

Команда Описание
clawdock-health Проверить работоспособность Gateway
clawdock-token Вывести токен Gateway
clawdock-cd Перейти в каталог проекта OpenClaw
clawdock-config Открыть ~/.openclaw
clawdock-show-config Вывести файлы конфигурации со скрытыми значениями
clawdock-workspace Открыть каталог рабочего пространства
clawdock-help Показать все команды ClawDock

Первый запуск

bash
clawdock-startclawdock-fix-tokenclawdock-dashboard

Если браузер сообщает, что требуется сопряжение:

bash
clawdock-devicesclawdock-approve <request-id>

Конфигурация и секреты

ClawDock считывает два отдельных файла .env в соответствии с разделением, описанным в разделе Docker:

  • Проектный файл .env рядом с docker-compose.yml: специфичные для Docker значения, такие как имя образа, порты и OPENCLAW_GATEWAY_TOKEN. clawdock-token считывает токен отсюда.
  • ~/.openclaw/.env (подключается к контейнеру): секреты на основе переменных среды, которыми управляет сам OpenClaw, вместе с openclaw.json и agents/<agentId>/agent/auth-profiles.json.

clawdock-fix-token копирует токен из проектного файла .env в значения конфигурации gateway.remote.token и gateway.auth.token контейнера, а затем перезапускает Gateway.

Используйте clawdock-show-config, чтобы быстро проверить openclaw.json и оба файла .env; в выводе значения .env скрываются.

Связанные материалы

Was this useful?
On this page

On this page