RealMrHacker/clawdock-studio

ClawDock Studio

A full browser-based development workspace running on a Hugging Face Docker Space.

Single link. Terminal + VS Code + File Manager + OpenClaw — all in one browser tab.

Quick Start

1. Create a Hugging Face Docker Space

• Go to huggingface.co/new-space
• Select Docker as the SDK
• Set hardware (CPU Basic is fine for starting)

2. Clone this repo into the Space

git clone https://github.com/your-repo/clawdock-studio.git
cd clawdock-studio
# Push to your HF Space repo

3. Set Environment Variables

In your Space Settings > Variables and secrets, set:

Variable	Required	Description
OPENCLAW_GATEWAY_TOKEN	Yes	Your OpenClaw gateway token
HF_TOKEN	Yes	Your Hugging Face token
TTYD_PASSWORD	Recommended	Terminal password (default: clawdock)
CODE_SERVER_PASSWORD	Recommended	VS Code password (default: clawdock)
OPENCLAW_GATEWAY_PASSWORD	Optional	OpenClaw UI password

4. Deploy

Push to the Space repo. HF will auto-build and deploy.

Routes

Route	Service	Description
/	Dashboard	Landing page with status and navigation
/terminal	ttyd + tmux	Browser-based CLI terminal
/vscode	code-server	Full VS Code in browser
/files	filebrowser	File manager (upload/download/edit)
/openclaw	OpenClaw	AI agent control interface
/health	API	Health check endpoint

Architecture

User Browser
    │
    ▼
  Nginx (port 7860, public)
    │
    ├── / ──────────► Dashboard API (port 3000)
    ├── /terminal ──► ttyd (port 7681) ──► tmux
    ├── /vscode ────► code-server (port 8080)
    ├── /files ─────► filebrowser (port 8081)
    ├── /openclaw ──► OpenClaw Gateway (port 7861)
    └── /health ────► Health API (port 3001)

Persistence

Data stored in /data persists across container rebuilds (on HF Spaces with persistent storage):

/data/
  .openclaw/          OpenClaw config
  workspaces/         Terminal working directories
  sessions/           Session metadata
  logs/               Service logs
  .filebrowser/       File browser database
  .vscode-data/       VS Code user data
  .vscode-extensions/ VS Code extensions

Note: HF free-tier Spaces may lose /data on rebuild. For persistent storage, enable it in Space settings.

Multi-Session Terminal

Each browser tab opens a separate tmux session. Sessions survive page refreshes and can be reconnected via the dashboard.

• tmux prefix: Ctrl+B
• New window: Ctrl+B C
• Switch windows: Ctrl+B N/P
• Detach: Ctrl+B D

Security

• Terminal access requires password (ttyd auth)
• VS Code requires password
• OpenClaw requires gateway token
• No anonymous public shell access
• All secrets via environment variables (never committed)

Local Development

docker build -t clawdock .
docker run -p 7860:7860 \
  -e OPENCLAW_GATEWAY_TOKEN=test \
  -e HF_TOKEN=hf_xxx \
  clawdock

License

MIT