clawtainer/OPENCLAW-SETUP.md

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:

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:

{
  "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:

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:

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?

# 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