From 8e2e6ffeb310d7a639c6cd254c9bffac5b611f43 Mon Sep 17 00:00:00 2001
From: Harivansh Rathi <rathiharivansh@gmail.com>
Date: Sat, 4 Apr 2026 15:32:45 +0000
Subject: [PATCH] openclaw new md files

---
 config/openclaw/HEARTBEAT.md | 20 +++++++++++++++++++
 config/openclaw/TOOLS.md     | 38 ++++++++++++++++++++++++++++++++++++
 home/openclaw.nix            |  2 ++
 3 files changed, 60 insertions(+)
 create mode 100644 config/openclaw/HEARTBEAT.md
 create mode 100644 config/openclaw/TOOLS.md

diff --git a/config/openclaw/HEARTBEAT.md b/config/openclaw/HEARTBEAT.md
new file mode 100644
index 0000000..5305526
--- /dev/null
+++ b/config/openclaw/HEARTBEAT.md
@@ -0,0 +1,20 @@
+# Heartbeat Checklist
+
+Check these on each heartbeat (rotate, don't do all every time):
+
+## Email (gws gmail)
+- Check unread/recent emails (last 2 hours)
+- Flag anything urgent or action-required
+- Summarize important ones for the human
+- Ignore: marketing, newsletters, automated notifications (unless they look important)
+
+## Calendar (gws calendar)
+- Check events in the next 24 hours
+- Alert if something is coming up within 2 hours
+- Note any conflicts or back-to-back meetings
+
+## Rules
+- Late night (23:00-08:00 local): only surface truly urgent stuff
+- Don't repeat things you already surfaced in the last check
+- Keep summaries short — one line per item max
+- If nothing important: HEARTBEAT_OK
diff --git a/config/openclaw/TOOLS.md b/config/openclaw/TOOLS.md
new file mode 100644
index 0000000..51a9e8c
--- /dev/null
+++ b/config/openclaw/TOOLS.md
@@ -0,0 +1,38 @@
+# Google Workspace (gws)
+
+## Permissions
+
+### Read freely (no permission needed)
+- Gmail: read, search, list emails
+- Calendar: check events, upcoming schedule, free/busy
+- Drive: list and read files
+
+### Ask first
+- Gmail: sending, replying, drafting emails
+- Calendar: creating, editing, deleting events
+- Drive: editing, moving, uploading files
+
+### Never without explicit permission
+- Deleting anything (emails, events, files)
+- Sending emails on behalf of the user
+- Sharing files/folders with others
+- Changing account settings
+
+## Quick Reference
+
+Gmail:
+  gws gmail users messages list --params '{"userId": "me", "maxResults": 10}'
+  gws gmail users messages get --params '{"userId": "me", "id": "<id>", "format": "metadata", "metadataHeaders": ["Subject", "From", "Date"]}'
+  gws gmail users messages get --params '{"userId": "me", "id": "<id>", "format": "full"}'
+
+Calendar:
+  gws calendar events list --params '{"calendarId": "primary", "timeMin": "<RFC3339>", "timeMax": "<RFC3339>", "singleEvents": true, "orderBy": "startTime"}'
+
+## Browser Use
+
+API key stored in ~/.bashrc as BROWSER_USE_API_KEY
+Endpoint: POST https://api.browser-use.com/api/v3/sessions
+Auth header: X-Browser-Use-API-Key
+
+Use for web tasks that need a real browser (login flows, scraping, form filling).
+Always ask before using on sites that require the user's credentials.
diff --git a/home/openclaw.nix b/home/openclaw.nix
index aad815e..7b2a4d4 100644
--- a/home/openclaw.nix
+++ b/home/openclaw.nix
@@ -32,4 +32,6 @@ lib.mkIf hostConfig.isLinux {
   '';
 
   home.file.".openclaw/workspace/SOUL.md".source = ../config/openclaw/SOUL.md;
+  home.file.".openclaw/workspace/TOOLS.md".source = ../config/openclaw/TOOLS.md;
+  home.file.".openclaw/workspace/HEARTBEAT.md".source = ../config/openclaw/HEARTBEAT.md;
 }