API Reference
REST API
The GoClaw gateway exposes a REST API on port 18789. All authenticated endpoints require the Authorization: Bearer {token} header.
Endpoints
| Method | Path | Auth | Description |
|---|---|---|---|
| GET | /api/v1/health | No | Health check â always returns 200 |
| GET | /api/v1/status | Yes | Agent status, connected channels, active skills |
| POST | /api/v1/message | Yes | Send a message to the agent and get a reply |
| GET | /api/v1/memory | Yes | Get memory (today's log + longterm facts) |
| POST | /api/v1/memory/fact | Yes | Persist a long-term fact |
| DELETE | /api/v1/memory/today | Yes | Clear today's conversation log |
| GET | /api/v1/skills | Yes | List active built-in and sidecar skills |
| GET | /api/v1/channels | Yes | List channels and their connection status |
| POST | /api/v1/skills/connect | Yes | Connect a new sidecar skill at runtime |
POST /api/v1/message
curl example
bash
response
json
GET /api/v1/status
response
json
âšī¸
An OpenAPI 3.1 specification for the full REST API is available at
/api/v1/openapi.json when the gateway is running.