OpenCloud
OpenClaw

OpenClaw Installation

Step-by-step guide to deploying OpenClaw on OpenCloud.

Install OpenClaw

Step-by-step deployment

  1. Deploy OpenClaw
    • Go to Applications > Create Application
    • Select OpenClaw
    • Choose a plan:
      • Mini (~$5/month) — Minimum recommended (browser needs RAM)
      • Lite (~$9/month) — Better for frequent use
      • Standard (~$16/month) — Best for heavy/production use
    • Select your project
    • Click Deploy
OpenClaw doesn't require a separate database — it runs standalone.
  1. Wait for deployment (3-5 minutes)

OpenClaw takes slightly longer to deploy because it sets up both the AI agent and the browser.

  1. Get your login credentials

Go to your OpenClaw application > Environment Variables to find:

  • AUTH_USERNAME — Your login username (default: admin)
  • AUTH_PASSWORD — Your auto-generated login password
  • OPENCLAW_GATEWAY_TOKEN — Token for the Gateway control UI
  1. Access OpenClaw

You'll have access to two interfaces:

  • Main application — The primary OpenClaw interface
  • Gateway UI — Advanced control panel (accessible on the gateway port)

Configuration

Connect an AI model

By default, OpenClaw is configured to use google/gemini-2.5-flash. To change the AI model:

  1. Go to Environment Variables
  2. Update OPENCLAW_PRIMARY_MODEL to your preferred model
  3. If using a custom API, set GEMINI_API_KEY or the relevant API key
  4. Save and restart

Set up Telegram bot

To control OpenClaw via Telegram:

  1. Create a bot on Telegram by talking to @BotFather
  2. Copy the bot token
  3. Go to your OpenClaw application > Environment Variables
  4. Set TELEGRAM_BOT_TOKEN to your bot token
  5. Save and restart
  6. Message your Telegram bot to start using OpenClaw

Set up Discord bot

To control OpenClaw via Discord:

  1. Create a Discord bot at the Discord Developer Portal
  2. Copy the bot token
  3. Go to Environment Variables
  4. Set DISCORD_BOT_TOKEN to your bot token
  5. Save and restart
  6. Invite the bot to your Discord server

Default environment variables

VariableDefaultDescription
AUTH_USERNAMEadminLogin username
AUTH_PASSWORDAuto-generatedLogin password
OPENCLAW_PRIMARY_MODELgoogle/gemini-2.5-flashAI model to use
OPENCLAW_GATEWAY_TOKENAuto-generatedGateway control token
BROWSER_SNAPSHOT_MODEefficientHow browser screenshots are captured
HOOKS_ENABLEDfalseEnable/disable webhook hooks

What's next?

Troubleshooting

ProblemSolution
OpenClaw won't startEnsure you're on Mini plan or larger (needs 4 GB+ RAM)
Browser crashesUpgrade to a plan with more memory
AI responses are wrongCheck that your AI model API key is valid
Telegram bot doesn't respondVerify TELEGRAM_BOT_TOKEN is set correctly and restart
Gateway UI won't loadCheck the gateway port and OPENCLAW_GATEWAY_TOKEN
Need help?Submit a support ticket or check the application logs for error messages.
Copyright © 2026