OpenClaw Integration
OpenClaw is an AI assistant platform that can interact with WhenToMeet through our API. This integration allows you to create scheduling events, check availability, and manage your calendar using natural language commands.
What is OpenClaw?
OpenClaw is a platform that lets you connect AI assistants to your favorite tools. With the WhenToMeet skill for OpenClaw, you can:
- Create group scheduling events
- List and view your existing events
- Check participant availability
- Book time slots on others' scheduling pages
Setup
1. Create a Scoped API Key
For security, we recommend creating an API key with limited permissions specifically for OpenClaw:
- Go to Settings → API Keys
- Click "Create API Key"
- Enter a name (e.g., "OpenClaw Integration")
- Select "Standard" permissions — this allows creating events and viewing data without deletion access
- Copy the key immediately
2. Configure OpenClaw
Add your API key to your OpenClaw configuration:
{
"skills": {
"entries": {
"whentomeet": {
"apiKey": "sk_your_api_key_here"
}
}
}
}
The key is injected as WHENTOMEET_API_KEY at runtime.
Security Considerations
Sharing API keys with third-party services carries inherent risks. By using the OpenClaw integration, you acknowledge that:
- Your API key will be stored and used by OpenClaw's servers
- OpenClaw will have access to your events, bookings, and calendar connections
- You are responsible for monitoring usage and revoking access if needed
Use at your own risk.
Best Practices
- Use the "Standard" scope — This limits OpenClaw to creating events and viewing data, without the ability to delete anything
- Monitor usage — Check your API key usage regularly in Settings → API Keys
- Rotate keys periodically — Delete old keys and create new ones if you suspect compromise
- Use a dedicated key — Create a separate API key just for OpenClaw so you can revoke it independently
Permission Scopes
When creating an API key, you can choose from three permission levels:
| Scope | Can View | Can Create | Can Delete | Best For |
|---|---|---|---|---|
| Read Only | Events, bookings, calendars | No | No | Analytics dashboards |
| Standard | Events, bookings, calendars | Events | No | OpenClaw, AI assistants |
| Full | Events, bookings, calendars | Events | Events | Trusted internal tools |
For OpenClaw, we recommend Standard scope. This allows the AI to create scheduling events and view your data, but prevents accidental or malicious deletion of events.
Example Usage
Once configured, you can ask OpenClaw to:
- "Create a team standup event for tomorrow at 9am or 10am"
- "Show me my upcoming events"
- "What slots are available on Jane's booking page?"
OpenClaw will use your API key to interact with WhenToMeet programmatically.
Troubleshooting
"API key scope does not allow access"
Your API key doesn't have the necessary permissions. Create a new key with Standard or Full scope.
"Invalid or expired API key"
- Verify the key starts with
sk_ - Check that the key hasn't been revoked in Settings → API Keys
- Ensure the key hasn't expired (if you set an expiration date)
Rate Limiting
API keys are subject to rate limits based on your subscription:
- Free: 32 requests (lifetime)
- Plus: 1,000 requests per hour