Skip to content

ClawDock

ClawDock is a small shell-helper layer for Docker-based OpenClaw installs.

It gives you short commands like clawdock-start, clawdock-dashboard, and clawdock-fix-token instead of longer docker compose ... invocations.

If you have not set up Docker yet, start with Docker.

Use the canonical helper path:

Terminal window
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

If you previously installed ClawDock from scripts/shell-helpers/clawdock-helpers.sh, reinstall from the new scripts/clawdock/clawdock-helpers.sh path. The old raw GitHub path was removed.

CommandDescription
clawdock-startStart the gateway
clawdock-stopStop the gateway
clawdock-restartRestart the gateway
clawdock-statusCheck container status
clawdock-logsFollow gateway logs
CommandDescription
clawdock-shellOpen a shell inside the gateway container
clawdock-cli <command>Run OpenClaw CLI commands in Docker
clawdock-exec <command>Execute an arbitrary command in the container
CommandDescription
clawdock-dashboardOpen the Control UI URL
clawdock-devicesList pending device pairings
clawdock-approve <id>Approve a pairing request
CommandDescription
clawdock-fix-tokenConfigure the gateway token inside the container
clawdock-updatePull, rebuild, and restart
clawdock-rebuildRebuild the Docker image only
clawdock-cleanRemove containers and volumes
CommandDescription
clawdock-healthRun a gateway health check
clawdock-tokenPrint the gateway token
clawdock-cdJump to the OpenClaw project directory
clawdock-configOpen ~/.openclaw
clawdock-show-configPrint config files with redacted values
clawdock-workspaceOpen the workspace directory
Terminal window
clawdock-start
clawdock-fix-token
clawdock-dashboard

If the browser says pairing is required:

Terminal window
clawdock-devices
clawdock-approve <request-id>

ClawDock works with the same Docker config split described in Docker:

  • <project>/.env for Docker-specific values like image name, ports, and the gateway token
  • ~/.openclaw/.env for provider keys and bot tokens
  • ~/.openclaw/openclaw.json for behavior config

Use clawdock-show-config when you want to inspect those files quickly. It redacts .env values in its printed output.