Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript

docs(qm): use the attest client only for the personal-scope memory route, never a model-callable connector or a shared-scope route

garrytan48a2888ac132
diff --git a/docs/guides/qm.md b/docs/guides/qm.md
index f2f0859320..48995fe2dd 100644
--- a/docs/guides/qm.md
+++ b/docs/guides/qm.md
@@ -23,6 +23,14 @@ A client whose `bound_slug_prefixes` do not cover `memory/members/<member>` is r
Links and the right are database state, so a repo-less brain works the same; where
a repo exists, saved facts go through the same git-first writer door as `remember`.
+Use the attest client only for QM's personal-scope memory route. An attested call
+reads as the named person, including their own private facts and pages only they
+may read, and gbrain cannot tell which conversation the answer goes to. Don't
+register the client as a model-callable MCP connector in QM, and don't route it to
+shared scopes (channels, groups, projects, teams, the org): either can show one
+person's private facts to a whole room. Shared conversations wait for
+`x-qm-audience` (wave 2).
+
## What the tools do
- `memory_recall {query, max_chars?}` answers plain text, one fact per line
diff --git a/docs/mcp/ADMIN.md b/docs/mcp/ADMIN.md
index 6f04e3daab..dd9456a4c9 100644
--- a/docs/mcp/ADMIN.md
+++ b/docs/mcp/ADMIN.md
@@ -260,6 +260,10 @@ only a fact on the person's own page (also for a credential bound to a member).
A request carrying `x-qm-audience` is refused (`audience_not_supported`). Not attestable yet, because what they
read or write is not yet kept to the person: `list_write_conflicts`, `capture`,
`extract_facts` and `takes_add|update|resolve|supersede`.
+An attested read sees what that person sees, private facts included, and gbrain
+cannot tell who else reads the answer. Use the attest client only for QM's
+personal-scope memory route: never register it as a model-callable MCP connector
+or route it to shared scopes ([QM guide](../guides/qm.md#set-up-on-the-brain-host)).
`gbrain access check --token <name>` shows the
result ([Model C](../tutorials/company-brain.md#two-scoping-models-pick-the-one-that-matches-your-shape)).