​

Docker (opcjonalnie)

​

Czy Docker jest dla mnie odpowiedni?

• Tak: chcesz mieć odizolowane, tymczasowe środowisko gatewaya albo uruchamiać OpenClaw na hoście bez lokalnych instalacji.
• Nie: uruchamiasz system na własnej maszynie i chcesz po prostu najszybszej pętli deweloperskiej. Zamiast tego użyj standardowego przepływu instalacji.
• Uwaga o sandboxingu: sandboxing agenta również używa Dockera, ale nie wymaga uruchamiania całego gatewaya w Dockerze. Zobacz Sandboxing.

​

Wymagania wstępne

• Docker Desktop (lub Docker Engine) + Docker Compose v2
• Co najmniej 2 GB RAM do budowania obrazu (pnpm install może zostać zakończone przez OOM na hostach z 1 GB z kodem wyjścia 137)
• Wystarczająca ilość miejsca na dysku na obrazy i logi
• Jeśli uruchamiasz na VPS/publicznym hoście, zapoznaj się z utwardzaniem zabezpieczeń przy ekspozycji sieciowej, zwłaszcza z polityką zapory DOCKER-USER w Dockerze.

​

Gateway w kontenerze

./scripts/docker/setup.sh

export OPENCLAW_IMAGE="ghcr.io/openclaw/openclaw:latest"
./scripts/docker/setup.sh

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

# WhatsApp (QR)
docker compose run --rm openclaw-cli channels login

# Telegram
docker compose run --rm openclaw-cli channels add --channel telegram --token "<token>"

# Discord
docker compose run --rm openclaw-cli channels add --channel discord --token "<token>"

​

Przepływ ręczny

docker build -t openclaw:local -f Dockerfile .
docker compose run --rm --no-deps --entrypoint node openclaw-gateway \
  dist/index.js onboard --mode local --no-install-daemon
docker compose run --rm --no-deps --entrypoint node openclaw-gateway \
  dist/index.js config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"},{"path":"gateway.controlUi.allowedOrigins","value":["http://localhost:18789","http://127.0.0.1:18789"]}]'
docker compose up -d openclaw-gateway

​

Zmienne środowiskowe

​

Kontrole stanu

curl -fsS http://127.0.0.1:18789/healthz   # żywotność
curl -fsS http://127.0.0.1:18789/readyz     # gotowość

docker compose exec openclaw-gateway node dist/index.js health --token "$OPENCLAW_GATEWAY_TOKEN"

​

LAN vs loopback

• lan (domyślnie): przeglądarka hosta i CLI hosta mogą osiągnąć opublikowany port gatewaya.
• loopback: tylko procesy wewnątrz przestrzeni nazw sieci kontenera mogą osiągnąć gateway bezpośrednio.

​

Przechowywanie i trwałość

• openclaw.json dla konfiguracji zachowania
• agents/<agentId>/agent/auth-profiles.json dla zapisanego uwierzytelniania OAuth/kluczem API providera
• .env dla sekretów runtime opartych na env, takich jak OPENCLAW_GATEWAY_TOKEN

​

Pomocniki shella (opcjonalnie)

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

export OPENCLAW_SANDBOX=1
./scripts/docker/setup.sh

export OPENCLAW_SANDBOX=1
export OPENCLAW_DOCKER_SOCKET=/run/user/1000/docker.sock
./scripts/docker/setup.sh

docker compose run -T --rm openclaw-cli gateway probe
docker compose run -T --rm openclaw-cli devices list --json

sudo chown -R 1000:1000 /path/to/openclaw-config /path/to/openclaw-workspace

FROM node:24-bookworm
RUN curl -fsSL https://bun.sh/install | bash
ENV PATH="/root/.bun/bin:${PATH}"
RUN corepack enable
WORKDIR /app
COPY package.json pnpm-lock.yaml pnpm-workspace.yaml .npmrc ./
COPY ui/package.json ./ui/package.json
COPY scripts ./scripts
RUN pnpm install --frozen-lockfile
COPY . .
RUN pnpm build
RUN pnpm ui:install
RUN pnpm ui:build
ENV NODE_ENV=production
CMD ["node","dist/index.js"]

​

Uruchamianie na VPS?

​

Sandbox agenta

• Sandboxing — pełne informacje o sandboxie
• OpenShell — interaktywny dostęp do powłoki w kontenerach sandboxa
• Multi-Agent Sandbox and Tools — nadpisania per agent

​

Szybkie włączenie

{
  agents: {
    defaults: {
      sandbox: {
        mode: "non-main", // off | non-main | all
        scope: "agent", // session | agent | shared
      },
    },
  },
}

scripts/sandbox-setup.sh

​

Rozwiązywanie problemów

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

docker compose run --rm openclaw-cli config set --batch-json '[{"path":"gateway.mode","value":"local"},{"path":"gateway.bind","value":"lan"}]'
docker compose run --rm openclaw-cli devices list --url ws://127.0.0.1:18789

​

Powiązane

• Przegląd instalacji — wszystkie metody instalacji
• Podman — alternatywa Podman dla Dockera
• ClawDock — społecznościowa konfiguracja Docker Compose
• Aktualizacja — utrzymywanie OpenClaw w aktualnym stanie
• Configuration — konfiguracja gatewaya po instalacji