ClawDock

ClawDock

ClawDock is a small shell-helper layer for Docker-based Velaclaw 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.

Install

Use the canonical helper path:

mkdir -p ~/.clawdock && curl -sL https://raw.githubusercontent.com/Zavianx/velaclaw/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.

What you get

Basic operations

Command	Description
clawdock-start	Start the gateway
clawdock-stop	Stop the gateway
clawdock-restart	Restart the gateway
clawdock-status	Check container status
clawdock-logs	Follow gateway logs

Container access

Command	Description
clawdock-shell	Open a shell inside the gateway container
clawdock-cli <command>	Run Velaclaw CLI commands in Docker
clawdock-exec <command>	Execute an arbitrary command in the container

Web UI and pairing

Command	Description
clawdock-dashboard	Open the Control UI URL
clawdock-devices	List pending device pairings
clawdock-approve <id>	Approve a pairing request

Setup and maintenance

Command	Description
clawdock-fix-token	Configure the gateway token inside the container
clawdock-update	Pull, rebuild, and restart
clawdock-rebuild	Rebuild the Docker image only
clawdock-clean	Remove containers and volumes

Utilities

Command	Description
clawdock-health	Run a gateway health check
clawdock-token	Print the gateway token
clawdock-cd	Jump to the Velaclaw project directory
clawdock-config	Open ~/.velaclaw
clawdock-show-config	Print config files with redacted values
clawdock-workspace	Open the workspace directory

First-time flow

clawdock-start
clawdock-fix-token
clawdock-dashboard

If the browser says pairing is required:

clawdock-devices
clawdock-approve <request-id>

Config and secrets

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
• ~/.velaclaw/.env for env-backed provider keys and bot tokens
• ~/.velaclaw/agents/<agentId>/agent/auth-profiles.json for stored provider OAuth/API-key auth
• ~/.Zavianx/velaclaw-dev.json for behavior config

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

Related pages

• Docker
• Docker VM Runtime
• Updating