OpenClaw 集成
OpenClaw 是一个可以通过我们的 API 与 WhenToMeet 交互的 AI 助手平台。此集成允许您使用自然语言命令创建日程活动、查看可用时间并管理您的日历。
什么是 OpenClaw?
OpenClaw 是一个让您将 AI 助手连接到常用工具的平台。通过 WhenToMeet 的 OpenClaw 技能,您可以:
- 创建群组日程活动
- 列出和查看您现有的活动
- 查看参与者的可用时间
- 在他人的日程页面上预订时间 slots
设置
1. 创建限定范围的 API 密钥
出于安全考虑,我们建议专门为 OpenClaw 创建一个权限有限的 API 密钥:
- 前往 设置 → API 密钥
- 点击"创建 API 密钥"
- 输入名称(例如,"OpenClaw 集成")
- 选择"标准"权限 — 这允许创建活动和查看数据,但没有删除权限
- 立即复制密钥
2. 配置 OpenClaw
将您的 API 密钥添加到 OpenClaw 配置中:
{
"skills": {
"entries": {
"whentomeet": {
"apiKey": "sk_your_api_key_here"
}
}
}
}
该密钥在运行时作为 WHENTOMEET_API_KEY 注入。
安全注意事项
与第三方服务共享 API 密钥存在固有风险。使用 OpenClaw 集成即表示您确认:
- 您的 API 密钥将被 OpenClaw 的服务器存储和使用
- OpenClaw 将可以访问您的活动、预订和日历连接
- 您有责任监控使用情况并在需要时撤销访问权限
使用风险自负。
最佳实践
- 使用"标准"范围 — 这将 OpenClaw 限制为创建活动和查看数据,无法删除任何内容
- 监控使用情况 — 定期在设置 → API 密钥中检查您的 API 密钥使用情况
- 定期轮换密钥 — 如果您怀疑密钥泄露,请删除旧密钥并创建新密钥
- 使用专用密钥 — 专门为 OpenClaw 创建一个单独的 API 密钥,以便您可以独立撤销它
权限范围
创建 API 密钥时,您可以从三个权限级别中选择:
| 范围 | 可查看 | 可创建 | 可删除 | 最适合 |
|---|---|---|---|---|
| 只读 | 活动、预订、日历 | 否 | 否 | 分析仪表板 |
| 标准 | 活动、预订、日历 | 活动 | 否 | OpenClaw、AI 助手 |
| 完整 | 活动、预订、日历 | 活动 | 活动 | 受信任的内部工具 |
对于 OpenClaw,我们推荐使用标准范围。这允许 AI 创建日程活动和查看您的数据,但可以防止意外或恶意删除活动。
使用示例
配置完成后,您可以要求 OpenClaw:
- "创建一个明天上午 9 点或 10 点的团队站会活动"
- "显示我即将进行的活动"
- "Jane 的预订页面上有哪些时间 slots 可用?"
OpenClaw 将使用您的 API 密钥以编程方式与 WhenToMeet 交互。
故障排除
"API 密钥范围不允许访问"
您的 API 密钥没有必要的权限。请创建一个具有标准或完整范围的新密钥。
"无效或已过期的 API 密钥"
- 验证密钥以
sk_开头 - 检查密钥是否未在设置 → API 密钥中被撤销
- 确保密钥未过期(如果您设置了过期日期)
速率限制
API 密钥受基于您订阅的速率限制:
- 免费版:32 次请求(终身)
- Plus 版:每小时 1,000 次请求