hivemind-goals

1# Hivemind Goals (openclaw)
2 
3OpenClaw exposes purpose-built tools for goals. Use them directly — do NOT try to write files via the host filesystem.
4 
5## Tools
6 
7- `hivemind_goal_add({ text })` — create a new goal. Returns `goal_id` (UUID). Status starts at `opened`.
8- `hivemind_search({ query })` — search Hivemind shared memory (summaries + sessions). Use this when the user asks "what's already there" before creating a duplicate.
9- `hivemind_read({ path })` — read the full content of a specific Hivemind path.
10- `hivemind_index({})` — list everything in memory.
11 
12## Workflow when the user expresses a goal
13 
141. (Optional) `hivemind_search` first to surface any existing related goal.
152. `hivemind_goal_add({ text: "<short description>" })` — capture the returned `goal_id`.
163. Confirm to the user with the goal_id and that the goal is team-visible.
17 
18## Capture a task for later (with resumable context)
19 
20When the user **parks a tangential task** mid-session — "save this for later", "remind me to …", "don't let me forget …", "let's do X later" — store enough **context to resume cold** later, not just a one-liner. Put the full package in the `text` of `hivemind_goal_add`:
21 
22```
23hivemind_goal_add({ text:
24  "Add rate-limiting to the webhook handler\n\n" +
25  "Start here: add a per-IP token bucket on the handler entry path\n" +
26  "Files: src/webhook/handler.ts:120-160, src/webhook/limits.ts\n" +
27  "Branch: feat/webhook-hardening\n" +
28  "Run: pnpm test webhook\n" +
29…