@coderage-labs/armada-agent

OpenClaw plugin for Armada-managed agent instances. Installed automatically by the changeset pipeline when agents are deployed.

What It Does

• Task execution — receives work dispatched by workflows and the task system via /armada/task
• Heartbeat reporting — sends health status and active task count to the control plane
• Status endpoint — /armada/status for idle/busy/draining state
• Maintenance support — /armada/drain to gracefully stop accepting work
• Health endpoint — /armada/health for control plane health checks
• Workflow context — armada_workflow_context tool lets agents fetch workflow state and prior step outputs
• Rework requests — armada_request_rework tool lets review agents send work back for revision
• Progress reporting — task progress posted back to the control plane in real-time
• Callback on completion — results POSTed back when TASK_COMPLETE is detected in agent output
• Subtask coordination — parent tasks wait for child tasks before finalizing

Installation

Installed automatically by the Armada changeset pipeline. For manual installation:

npm install @coderage-labs/armada-agent

Configuration

Added to openclaw.json on managed instances:

{
  "plugins": {
    "entries": {
      "armada-agent": {
        "config": {
          "instanceName": "my-instance",
          "role": "development",
          "armadaApiUrl": "http://armada-control:3001",
          "armadaApiToken": "YOUR_TOKEN"
        }
      }
    }
  }
}

Links

• Armada — Control plane and dashboard
• Plugin Guide — Building OpenClaw plugins