You cannot select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
gpt-pilot/scripts
Daniel Olshansky 31f616d45b
feat: `ClawDock` - shell docker helpers for OpenClaw development (#12817)
Discussion: https://github.com/openclaw/openclaw/discussions/13528

## Checklist

- [x] **Mark as AI-assisted in the PR title or description** - Implemented by 🤖, reviewed by 👨‍💻 
- [x] **Note the degree of testing** - fully tested and I use it myself
- [x] **Include prompts or session logs if possible (super helpful!)** - I can try doing a "resume" on a few sessions, but don't think it'll provide value. Lmk if this is a blocker.
- [x] **Confirm you understand what the code does** - It's simple :)

## Summary of changes

- **ClawDock** - Shell helpers replace verbose `docker-compose` commands with simple `clawdock-*` shortcuts
- **Zero-config setup** - First run auto-detects the OpenClaw project directory from common paths and saves the config for future use
- **No extra dependencies** - Just bash
- **Built-in auth & device pairing helpers** - `clawdock-fix-token`, `clawdock-dashboard`, etc to handle gateay setup, streamline web UI, etc...
- **Updated Docker docs** - Installation docs now include the optional ClawDock helper setup for users who want simplified container management

## Example Usage

```bash
$ clawdock-help

🦞 ClawDock - Docker Helpers for OpenClaw

⚡ Basic Operations
  clawdock-start       Start the gateway
  clawdock-stop        Stop the gateway
  clawdock-restart     Restart the gateway
  clawdock-status      Check container status
  clawdock-logs        View live logs (follows)

🐚 Container Access
  clawdock-shell       Shell into container (openclaw alias ready)
  clawdock-cli         Run CLI commands (e.g., clawdock-cli status)
  clawdock-exec <cmd>  Execute command in gateway container

🌐 Web UI & Devices
  clawdock-dashboard   Open web UI in browser (auto-guides you)
  clawdock-devices     List device pairings (auto-guides you)
  clawdock-approve <id> Approve device pairing (with examples)

⚙️  Setup & Configuration
  clawdock-fix-token   Configure gateway token (run once)

🔧 Maintenance
  clawdock-rebuild     Rebuild Docker image
  clawdock-clean       ⚠️  Remove containers & volumes (nuclear)

🛠️  Utilities
  clawdock-health      Run health check
  clawdock-token       Show gateway auth token
  clawdock-cd          Jump to openclaw project directory
  clawdock-config      Open config directory (~/.openclaw)
  clawdock-workspace   Open workspace directory

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
🚀 First Time Setup
  1. clawdock-start          # Start the gateway
  2. clawdock-fix-token      # Configure token
  3. clawdock-dashboard      # Open web UI
  4. clawdock-devices        # If pairing needed
  5. clawdock-approve <id>   # Approve pairing

💬 WhatsApp Setup
  clawdock-shell
    > openclaw channels login --channel whatsapp
    > openclaw status

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

💡 All commands guide you through next steps!
📚 Docs: https://docs.openclaw.ai
```\n\nCo-authored-by: Gustavo Madeira Santana <gumadeiras@gmail.com>
9 months ago
..
dev Gateway/Plugins: device pairing + phone control plugins (#11755) 10 months ago
docker chore: apply local workspace updates (#9911) 10 months ago
docs-i18n Docs i18n: make translation prompt language-pluggable 10 months ago
e2e fix(docker): support .mjs entrypoints in images and e2e 10 months ago
pre-commit chore: stabilize prek hooks runner selection (#1720) (thanks @dguido) 10 months ago
repro fix: run cli scripts via node build runner 10 months ago
shell-helpers feat: `ClawDock` - shell docker helpers for OpenClaw development (#12817) 9 months ago
systemd refactor: rename to openclaw 10 months ago
analyze_code_files.py Improve code analyzer for independent packages, CI: only run release-check on push to main 10 months ago
auth-monitor.sh refactor: rename to openclaw 10 months ago
bench-model.ts chore: apply local workspace updates (#9911) 10 months ago
build-and-run-mac.sh refactor: rename to openclaw 10 months ago
build-docs-list.mjs chore: Enable linting in `scripts`. 10 months ago
build_icon.sh refactor: rename to openclaw 10 months ago
bundle-a2ui.sh Docker: include A2UI sources for bundle (#13114) 10 months ago
canvas-a2ui-copy.ts chore: Also format `scripts` and `skills`. 10 months ago
changelog-to-html.sh refactor: rename to openclaw 10 months ago
check-ts-max-loc.ts chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts. 10 months ago
claude-auth-status.sh refactor: rename to openclaw 10 months ago
clawlog.sh refactor: rename to openclaw 10 months ago
clawtributors-map.json 🤖 Feishu: expand channel support 10 months ago
codesign-mac-app.sh refactor: rename to openclaw 10 months ago
committer chore: block node_modules commits 10 months ago
copy-hook-metadata.ts fix: all bundled hooks broken since 2026.2.2 (tsdown migration) (#9295) 10 months ago
create-dmg.sh refactor: rename to openclaw 10 months ago
debug-claude-usage.ts chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts. 10 months ago
docs-link-audit.mjs fix: docs broken links and improve link checker (#13056) 10 months ago
docs-list.js chore: Enable linting in `scripts`. 10 months ago
firecrawl-compare.ts chore: Enable linting in `scripts`. 10 months ago
ios-team-id.sh chore(ios): add team id helper 11 months ago
make_appcast.sh refactor: rename to openclaw 10 months ago
mobile-reauth.sh refactor: rename to openclaw 10 months ago
notarize-mac-artifact.sh refactor: rename to openclaw 10 months ago
package-mac-app.sh fix: Fix Mac app build step. 10 months ago
package-mac-dist.sh chore: add mac dSYM zip to release artifacts 10 months ago
protocol-gen-swift.ts chore: Enable linting in `scripts`. 10 months ago
protocol-gen.ts refactor: rename to openclaw 10 months ago
readability-basic-compare.ts chore: Enable linting in `scripts`. 10 months ago
release-check.ts fix(docker): support .mjs entrypoints in images and e2e 10 months ago
restart-mac.sh Switch from TypeScript to TypeScript Go. Use `pnpm tsgo` for Typechecks. 10 months ago
run-node.mjs Update: harden control UI asset handling in update flow (#10146) 10 months ago
sandbox-browser-entrypoint.sh refactor: rename to openclaw 10 months ago
sandbox-browser-setup.sh refactor: rename to openclaw 10 months ago
sandbox-common-setup.sh refactor: rename to openclaw 10 months ago
sandbox-setup.sh refactor: rename to openclaw 10 months ago
setup-auth-system.sh refactor: rename to openclaw 10 months ago
sqlite-vec-smoke.mjs chore: Also format `scripts` and `skills`. 10 months ago
sync-labels.ts chore: Also format `scripts` and `skills`. 10 months ago
sync-moonshot-docs.ts Docs: fix Moonshot sync markers (#6789) 10 months ago
sync-plugin-versions.ts chore: Enable linting in `scripts`. 10 months ago
termux-auth-widget.sh refactor: rename to openclaw 10 months ago
termux-quick-auth.sh refactor: rename to openclaw 10 months ago
termux-sync-widget.sh refactor: rename to openclaw 10 months ago
test-cleanup-docker.sh refactor: rename to openclaw 10 months ago
test-force.ts chore: Enable "experimentalSortImports" in Oxfmt and reformat all imorts. 10 months ago
test-install-sh-docker.sh refactor: rename to openclaw 10 months ago
test-install-sh-e2e-docker.sh refactor: rename to openclaw 10 months ago
test-live-gateway-models-docker.sh refactor: rename to openclaw 10 months ago
test-live-models-docker.sh refactor: rename to openclaw 10 months ago
test-parallel.mjs fix: context overflow compaction and subagent announce improvements (#11664) (thanks @tyler6204) 10 months ago
test-shell-completion.ts scripts: update test-shell-completion to use shared helpers 10 months ago
ui.js chore: Enable linting in `scripts`. 10 months ago
update-clawtributors.ts chore: Enable `typescript/no-explicit-any` rule. 10 months ago
update-clawtributors.types.ts feat: add prek pre-commit hooks and dependabot (#1720) 10 months ago
watch-node.mjs chore: Migrate to tsdown, speed up JS bundling by ~10x (thanks @hyf0). 10 months ago
write-build-info.ts chore: Enable linting in `scripts`. 10 months ago
write-cli-compat.ts fix(build): support daemon-cli .mjs bundles in compat shim 10 months ago
write-plugin-sdk-entry-dts.ts fix(build): unblock pnpm build dts 10 months ago
zai-fallback-repro.ts chore: apply local workspace updates (#9911) 10 months ago