API Reference
Programmatic access to your ClawLuv agent (coming soon).
API access
The ClawLuv API is currently in development. When available, it will let you:
- Send messages to your agent programmatically
- Retrieve conversation history
- Manage skills and configuration
- Query your agent's memory
Telegram as the primary interface
Right now, the primary way to interact with your agent is through Telegram. Your bot receives messages, processes them through OpenClaw, and responds in the same chat.
Message types supported
| Type | Supported | Notes |
|---|---|---|
| Text messages | ✅ | Standard text conversations |
| Voice notes | ✅ | Transcribed automatically via Whisper |
| Photos | ✅ | Analyzed with vision models |
| Documents | ✅ | Text extracted and processed |
| Videos | ⚠️ | Frame extraction, not full video analysis |
| Stickers | ❌ | Not currently supported |
| Polls | ❌ | Not currently supported |
Rate limits
There are no artificial rate limits on your agent. However, practical limits apply:
- Telegram's own API rate limits (roughly 30 messages per second per bot)
- Model API latency (responses typically take 2–10 seconds)
- Container resource limits (your agent runs in a sandboxed environment)
Webhooks (planned)
We plan to support webhooks so your agent can notify external services when certain events happen (e.g., a task is completed, a reminder fires, or a specific keyword is mentioned).
REST API (planned)
A REST API for managing your agent, reading memory, and sending messages outside of Telegram. Target: Q3 2025.
If you need programmatic access now, reach out at hello@clawluv.com and we can discuss early access options.