> ## Documentation Index
> Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# ClawDock

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

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

Если вы ещё не настроили Docker, начните с раздела [Docker](https://docs2.openclaw.ai/ru/install/docker.md).

## Установка

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/openclaw/openclaw/main/scripts/clawdock/clawdock-helpers.sh -o ~/.clawdock/clawdock-helpers.sh
echo '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 theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawdock-start
clawdock-fix-token
clawdock-dashboard
```

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

```bash theme={"theme":{"light":"min-light","dark":"min-dark"}}
clawdock-devices
clawdock-approve <request-id>
```

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

ClawDock считывает два отдельных файла `.env` в соответствии с разделением, описанным в разделе [Docker](https://docs2.openclaw.ai/ru/install/docker.md):

* Проектный файл `.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` скрываются.

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

> [card] [Docker](https://docs2.openclaw.ai/ru/install/docker.md)
>
> Канонический способ установки OpenClaw с помощью Docker.

> [card] [Среда выполнения виртуальной машины Docker](https://docs2.openclaw.ai/ru/install/docker-vm-runtime.md)
>
> Управляемая Docker среда выполнения виртуальной машины с усиленной изоляцией.

> [card] [Обновление](https://docs2.openclaw.ai/ru/install/updating.md)
>
> Обновление пакета OpenClaw и управляемых служб.