# 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 中共享日历给服务账号邮箱。

## 安全提示

- ⚠️ 凭证文件包含私钥，请妥善保管
- ⚠️ 不要将凭证文件提交到版本控制
- ✅ 使用服务账号而非个人账号进行自动化操作
- ✅ 定期轮换服务账号密钥