OpenClaw Email & Calendar Orientation

Minimum Model

The Core Concept (Read This First)

There are two separate accounts:

These are separate. Having an agent email does NOT automatically give access to the owner's email or calendar.

To access the owner's email/calendar:

1. 1. Owner must share access with the agent email (explicit step).
2. Agent must authenticate using gog (explicit step).

If someone is confused → start with this distinction. It resolves most questions.

Key Paths and Files

Security rule: Never show the contents of these files in chat. Mentioning the path is fine; printing the content is not.

Using gog

CODEBLOCK0

Common Commands

CODEBLOCK1

Calendar Write Access — Step by Step

The most common issue: the agent can read the calendar but not create events.

Step 1 — Owner does this:

1. 1. Open calendar.google.com.
2. Find the primary calendar → three-dot menu → Settings and sharing.
3. Click "+ Add people" → enter the agent email.
4. Set permission to "Make changes to events" (not "See all event details").
5. Click Send.

Step 2 — Agent does this:
CODEBLOCK2

If the test event appears in the owner's calendar → success.

Troubleshooting

Work through these checks in order:

1. 1. Clarify accounts: Is the question about agent email or owner email?
2. Check gog is installed: Run which gog — if not found, check PATH.
3. Check account was added: Run gog auth list — does owner's account appear?
4. Check write scope: OAuth must include calendar write scope, not just read.
5. Check keyring: If gog asks for a password, local keyring may need to be configured.
6. Check GOG_ACCOUNT: All commands must include GOG_ACCOUNT=owner@company.com.
7. Calendar write failures: Was permission set to "Make changes to events" (not "See details")?

If "Insufficient permissions" error:
→ Owner shared calendar with read-only access. Redo Step 1 with the correct permission level.

If "Token expired" error:

# Remove the expired account
gog auth remove owner@company.com

# Re-add it (will open browser for re-auth)
gog auth add owner@company.com --services gmail,calendar,drive,contacts

Response Style

• - Lead with the owner vs. agent distinction — this resolves most confusion.
• Give commands first, explanation second.
• When asked "where is X stored?" → give the path, do not print the file contents.
• When asked for step-by-step → follow the Calendar Write Access section above.

Cost Tips

• - Very cheap: This skill is explanation only — minimal LLM tokens needed.
• Small model OK: Any model can explain these concepts and provide commands.
• Avoid: Do not re-explain the full orientation every time. Ask what specifically is confusing, then address only that.