Go to file
Leopere eb3f3d4134
Add OpenClaw setup guide to desktop
Added OPENCLAW-SETUP.md with comprehensive setup instructions:
- Three setup methods: interactive wizard, web UI, and manual config
- Links to get API keys from all major providers
- Pre-installed tools overview
- Troubleshooting section
- Gateway token information

The guide is now visible on the desktop when users first log in,
making it easier to configure OpenClaw without leaving the container.

Modified Dockerfile to copy the setup guide to the desktop during build.

Co-authored-by: Cursor <cursoragent@cursor.com>
2026-02-12 13:38:43 -05:00
.gitignore Initial commit: Clawtainer - Browser-accessible Linux desktop with AI tools 2026-02-12 13:31:46 -05:00
Dockerfile Add OpenClaw setup guide to desktop 2026-02-12 13:38:43 -05:00
LICENSE Initial commit: Clawtainer - Browser-accessible Linux desktop with AI tools 2026-02-12 13:31:46 -05:00
OPENCLAW-SETUP.md Add OpenClaw setup guide to desktop 2026-02-12 13:38:43 -05:00
README.md Document OpenClaw setup requirements and API configuration 2026-02-12 13:36:18 -05:00
docker-compose.yml Initial commit: Clawtainer - Browser-accessible Linux desktop with AI tools 2026-02-12 13:31:46 -05:00
nginx.conf Initial commit: Clawtainer - Browser-accessible Linux desktop with AI tools 2026-02-12 13:31:46 -05:00

README.md

Clawtainer

Browser-accessible Linux desktop with AI coding tools pre-installed: OpenClaw, VS Code, Cursor, Antigravity, and Anthropic Python SDK.

Quick Start

git clone git@git.nixc.us:colin/clawtainer.git
cd clawtainer
docker compose up -d

Access from any device on your LAN:

  • Desktop (VNC): http://YOUR_IP:6901 (no password)
  • OpenClaw Gateway: http://YOUR_IP:18789

First-time setup: OpenClaw requires API keys from AI providers (Anthropic, OpenAI, Google, etc.). See OpenClaw Setup below.

Run (Docker Compose)

docker compose up -d

The nginx proxy strips TLS from the VNC connection for easy browser access.

Set OpenClaw token: OPENCLAW_GATEWAY_TOKEN=mytoken docker compose up -d

Build (standalone)

docker build -t clawtainer:local .

Kasm Workspaces Setup

  1. Register a new Workspace in Kasm Admin
  2. Set Docker Image to clawtainer:local (or your tagged name)
  3. Add port 18789 to the workspace's port configuration
  4. Save and launch a session

OpenClaw Setup

OpenClaw is an open-source AI agent orchestration platform that connects to AI provider APIs (Anthropic, OpenAI, Google, etc.). The Gateway auto-starts on port 18789, but you need to configure it with your own API keys.

Setup Options:

  1. Interactive Wizard (easiest):

    openclaw onboard
    

    Walks you through model selection and API key entry.

  2. Manual Configuration: Edit ~/.openclaw/openclaw.json or use environment variables:

    export ANTHROPIC_API_KEY="sk-ant-..."
    export OPENAI_API_KEY="sk-..."
    export GOOGLE_API_KEY="AIza..."
    
  3. Via Gateway UI:

    • Open http://localhost:18789 in browser
    • Navigate to Settings
    • Add your API keys for desired providers

Get API Keys:

Note: OpenClaw itself is free and open-source. You only pay for API usage from your chosen AI providers.

Usage

After startup, open the desktop at port 6901. Desktop shortcuts are available:

  • OpenClaw Control - Opens the gateway UI at http://localhost:18789
  • VS Code - Launches Visual Studio Code
  • Cursor - AI-powered code editor
  • Antigravity - Google's AI IDE

Access the Control UI to configure API keys, set up messaging channels (Telegram, WhatsApp, etc.), and manage AI agents.

What's Included

AI Coding Tools:

  • OpenClaw - Auto-starts gateway on port 18789
  • Cursor IDE - AI-powered code editor
  • Google Antigravity - Google's AI IDE with Gemini
  • VS Code - Microsoft Visual Studio Code
  • Anthropic Python SDK - Claude API access (pip install anthropic)

Base:

  • Kasm Desktop: kasmweb/debian-bookworm-desktop:1.18.0-rolling-daily
  • Node: 22 (from NodeSource)
  • Python 3 with pip

Network:

  • Nginx proxy strips TLS for plain HTTP access
  • No password authentication on VNC interface
  • LAN accessible by default

License

Creative Commons Attribution 4.0 International (CC BY 4.0)

Copyright (c) 2026 Colin Knapp - https://colinknapp.com

See LICENSE file for details.