Setup & Installation
Or with the ClawHub CLI, for registry-managed skill folders outside a full OpenClaw workspace:
Version History
- Initial release of the Perpetua skill. - Provides an OAuth proxy for external APIs (Oura, Google Calendar) via a single API key from Perpetua.sh. - Documentation covers API usage, connection management, example requests, and troubleshooting. - Hosted API at https://www.perpetua.sh is the default operational path.
What This Skill Does
OAuth proxy that lets agents call external APIs like Oura and Google Calendar using a single API key. Perpetua.sh handles OAuth token storage and refresh, so agents never touch OAuth credentials directly. Supports multiple provider connections managed through a hosted API.
Instead of managing per-service OAuth flows and token refresh logic, one API key gives agents access to all connected providers through a uniform proxy interface.
When to use it
- Check last night's sleep score before morning planning
- Pull today's calendar events to prep for meetings
- Fetch weekly readiness and HRV trends
- List upcoming workouts logged via Oura Ring
- Add a new OAuth provider connection to the workspace
Example Workflow
Here's how your AI assistant might use this skill in practice.
User asks: How did I sleep this week?
- 1Load PERPETUA_API_KEY from environment
- 2Call GET /api/proxy/oura/v2/usercollection/daily_sleep with start_date and end_date set to the past 7 days
- 3Parse response JSON for sleep score and contributors fields
- 4Summarize scores by day
A day-by-day breakdown of sleep scores and key contributors for the past week
Requirements
Accounts, API keys, or tools you or your AI assistant may need to set up while using this skill.