Perpetua 技能（托管版）

概述

使用 Perpetua.sh 托管 API 作为默认路径：

• - 基础 URL：https://www.perpetua.sh
• API 路由：/api/*
• 认证：Authorization: Bearer $PERPETUAAPIKEY

加载密钥：

bash
op run --env-file=$HOME/.openclaw/secrets.env --

凭证

通过任意密钥源（1Password、CI、.env、密钥管理器）的环境变量设置 API 密钥：

bash
export PERPETUAAPIKEY=

核心端点（托管版）

bash

连接状态摘要

curl -s https://www.perpetua.sh/api/status \
-H Authorization: Bearer $PERPETUAAPIKEY

活跃连接

curl -s https://www.perpetua.sh/api/connections \ -H Authorization: Bearer $PERPETUAAPIKEY

提供商

curl -s https://www.perpetua.sh/api/providers \ -H Authorization: Bearer $PERPETUAAPIKEY

代理调用模式

bash
GET https://www.perpetua.sh/api/proxy/:provider/:path
Authorization: Bearer $PERPETUAAPIKEY

可选：使用 ?account=default 进行显式账户选择。

Oura 示例

除非明确需要，否则避免使用大型端点（daily_activity、详细的 sleep）。

bash

每日睡眠

curl -s https://www.perpetua.sh/api/proxy/oura/v2/usercollection/dailysleep?startdate=YYYY-MM-DD&end_date=YYYY-MM-DD&account=default \
-H Authorization: Bearer $PERPETUAAPIKEY | jq .

每日准备度

curl -s https://www.perpetua.sh/api/proxy/oura/v2/usercollection/dailyreadiness?startdate=YYYY-MM-DD&end_date=YYYY-MM-DD&account=default \ -H Authorization: Bearer $PERPETUAAPIKEY | jq .

锻炼

curl -s https://www.perpetua.sh/api/proxy/oura/v2/usercollection/workout?startdate=YYYY-MM-DD&enddate=YYYY-MM-DD&account=default \ -H Authorization: Bearer $PERPETUAAPIKEY | jq .

Google 日历示例

bash

即将到来的主日历事件

curl -s https://www.perpetua.sh/api/proxy/gcal/calendars/primary/events?account=default&maxResults=10&orderBy=startTime&singleEvents=true&timeMin=$(date -u +%Y-%m-%dT%H:%M:%SZ) \
-H Authorization: Bearer $PERPETUAAPIKEY | jq [.items[] | {summary, start}]

日历列表

curl -s https://www.perpetua.sh/api/proxy/gcal/users/me/calendarList?account=default \ -H Authorization: Bearer $PERPETUAAPIKEY | jq .

连接管理（托管版）

bash

启动提供商的 OAuth 流程

curl -s -X POST https://www.perpetua.sh/api/auth/connect/:provider/start \
-H Authorization: Bearer $PERPETUAAPIKEY \
-H Content-Type: application/json \
-d {account:default} | jq .authUrl

故障排除

• - 401 → API 密钥错误或已过期
• 提供商路由上的 403/404 → 缺少连接或提供商/账户错误
• 5xx → 托管服务问题；重试和/或通知 Daniel

本地 OSS 说明

本地 http://localhost:3001 仅用于 OSS 开发。此工作区中的默认操作路径是托管的 Perpetua.sh。