perpetua

What This Skill Does

The Perpetua skill acts as a robust OAuth proxy agent for OpenClaw, centralizing access to diverse third-party APIs like Oura and Google Calendar. By leveraging the hosted Perpetua.sh infrastructure, this skill eliminates the complexity of manual token management, refreshing, and provider-specific authentication flows. It standardizes communication with external services through a single, secure API key, allowing OpenClaw to fetch health metrics, manage calendar events, and trigger OAuth handshake procedures seamlessly. The skill acts as a secure middleware that maps intuitive proxy requests to the specific endpoint requirements of connected providers.

Installation

To install this skill, use the following command in your terminal: clawhub install openclaw/skills/skills/danielkillenberger/perpetua Ensure your PERPETUA_API_KEY is exported in your environment or managed via your preferred secret manager (e.g., 1Password). For consistent development and runtime safety, load your configuration using the provided op run pattern to ensure the environment variables are injected correctly into the agent session.

Use Cases

This skill is ideal for personal automation and data-driven workflows. Common use cases include:

• Health Monitoring: Aggregating readiness scores, sleep quality, and activity data from Oura for AI-driven health analysis.
• Calendar Orchestration: Managing schedules, querying upcoming meetings, or checking availability directly through Google Calendar without navigating browser tabs.
• OAuth Lifecycle Management: Programmatically triggering and verifying connection status for new providers to ensure the agent maintains access to necessary data sources.

Example Prompts

1. "Check my readiness score from Oura for the last 3 days and summarize if I am recovered enough for a heavy workout."
2. "Show me the next 5 events on my primary calendar starting from now so I can plan my focus time."
3. "Initiate an OAuth connection flow for my Google Calendar so I can manage my appointments through you."

Tips & Limitations

• Efficiency: When querying Oura, favor specific endpoints like daily_readiness or daily_sleep over high-latency detailed endpoints to minimize payload size and improve response speed.
• Security: Always rotate your PERPETUA_API_KEY if you suspect it has been compromised. The skill is designed for the hosted Perpetua.sh platform; avoid local development loops (localhost:3001) unless you are actively debugging the core skill source.
• Troubleshooting: If you receive a 403 or 404, verify that the connection has been established via the /api/connections endpoint and that the account parameter is correctly defined as default or your preferred profile.