luovicter-collab/openclaw-docs/gog

gog

Use gog for Gmail/Calendar/Drive/Contacts/Sheets/Docs.

本 workspace 已完成 OAuth 授权（openclaw.json 中 gog 已配置 GOG_ACCOUNT、GOG_KEYRING_PASSWORD）。不要对用户说「没配置 keyring 密码」或「需要先配置」——密码已在 openclaw 里，只是 exec 时 OpenClaw 不一定注入 gog 的 env，所以要用下面的方式保证能读到密码。

IMPORTANT (proxy + path): 必须用 workspace/bin/gog（全路径 /Users/victor/.openclaw/workspace/bin/gog），不要用裸的 gog。wrapper 会走 proxychains，并自动 source `workspace/config/gog.env`（若存在），因此只要该文件存在，就无需依赖 OpenClaw 注入 env。若曾报错「set GOG_KEYRING_PASSWORD」或「keyring 密码没有正确配置」，请运行一次：node ~/.openclaw/workspace/scripts/sync-gog-env-from-openclaw.js，会从 openclaw.json 同步 gog 的 env 到 config/gog.env，之后用 workspace/bin/gog 即可正常读任务列表等。

Setup (once，本机已做)

• gog auth credentials /path/to/client_secret.json
• gog auth add you@gmail.com --services gmail,calendar,drive,contacts,sheets,docs
• gog auth list

Common commands (use full path: /Users/victor/.openclaw/workspace/bin/gog)

• Tasks lists: /Users/victor/.openclaw/workspace/bin/gog tasks lists
• Gmail search: /Users/victor/.openclaw/workspace/bin/gog gmail search 'newer_than:7d' --max 10
• Gmail send: /Users/victor/.openclaw/workspace/bin/gog gmail send --to a@b.com --subject "Hi" --body "Hello"
• Calendar: /Users/victor/.openclaw/workspace/bin/gog calendar events <calendarId> --from <iso> --to <iso>
• Drive search: /Users/victor/.openclaw/workspace/bin/gog drive search "query" --max 10
• Contacts: /Users/victor/.openclaw/workspace/bin/gog contacts list --max 20
• Sheets get: /Users/victor/.openclaw/workspace/bin/gog sheets get <sheetId> "Tab!A1:D10" --json
• Docs export: /Users/victor/.openclaw/workspace/bin/gog docs export <docId> --format txt --out /tmp/doc.txt

Notes

• Set GOG_ACCOUNT=you@gmail.com to avoid repeating --account.
• Proxy (China): Use /Users/victor/.openclaw/workspace/bin/gog (proxychains wrapper) for Google API access.
• For scripting, prefer --json plus --no-input.
• Sheets values can be passed via --values-json (recommended) or as inline rows.
• Docs supports export/cat/copy. In-place edits require a Docs API client (not in gog).
• Confirm before sending mail or creating events.