plugins/openclaw/openclaw.plugin.json

{
  "id": "headroom",
  "uiHints": {
    "proxyUrl": {
      "label": "Proxy URL",
      "help": "Optional. URL of a Headroom proxy (example: http://127.0.0.1:8787 or https://headroom.example.com). If omitted, plugin auto-detects on localhost. Auto-start only works for local addresses."
    },
    "proxyPort": {
      "label": "Proxy Port",
      "help": "Default port used for auto-detect/auto-start when proxyUrl is not set (default: 8787)."
    },
    "pythonPath": {
      "label": "Python Path",
      "help": "Optional explicit python executable for python fallback launcher (for example: python, python3, py, or full path)."
    }
  },
  "configSchema": {
    "type": "object",
    "additionalProperties": false,
    "properties": {
      "enabled": {
        "type": "boolean"
      },
      "proxyUrl": {
        "type": "string",
        "pattern": "^https?:\\/\\/.+(:\\d+)?\\/?$"
      },
      "proxyPort": {
        "type": "integer",
        "minimum": 1,
        "maximum": 65535,
        "default": 8787
      },
      "pythonPath": {
        "type": "string"
      },
      "autoStart": {
        "type": "boolean",
        "default": true
      },
      "startupTimeoutMs": {
        "type": "integer",
        "minimum": 1000,
        "maximum": 120000,
        "default": 20000
      }
    }
  },
  "capabilities": {
    "network": {
      "allow": [
        "http://*:*",
        "https://*:*"
      ]
    }
  }
}