Skip to main content
GET
/
api
/
v1
/
admin
/
agents
curl -X GET https://alfred.black/api/v1/admin/agents \
  -H "Authorization: Bearer alf_your_key_here"

{
  "agents": [
    {
      "id": "main",
      "label": "Alfred",
      "description": "Default agent for device interactions"
    },
    {
      "id": "vault-curator",
      "label": "Curator",
      "description": "Processes inbox into structured vault records"
    },
    {
      "id": "vault-janitor",
      "label": "Janitor",
      "description": "Scans vault for structural issues and fixes them"
    },
    {
      "id": "vault-distiller",
      "label": "Distiller",
      "description": "Extracts latent knowledge from operational records"
    }
  ],
  "surveyor": {
    "labeler_model": "x-ai/grok-4.1-fast",
    "embedder_model": "nomic-embed-text",
    "embedder_source": "ollama"
  }
}
Returns a summary of every agent on your instance. This includes the four OpenClaw agents (Alfred, Curator, Janitor, Distiller) and the Surveyor pipeline configuration. Use Get Agent to retrieve the full model status for a single agent.

​
Response

​
agents
array
List of agent summary objects, one per OpenClaw agent.
​
surveyor
object
Surveyor pipeline model configuration (configured via config.yaml, not OpenClaw).

​
Request Example

curl -X GET https://alfred.black/api/v1/admin/agents \
  -H "Authorization: Bearer alf_your_key_here"

​
Response Example

{
  "agents": [
    {
      "id": "main",
      "label": "Alfred",
      "description": "Default agent for device interactions"
    },
    {
      "id": "vault-curator",
      "label": "Curator",
      "description": "Processes inbox into structured vault records"
    },
    {
      "id": "vault-janitor",
      "label": "Janitor",
      "description": "Scans vault for structural issues and fixes them"
    },
    {
      "id": "vault-distiller",
      "label": "Distiller",
      "description": "Extracts latent knowledge from operational records"
    }
  ],
  "surveyor": {
    "labeler_model": "x-ai/grok-4.1-fast",
    "embedder_model": "nomic-embed-text",
    "embedder_source": "ollama"
  }
}