Channels API
Retrieve channel connection status and activity metrics from the OpenClaw gateway.List channels
connected when sessions with matching keys exist.
Documentation Index
Fetch the complete documentation index at: /llms.txt
Use this file to discover all available pages before exploring further.
Get real-time channel status from the OpenClaw gateway
GET /api/channels
connected when sessions with matching keys exist.
{
"channels": [
{
"name": "Webchat",
"provider": "webchat",
"status": "connected",
"lastActive": "2026-03-30T01:00:00Z",
"messages": 42
},
{
"name": "Telegram",
"provider": "telegram",
"status": "connected",
"lastActive": "2026-03-30T00:45:00Z",
"messages": 15
},
{
"name": "Discord",
"provider": "discord",
"status": "not-configured",
"lastActive": null,
"messages": 0
},
{
"name": "WhatsApp",
"provider": "whatsapp",
"status": "not-configured",
"lastActive": null,
"messages": 0
}
],
"gatewayHealth": "healthy",
"source": "gateway"
}
| Field | Type | Description |
|---|---|---|
name | string | Display name of the channel |
provider | string | Channel identifier: webchat, telegram, discord, or whatsapp |
status | string | Connection status (see table below) |
lastActive | string | null | ISO 8601 timestamp of the most recent activity on this channel, or null if no activity |
messages | number | Total message count across all sessions for this channel |
| Status | Condition |
|---|---|
connected | Channel has active sessions or (for webchat) the gateway is healthy |
not-configured | No sessions found for this channel |
unreachable | Gateway health check failed (webchat only) |
| Field | Type | Description |
|---|---|---|
channels | array | List of channel objects |
gatewayHealth | string | Overall gateway health: healthy or unreachable |
source | string | Always gateway |
| Code | Description |
|---|---|
| 401 | Unauthorized — no valid session |
curl -X GET https://agentbot.raveculture.xyz/api/channels \
-H "Cookie: next-auth.session-token=YOUR_SESSION"
Was this page helpful?