diff --git a/Dockerfile b/Dockerfile index 7da1682..f25ffc0 100644 --- a/Dockerfile +++ b/Dockerfile @@ -68,6 +68,9 @@ RUN mkdir -p $HOME/Desktop \ && chmod +x $HOME/Desktop/*.desktop \ && chown -R 1000:1000 $HOME/Desktop +# Copy OpenClaw setup guide to desktop +COPY --chown=1000:1000 OPENCLAW-SETUP.md $HOME/Desktop/ + # Disable authentication but keep HTTPS RUN sed -i 's/vncserver/vncserver -SecurityTypes None -DisableBasicAuth 1/g' /dockerstartup/vnc_startup.sh \ && sed -i 's/kasm_password_file:.*$/kasm_password_file:/g' /usr/share/kasmvnc/kasmvnc_defaults.yaml diff --git a/OPENCLAW-SETUP.md b/OPENCLAW-SETUP.md new file mode 100644 index 0000000..92d6a96 --- /dev/null +++ b/OPENCLAW-SETUP.md @@ -0,0 +1,132 @@ +# OpenClaw Setup Guide + +Welcome to Clawtainer! This desktop has OpenClaw Gateway pre-installed and running on port 18789. + +## What is OpenClaw? + +OpenClaw is an open-source AI agent orchestration platform that connects to AI provider APIs. The Gateway is already running in the background, but you need to configure it with your API keys. + +## Quick Setup (Choose One) + +### Option 1: Interactive Wizard (Recommended) + +Open a terminal and run: + +```bash +openclaw onboard +``` + +This will guide you through: +- Selecting your preferred AI models +- Entering API keys +- Configuring messaging channels (optional) + +### Option 2: Web Interface + +1. Open Firefox/Chromium in this desktop +2. Navigate to: `http://localhost:18789` +3. Click **Settings** in the Gateway UI +4. Add your API keys for desired providers + +### Option 3: Manual Configuration + +Create or edit `~/.openclaw/openclaw.json`: + +```json +{ + "models": { + "providers": { + "anthropic": { + "apiKey": "sk-ant-your-key-here" + }, + "openai": { + "apiKey": "sk-your-key-here" + }, + "google": { + "apiKey": "AIza-your-key-here" + } + } + } +} +``` + +Or use environment variables in `~/.bashrc`: + +```bash +export ANTHROPIC_API_KEY="sk-ant-your-key-here" +export OPENAI_API_KEY="sk-your-key-here" +export GOOGLE_API_KEY="AIza-your-key-here" +``` + +## Get API Keys + +You'll need API keys from at least one provider: + +- **Anthropic (Claude)**: https://console.anthropic.com/ + - Best for: Coding, analysis, long conversations + - Pricing: Pay-per-token, ~$3-15 per million tokens + +- **OpenAI (GPT-4)**: https://platform.openai.com/api-keys + - Best for: General purpose, creative writing + - Pricing: Pay-per-token, varies by model + +- **Google (Gemini)**: https://makersuite.google.com/app/apikey + - Best for: Free tier available, multimodal + - Pricing: Free tier + pay-per-token + +- **OpenRouter**: https://openrouter.ai/keys + - Best for: Access to multiple models through one API + - Pricing: Varies by model selected + +## Verify Setup + +After adding keys, test the connection: + +```bash +openclaw gateway status +``` + +Or visit `http://localhost:18789` to see the Gateway control panel. + +## Pre-installed Tools + +This desktop includes: + +- **OpenClaw** - AI agent orchestration (port 18789) +- **Cursor** - AI-powered code editor +- **VS Code** - Microsoft Visual Studio Code +- **Antigravity** - Google's AI IDE with Gemini +- **Anthropic SDK** - Python library for Claude (`import anthropic`) + +All tools have desktop shortcuts for easy access. + +## Gateway Token + +The OpenClaw Gateway is configured with token: `clawtainer` + +You can change this by setting the `OPENCLAW_GATEWAY_TOKEN` environment variable when launching the container. + +## Troubleshooting + +**Gateway not responding?** +```bash +# Check if gateway is running +ps aux | grep openclaw + +# Restart gateway +openclaw gateway restart +``` + +**API key not working?** +- Check that your API key has not expired +- Verify billing is enabled on the provider's platform +- Check for typos in the key + +**Need help?** +- OpenClaw Docs: https://docs.openclaw.ai/ +- OpenClaw GitHub: https://github.com/openclaw/openclaw + +--- + +**Clawtainer** - https://colinknapp.com +Licensed under CC Attribution 4.0