list_agents
List OpenClaw fleet agents reachable through this bridge. Returns the roster
as a JSON array with the auth token stripped from every entry.
Arguments
None. The input schema is an empty object.
Return value
A text content block containing JSON — the agents.json roster with only the
token field removed. All other fields (name, role, tier, model,
port, host) are included as loaded, even when empty or absent.
Example call
{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"list_agents","arguments":{}}}
Example result for the roster in Configuration:
[
{
"name": "researcher",
"role": "Research Analyst",
"tier": "pro",
"model": "openclaw",
"port": 18800,
"host": "127.0.0.1"
},
{
"name": "reviewer",
"role": "Code Review",
"tier": "free",
"port": 18802,
"host": "127.0.0.1"
}
]
Failure modes
- Empty roster (missing or unparseable
agents.json): returns an empty array — the bridge falls back to{"agents": []}at startup. This is the signal that your roster path is wrong; see Troubleshooting. - The roster is read at startup, so agents added to the file after launch do not appear until the bridge restarts.