Skip to main content

​
Overview

Each ClawControl deployment is configured using a config.json file stored in ~/.clawcontrol/deployments/<deployment-name>/. This file defines your cloud provider settings, OpenClaw configuration, and agent settings.

​
Configuration Schema

The deployment configuration follows the DeploymentConfigSchema defined in src/types/index.ts:167.

​
Core Fields

​
name
string
required
Unique identifier for the deployment. Must be lowercase letters, numbers, and hyphens only. Must start and end with a letter or number. Maximum 63 characters (RFC 1123 hostname format).
​
provider
enum
required
Cloud provider to use for deployment.Options: hetzner, digitalocean, vultr
​
createdAt
string
required
ISO 8601 timestamp of when the deployment was created.
​
skipTailscale
boolean
Whether to skip Tailscale installation and configuration. Set to true to deploy without Tailscale VPN.Default: false

​
Provider-Specific Configuration

​
hetzner
object
Hetzner-specific configuration. Required when provider is hetzner.
​
digitalocean
object
DigitalOcean-specific configuration. Required when provider is digitalocean.

​
OpenClaw Configuration

​
openclawConfig
object
Optional configuration overrides for OpenClaw gateway and browser settings. See OpenClaw Configuration for details.
​
openclawAgent
object
AI agent and channel configuration. See OpenClaw Configuration for details.

​
Storage Location

Configuration files are stored at: 
~/.clawcontrol/deployments/<deployment-name>/config.json
The directory structure is managed by src/services/config.ts:12-13: 
const CLAWCONTROL_DIR = join(homedir(), ".clawcontrol");
const DEPLOYMENTS_DIR = join(CLAWCONTROL_DIR, "deployments");

​
Example Configuration

​
Hetzner Deployment

{
  "name": "my-openclaw-server",
  "provider": "hetzner",
  "createdAt": "2026-02-28T10:30:00.000Z",
  "hetzner": {
    "apiKey": "your-hetzner-api-key",
    "serverType": "cpx11",
    "location": "ash",
    "image": "ubuntu-24.04"
  },
  "openclawConfig": {
    "gateway": {
      "port": 18789,
      "mode": "local",
      "bind": "loopback"
    },
    "browser": {
      "headless": true,
      "defaultProfile": "openclaw"
    }
  },
  "openclawAgent": {
    "aiProvider": "openrouter",
    "aiApiKey": "sk-or-v1-...",
    "model": "anthropic/claude-3.5-sonnet",
    "channel": "telegram",
    "telegramBotToken": "1234567890:ABCdef...",
    "telegramAllowFrom": "@yourusername"
  },
  "skipTailscale": false
}

​
DigitalOcean Deployment

{
  "name": "production-agent",
  "provider": "digitalocean",
  "createdAt": "2026-02-28T14:15:00.000Z",
  "digitalocean": {
    "apiKey": "dop_v1_...",
    "size": "s-2vcpu-4gb",
    "region": "sfo3",
    "image": "ubuntu-24-04-x64"
  },
  "openclawAgent": {
    "aiProvider": "anthropic",
    "aiApiKey": "sk-ant-...",
    "model": "claude-3.5-sonnet-20241022",
    "channel": "telegram",
    "telegramBotToken": "9876543210:XYZabc..."
  }
}
  • Type Definition: src/types/index.ts:167 - DeploymentConfigSchema
  • Config Service: src/services/config.ts - Configuration management functions
  • Validation: src/services/config.ts:227 - validateDeploymentName()

Build docs developers (and LLMs) love

Get started for freeTalk to us