{
  "id": "teamclaw",
  "name": "TeamClaw",
  "description": "Virtual team collaboration - multiple OpenClaw instances form a virtual software company with role-based task routing.",
  "version": "2026.4.3-2",
  "skills": [
    "./skills"
  ],
  "uiHints": {
    "mode": {
      "label": "Mode",
      "help": "controller manages the team, worker executes tasks"
    },
    "port": {
      "label": "Port",
      "help": "HTTP server port for this instance"
    },
    "role": {
      "label": "Role",
      "help": "Worker role (worker mode only)"
    },
    "controllerUrl": {
      "label": "Controller URL",
      "help": "Manual fallback if mDNS discovery fails"
    },
    "teamName": {
      "label": "Team Name",
      "help": "Team identifier for mDNS"
    },
    "heartbeatIntervalMs": {
      "label": "Heartbeat Interval",
      "help": "In milliseconds, minimum 1000"
    },
    "taskTimeoutMs": {
      "label": "Task Stall Threshold",
      "help": "In milliseconds, how long TeamClaw waits without visible progress before probing the task instead of failing it"
    },
    "gitEnabled": {
      "label": "Git Collaboration",
      "help": "Enable automatic git-backed workspace bootstrapping and worker repo sync"
    },
    "gitRemoteUrl": {
      "label": "Git Remote URL",
      "help": "Optional remote repository URL; when empty, distributed workers use controller-hosted git bundles"
    },
    "gitDefaultBranch": {
      "label": "Git Default Branch",
      "help": "Default branch name for the TeamClaw workspace repository"
    },
    "gitAuthorName": {
      "label": "Git Author Name",
      "help": "Author name for TeamClaw-managed workspace commits"
    },
    "gitAuthorEmail": {
      "label": "Git Author Email",
      "help": "Author email for TeamClaw-managed workspace commits"
    },
    "agentIsolationMode": {
      "label": "Agent Isolation Mode",
      "help": "Use a dedicated TeamClaw agent/workspace by default, or the legacy shared main-agent mode"
    },
    "processModel": {
      "label": "Process Model",
      "help": "TeamClaw runs workers as local or provisioned gateway processes"
    },
    "workerProvisioningType": {
      "label": "On-demand Worker Provider",
      "help": "Launch missing workers on demand using process, Docker, or Kubernetes"
    },
    "workerProvisioningDisabled": {
      "label": "Disable On-demand Workers",
      "help": "Force TeamClaw to keep worker provisioning off even for same-host local controllers"
    },
    "workerProvisioningControllerUrl": {
      "label": "Provisioned Worker Controller URL",
      "help": "URL that launched workers use to call back into the controller"
    },
    "workerProvisioningRoles": {
      "label": "Provisioned Roles",
      "help": "Preferred on-demand roles; task-required roles can still launch automatically"
    },
    "workerProvisioningMinPerRole": {
      "label": "Warm Workers Per Role",
      "help": "Minimum idle workers to keep warm per role"
    },
    "workerProvisioningMaxPerRole": {
      "label": "Max Workers Per Role",
      "help": "Maximum concurrent on-demand workers per role"
    },
    "workerProvisioningIdleTtlMs": {
      "label": "Idle TTL",
      "help": "Terminate an idle provisioned worker after this many milliseconds"
    },
    "workerProvisioningStartupTimeoutMs": {
      "label": "Startup Timeout",
      "help": "Fail a launch if the worker does not register in time"
    },
    "workerProvisioningImage": {
      "label": "Provisioning Image",
      "help": "Container image for docker/kubernetes provisioners"
    },
    "workerProvisioningPassEnv": {
      "label": "Pass-through Env",
      "help": "Environment variable names copied from controller to provisioned workers"
    },
    "workerProvisioningExtraEnv": {
      "label": "Extra Env",
      "help": "Static environment variables injected into provisioned workers"
    },
    "workerProvisioningDockerNetwork": {
      "label": "Docker Network",
      "help": "Optional Docker network for launched worker containers"
    },
    "workerProvisioningDockerMounts": {
      "label": "Docker Mounts",
      "help": "Optional Docker bind mounts for launched worker containers"
    },
    "workerProvisioningWorkspaceRoot": {
      "label": "Workspace Root",
      "help": "Optional persistent workspace root path inside docker/kubernetes workers; defaults to /workspace-root when persistence is configured"
    },
    "workerProvisioningDockerWorkspaceVolume": {
      "label": "Docker Workspace Volume",
      "help": "Optional Docker named volume or host path mounted as the persistent workspace root"
    },
    "workerProvisioningKubernetesNamespace": {
      "label": "Kubernetes Namespace",
      "help": "Namespace for launched worker pods"
    },
    "workerProvisioningKubernetesContext": {
      "label": "Kubernetes Context",
      "help": "Optional kubectl context for the Kubernetes provider"
    },
    "workerProvisioningKubernetesServiceAccount": {
      "label": "Kubernetes Service Account",
      "help": "Optional service account for launched worker pods"
    },
    "workerProvisioningKubernetesImagePullSecrets": {
      "label": "Kubernetes Image Pull Secrets",
      "help": "Optional secret names added to launched worker pods so they can pull private images"
    },
    "workerProvisioningKubernetesWorkspacePersistentVolumeClaim": {
      "label": "Kubernetes Workspace PVC",
      "help": "Optional PVC mounted as the persistent workspace root for launched worker pods"
    },
    "workerProvisioningKubernetesLabels": {
      "label": "Kubernetes Labels",
      "help": "Extra labels applied to launched worker pods"
    },
    "workerProvisioningKubernetesAnnotations": {
      "label": "Kubernetes Annotations",
      "help": "Extra annotations applied to launched worker pods"
    }
  },
  "configSchema": {
    "type": "object",
    "properties": {
      "mode": {
        "type": "string",
        "enum": [
          "controller",
          "worker"
        ],
        "default": "worker",
        "description": "Plugin mode: controller manages the team, worker executes tasks"
      },
      "port": {
        "type": "number",
        "default": 9527,
        "description": "HTTP server port for this instance"
      },
      "role": {
        "type": "string",
        "default": "developer",
        "description": "Worker role (only used in worker mode)"
      },
      "controllerUrl": {
        "type": "string",
        "default": "",
        "description": "Manual controller URL fallback (used when mDNS discovery fails)"
      },
      "teamName": {
        "type": "string",
        "default": "TeamClaw",
        "description": "Team name for mDNS identification"
      },
      "heartbeatIntervalMs": {
        "type": "number",
        "default": 10000,
        "description": "Heartbeat interval in milliseconds"
      },
      "taskTimeoutMs": {
        "type": "number",
        "default": 1800000,
        "description": "Inactivity threshold in milliseconds before TeamClaw probes a stalled role task instead of failing it"
      },
      "gitEnabled": {
        "type": "boolean",
        "default": true,
        "description": "Enable TeamClaw git-backed workspace collaboration"
      },
      "gitRemoteUrl": {
        "type": "string",
        "default": "",
        "description": "Optional remote repository URL for distributed worker clone/pull/push"
      },
      "gitDefaultBranch": {
        "type": "string",
        "default": "main",
        "description": "Default branch name for the shared TeamClaw workspace repository"
      },
      "gitAuthorName": {
        "type": "string",
        "default": "TeamClaw",
        "description": "Git author name used for TeamClaw-managed workspace commits"
      },
      "gitAuthorEmail": {
        "type": "string",
        "default": "teamclaw@local",
        "description": "Git author email used for TeamClaw-managed workspace commits"
      },
      "agentIsolationMode": {
        "type": "string",
        "enum": [
          "independent",
          "main"
        ],
        "default": "independent",
        "description": "Runtime isolation mode: dedicated TeamClaw agent/workspace, or legacy main-agent shared mode"
      },
      "processModel": {
        "type": "string",
        "enum": [
          "multi"
        ],
        "default": "multi",
        "description": "Worker execution model: TeamClaw runs workers as local or provisioned gateway processes"
      },
      "workerProvisioningType": {
        "type": "string",
        "enum": [
          "none",
          "process",
          "docker",
          "kubernetes"
        ],
        "default": "none",
        "description": "Controller-only on-demand worker launch backend"
      },
      "workerProvisioningDisabled": {
        "type": "boolean",
        "default": false,
        "description": "Explicitly disable controller-managed on-demand workers even when TeamClaw would normally default to same-host process provisioning"
      },
      "workerProvisioningControllerUrl": {
        "type": "string",
        "default": "",
        "description": "Controller URL injected into provisioned workers; required for docker/kubernetes"
      },
      "workerProvisioningRoles": {
        "type": "array",
        "default": [],
        "description": "Preferred on-demand roles; task-required roles can still launch automatically. Empty means no preferred startup role list, so startup readiness falls back to a warm developer worker",
        "items": {
          "type": "string",
          "enum": [
            "pm",
            "architect",
            "developer",
            "qa",
            "release-engineer",
            "infra-engineer",
            "devops",
            "security-engineer",
            "designer",
            "marketing"
          ]
        }
      },
      "workerProvisioningMinPerRole": {
        "type": "number",
        "default": 0,
        "description": "Minimum number of ready workers to keep warm per role"
      },
      "workerProvisioningMaxPerRole": {
        "type": "number",
        "default": 10,
        "description": "Maximum on-demand workers to launch per role"
      },
      "workerProvisioningIdleTtlMs": {
        "type": "number",
        "default": 120000,
        "description": "Terminate provisioned idle workers after this many milliseconds"
      },
      "workerProvisioningStartupTimeoutMs": {
        "type": "number",
        "default": 120000,
        "description": "Fail a launch if the worker does not register within this many milliseconds"
      },
      "workerProvisioningImage": {
        "type": "string",
        "default": "ghcr.io/topcheer/teamclaw-openclaw:latest",
        "description": "Container image used by docker/kubernetes provisioners"
      },
      "workerProvisioningPassEnv": {
        "type": "array",
        "default": [],
        "description": "Environment variable names copied from the controller into provisioned workers",
        "items": {
          "type": "string"
        }
      },
      "workerProvisioningExtraEnv": {
        "type": "object",
        "default": {},
        "description": "Extra environment variables injected into provisioned workers",
        "additionalProperties": {
          "type": "string"
        }
      },
      "workerProvisioningDockerNetwork": {
        "type": "string",
        "default": "",
        "description": "Optional Docker network name for launched worker containers"
      },
      "workerProvisioningDockerMounts": {
        "type": "array",
        "default": [],
        "description": "Optional Docker bind mounts for launched worker containers",
        "items": {
          "type": "string"
        }
      },
      "workerProvisioningWorkspaceRoot": {
        "type": "string",
        "default": "",
        "description": "Optional persistent workspace root path inside docker/kubernetes workers; defaults to /workspace-root when a Docker volume or PVC is configured"
      },
      "workerProvisioningDockerWorkspaceVolume": {
        "type": "string",
        "default": "",
        "description": "Optional Docker named volume or host path mounted as the persistent workspace root"
      },
      "workerProvisioningKubernetesNamespace": {
        "type": "string",
        "default": "default",
        "description": "Kubernetes namespace for launched worker pods"
      },
      "workerProvisioningKubernetesContext": {
        "type": "string",
        "default": "",
        "description": "Optional kubectl context used by the Kubernetes provisioner"
      },
      "workerProvisioningKubernetesServiceAccount": {
        "type": "string",
        "default": "",
        "description": "Optional service account name for launched worker pods"
      },
      "workerProvisioningKubernetesImagePullSecrets": {
        "type": "array",
        "default": [],
        "description": "Optional image pull secret names added to launched worker pods",
        "items": {
          "type": "string"
        }
      },
      "workerProvisioningKubernetesWorkspacePersistentVolumeClaim": {
        "type": "string",
        "default": "",
        "description": "Optional PVC mounted as the persistent workspace root for launched worker pods"
      },
      "workerProvisioningKubernetesLabels": {
        "type": "object",
        "default": {},
        "description": "Extra labels applied to launched worker pods",
        "additionalProperties": {
          "type": "string"
        }
      },
      "workerProvisioningKubernetesAnnotations": {
        "type": "object",
        "default": {},
        "description": "Extra annotations applied to launched worker pods",
        "additionalProperties": {
          "type": "string"
        }
      }
    }
  }
}