|
|
|
|
|
# Google Calendar Skill
|
|
|
|
|
|
|
|
|
|
|
|
## 功能说明
|
|
|
|
|
|
|
|
|
|
|
|
为 OpenClaw 提供 Google Calendar 集成，支持：
|
|
|
|
|
|
- ✅ 读取日历事件（今日/明日/本周）
|
|
|
|
|
|
- ✅ 创建新事件
|
|
|
|
|
|
- ✅ 删除事件
|
|
|
|
|
|
- ✅ 多时区支持
|
|
|
|
|
|
- ✅ 服务账号认证
|
|
|
|
|
|
|
|
|
|
|
|
## 安装
|
|
|
|
|
|
|
|
|
|
|
|
### 1. 安装 Python 依赖
|
|
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
|
pip install google-auth google-api-python-client
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
或在 skill 目录执行：
|
|
|
|
|
|
```bash
|
|
|
|
|
|
cd /root/.openclaw/workspace/skills/google-calendar
|
|
|
|
|
|
pip install -r requirements.txt
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
### 2. 配置凭证
|
|
|
|
|
|
|
|
|
|
|
|
凭证文件位置：`/root/.openclaw/credentials/google-calendar-life.json`
|
|
|
|
|
|
|
|
|
|
|
|
**获取凭证步骤：**
|
|
|
|
|
|
1. 访问 https://console.cloud.google.com/
|
|
|
|
|
|
2. 创建或选择 Google Cloud 项目
|
|
|
|
|
|
3. 启用 Google Calendar API
|
|
|
|
|
|
4. 创建服务账号 (Service Account)
|
|
|
|
|
|
5. 下载 JSON 密钥文件
|
|
|
|
|
|
6. 将内容保存到凭证文件
|
|
|
|
|
|
7. 共享目标日历给服务账号邮箱（格式：`xxx@xxx.iam.gserviceaccount.com`）
|
|
|
|
|
|
|
|
|
|
|
|
### 3. 启用 Skill
|
|
|
|
|
|
|
|
|
|
|
|
编辑 `/root/.openclaw-life/openclaw.json`（张大师配置）或 `/root/.openclaw/openclaw.json`（主配置）：
|
|
|
|
|
|
|
|
|
|
|
|
```json
|
|
|
|
|
|
{
|
|
|
|
|
|
"skills": {
|
|
|
|
|
|
"entries": {
|
|
|
|
|
|
"google-calendar": {
|
|
|
|
|
|
"enabled": true
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
}
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 配置
|
|
|
|
|
|
|
|
|
|
|
|
编辑 `config.yaml`：
|
|
|
|
|
|
|
|
|
|
|
|
```yaml
|
|
|
|
|
|
credentials_path: /root/.openclaw/credentials/google-calendar-life.json
|
|
|
|
|
|
timezone: Asia/Shanghai
|
|
|
|
|
|
calendar_id: primary # 或具体日历 ID
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 命令
|
|
|
|
|
|
|
|
|
|
|
|
| 命令 | 说明 | 示例 |
|
|
|
|
|
|
|------|------|------|
|
|
|
|
|
|
| `/calendar today` | 查看今日日程 | `/calendar today` |
|
|
|
|
|
|
| `/calendar tomorrow` | 查看明日日程 | `/calendar tomorrow` |
|
|
|
|
|
|
| `/calendar week` | 查看本周日程 | `/calendar week` |
|
|
|
|
|
|
| `/calendar status` | 检查连接状态 | `/calendar status` |
|
|
|
|
|
|
| `/calendar add` | 添加新事件 | `/calendar add 明天 14:00 开会` |
|
|
|
|
|
|
| `/calendar help` | 显示帮助 | `/calendar help` |
|
|
|
|
|
|
|
|
|
|
|
|
## 编程接口
|
|
|
|
|
|
|
|
|
|
|
|
```python
|
|
|
|
|
|
from google_calendar import GoogleCalendarClient
|
|
|
|
|
|
|
|
|
|
|
|
client = GoogleCalendarClient(
|
|
|
|
|
|
credentials_path='/root/.openclaw/credentials/google-calendar-life.json',
|
|
|
|
|
|
timezone='Asia/Shanghai'
|
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
# 获取今日事件
|
|
|
|
|
|
events = client.get_today_events()
|
|
|
|
|
|
|
|
|
|
|
|
# 创建事件
|
|
|
|
|
|
from datetime import datetime
|
|
|
|
|
|
client.create_event(
|
|
|
|
|
|
summary='团队会议',
|
|
|
|
|
|
start_time=datetime(2026, 2, 24, 14, 0),
|
|
|
|
|
|
description='讨论项目进度'
|
|
|
|
|
|
)
|
|
|
|
|
|
|
|
|
|
|
|
# 测试连接
|
|
|
|
|
|
status = client.test_connection()
|
|
|
|
|
|
print(f"Connected: {status['connected']}")
|
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
|
|
## 依赖
|
|
|
|
|
|
|
|
|
|
|
|
- Python 3.8+
|
|
|
|
|
|
- google-auth
|
|
|
|
|
|
- google-api-python-client
|
|
|
|
|
|
|
|
|
|
|
|
## 故障排查
|
|
|
|
|
|
|
|
|
|
|
|
### 错误：Credentials file not found
|
|
|
|
|
|
检查凭证文件路径是否正确，文件是否存在。
|
|
|
|
|
|
|
|
|
|
|
|
### 错误：Failed to initialize Google Calendar service
|
|
|
|
|
|
- 确认凭证 JSON 格式正确
|
|
|
|
|
|
- 确认服务账号有 Calendar API 访问权限
|
|
|
|
|
|
- 确认目标日历已共享给服务账号
|
|
|
|
|
|
|
|
|
|
|
|
### 错误：googleapiclient.errors.HttpError: Forbidden
|
|
|
|
|
|
服务账号没有访问目标日历的权限。请在 Google Calendar 中共享日历给服务账号邮箱。
|
|
|
|
|
|
|
|
|
|
|
|
## 安全提示
|
|
|
|
|
|
|
|
|
|
|
|
- ⚠️ 凭证文件包含私钥，请妥善保管
|
|
|
|
|
|
- ⚠️ 不要将凭证文件提交到版本控制
|
|
|
|
|
|
- ✅ 使用服务账号而非个人账号进行自动化操作
|
|
|
|
|
|
- ✅ 定期轮换服务账号密钥
|
