A hosted OAuth proxy that enables seamless data retrieval from Oura Ring and Google Calendar using a single master API key.
Install & Download
1. ClawHub CLI
The fastest way to install a skill directly from the registry.
npx clawhub@latest install perpetua
2. Manual Installation
Copy the skill folder to one of these locations
~/.openclaw/skills/ <project>/skills/ Priority: Workspace > Local > Bundled
3. Prompt Installation
Copy this prompt to OpenClaw to install it automatically.
Help me install perpetua using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).
Prefer to download?
Get the raw skill files in a ZIP archive.
What is Perpetua?
Perpetua acts as a centralized gateway for managing OAuth-based connections to external services. By utilizing the Perpetua.sh hosted API, developers and AI agents can bypass the complexity of individual OAuth implementations for various platforms. As a featured tool within Openclaw Skills, it provides a standardized way to access health metrics, activity data, and calendar schedules through a unified proxy layer, ensuring secure and efficient data handling.
Perpetua Use Cases
- Retrieving Oura Ring metrics such as sleep scores, readiness, HRV, and daily activity.
- Synchronizing and managing Google Calendar events and schedules.
- Centralizing multiple OAuth provider connections under one authentication token.
- Automating the setup of new API connections via hosted authentication flows.
How Perpetua Works
- The user provides a master PERPETUA_API_KEY to authenticate with the hosted proxy service.
- The skill queries the status or available providers to determine which external services are connected.
- For new integrations, the skill initiates an OAuth flow and returns a connection URL.
- Once connected, requests are routed through the proxy endpoint to specific providers (e.g., /api/proxy/oura/v2/...).
- The proxy service handles token refresh and authentication headers, returning the raw or filtered JSON data to the requester.
Perpetua Setup
To get started with this skill in the Openclaw Skills ecosystem, set your API key as an environment variable:
export PERPETUA_API_KEY="<your-key>"
If you use 1Password for secret management, you can load your environment variables securely:
op run --env-file="$HOME/.openclaw/secrets.env" -- <command>
Verify your connection status using curl:
curl -s "https://www.perpetua.sh/api/status" -H "Authorization: Bearer $PERPETUA_API_KEY"
Perpetua Data Schema & Taxonomy
The skill organizes data via provider-specific proxy routes. Below are the primary endpoints and data structures:
| Endpoint | Purpose | Key Data Fields |
|---|---|---|
/api/status |
Service Health | Status, uptime, and system connectivity |
/api/connections |
Active Accounts | Provider names, account IDs, and connection timestamps |
/api/proxy/oura |
Health Data | Sleep, readiness, activity, and heart rate variability |
/api/proxy/gcal |
Calendar Data | Event summaries, start/end times, and calendar lists |
Perpetua Advanced Features
- Multi-account support allows managing different profiles for the same provider using the account parameter.
- Programmatic connection management enables starting OAuth flows directly through API calls.
- Standardized error handling for 401 (unauthorized) and 403/404 (missing connections) scenarios.
- Seamless integration with command-line utilities like jq for real-time data filtering and transformation within Openclaw Skills.
SKILL.md
Loading
Related Openclaw Skills
Calendar Bridge
A self-hosted Node.js service that provides a persistent REST API for Google Calendar with automated OAuth token refreshing.
Tour Booking
A specialized AI sub-agent for automating outbound property showing calls and managing booking statuses.
Show Booking
An end-to-end automation skill for parsing real estate listing details and coordinating showing tours via AI-driven outbound calls and calendar integration.
Podcast to Substack & LinkedIn Publisher
Automates the publishing of podcast episodes from RSS feeds and Notion scripts to Substack and LinkedIn with reliable embedding.
McDonald's China MCP Order Lite
A streamlined MCP-based skill for automating McDonald's China delivery orders, menu lookups, and coupon management via official API protocols.
CI Flake Triage
A powerful utility for identifying and prioritizing flaky tests by analyzing JUnit retry artifacts within your CI pipeline.
Featured*
