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.

Install overview

Containers

Hosting

Maintenance

ClawDock

ClawDock

Install

What you get

Basic operations

Container access

Web UI and pairing

Setup and maintenance

Utilities

First-time flow

Config and secrets

​ClawDock

​Install

​What you get

​Basic operations

​Container access

​Web UI and pairing

​Setup and maintenance

​Utilities

​First-time flow

​Config and secrets

​Related pages

ClawDock

Install

What you get

Basic operations

Container access

Web UI and pairing

Setup and maintenance

Utilities

First-time flow

Config and secrets

Related pages