插件概述
OpenClaw 车程费用追踪插件，用于追踪 Grab、Gojek 和 Zig (CDG) 的车程费用。支持手动记录、Gmail 收据同步和截图解析（实验性）。
安全注意事项 - Gmail 集成
读取权限：仅请求 Gmail 读取权限（gmail.readonly），用于提取车程收据邮件。
风险：OAuth 令牌以明文存储在
~/.openclaw/rides/tokens.json，理论上可读取所有邮件。建议仅在可信任的机器上使用，避免备份令牌文件。
主要功能
- 手动记录：通过自然语言输入记录车程（如“我从 Orchard 到 Bugis 乘 Grab，花费 15 美元”）
- Gmail 邮件同步：自动解析 Grab、Gojek 和 Zig 的车程收据邮件
- 截图解析：使用 Gemini Vision 从收据图片提取车程数据（实验性）
- 多币种支持：支持 SGD、USD、MYR，自动汇率归一化（使用 Frankfurter API）
- 预算跟踪：设置月度预算，配置警报阈值
- 消费统计：按提供商、类别或月份分解消费
- 快捷命令：
/rides、/rides_stats、/rides_sync、/rides_reset 等
- AI 代理集成：代理自动识别车程追踪工具
支持提供商
| 提供商 | 发件人邮箱 | 主题模式 | 备注 |
|---|
| Grab | no-reply@grab.com | 含“receipt” | 支持 SGD 和 MYR（MYR 为骨架实现） |
| Gojek | no-reply@invoicing.gojek.com | 含“trip”或“receipt” | 仅支持 SGD |
| Zig (CDG) | noreply@cdgtaxi.com.sg | 含“ride”或“receipt” | 仅支持 SGD，适用于 ComfortDelGro 出租车 |
安装
选项 A：从 ClawHub 安装
openclaw plugins install clawhub:openclaw-plugin-rides
openclaw gateway restart
选项 B：从源码安装（开发用）
git clone https://github.com/amdlahir/openclaw-plugin-rides.git
cd openclaw-plugin-rides
npm install
openclaw plugins install -l .
openclaw gateway restart
配置
| 键 | 是否必需 | 默认值 | 描述 |
|---|
googleClientId | 需要（Gmail 同步） | -- | Google OAuth2 客户端 ID |
googleClientSecret | 需要（Gmail 同步） | -- | Google OAuth2 客户端密钥 |
baseUrl | 需要（Gmail 同步） | -- | OpenClaw 实例 URL（OAuth 重定向） |
googleAiApiKey | 否 | -- | Google AI API 密钥（用于截图解析） |
defaultCurrency | 否 | SGD | 默认货币（SGD、USD、MYR） |
defaultCategory | 否 | personal | 默认类别（work、personal） |
设置 Google Cloud (Gmail 同步)
- 创建 Google Cloud 项目
- 启用 Gmail API
- 配置 OAuth 同意页面
- 添加测试用户
- 创建 OAuth2 凭据
- 将凭据添加到插件配置
- 连接 Gmail 账户
使用
AI 工具（通过聊天）
| 说什么 | 使用工具 |
|---|
| “我从 A 到 B 乘 Grab，花费 X” | log_ride |
| “显示我的最近车程” | list_rides |
| “我这个月花了多少？” | ride_spending_stats |
快捷命令
| 命令 | 描述 |
|---|
/rides | 显示最近 10 次车程 |
/rides_stats | 显示当前月份消费摘要和预算状态 |
/rides_sync | 触发 Gmail 同步 |
数据存储
- 数据库：
~/.openclaw/rides/rides.db (SQLite)
- OAuth 令牌：
~/.openclaw/rides/tokens.json
许可
MIT