Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript

docs: Hermes off leaves a hand-pasted resolver entry for you to delete

garrytan210bcc78555c
diff --git a/changelog.d/capy-gbra435-pr2-hermes-pi.md b/changelog.d/capy-gbra435-pr2-hermes-pi.md
index b04e74dd3e..0b71075959 100644
--- a/changelog.d/capy-gbra435-pr2-hermes-pi.md
+++ b/changelog.d/capy-gbra435-pr2-hermes-pi.md
@@ -4,9 +4,9 @@
- Setup builds the `hermes-user` catalog from `$HERMES_HOME/skills` (nested category folders included) and adds the resolver's `pre_llm_call` entry to gbrain's marked `hooks:` block in `$HERMES_HOME/config.yaml`, approving it in Hermes's `shell-hooks-allowlist.json`. The block also carries the brain-first turn rule. Each feature adds and removes only its own entry: `--no-instructions` keeps the resolver, `--skill-loading off` keeps the turn rule, and the block goes when its last entry does. An existing install's turn-rule block is left byte for byte as it was.
- The command runs without a shell, the way Hermes runs hooks: `/usr/bin/env GBRAIN_HOOK_LANE=skill-resolver <launcher> <gbrain> hook user-prompt --harness hermes`.
-- If your config.yaml already has its own `hooks:` section, setup refuses and prints the entry to paste under it. Once you paste it, the next run approves and keeps it. A Hermes with no SOUL.md still gets the resolver.
+- If your config.yaml already has its own `hooks:` section, setup refuses and prints the entry to paste under it. Once you paste it, the next run approves and keeps it. `--skill-loading off` withdraws that approval but leaves your own section alone, so delete the pasted entry yourself. A Hermes with no SOUL.md still gets the resolver.
- Hermes compacts conversations in place and tells hooks nothing about it. The lane now starts a session's dedupe fresh on a first turn, or when the conversation history is shorter than it was on the last turn, so skills offered before a compaction can be offered again. It reads the history's length in the same streaming pass, so a large history still costs about one JSON parse.
-- `gbrain config set skills.resolver.per_harness.hermes.owner_sender_ids <id>,<id>` limits suggestions to turns from those senders, using the same rule as the OpenClaw plugin: a turn from anyone else, or with no sender, gets no block.
+- `gbrain config set skills.resolver.per_harness.hermes.owner_sender_ids <id>,<id>` limits suggestions to turns from those senders, using the same rule as the OpenClaw plugin. A turn from anyone else, or with no sender, gets no block.
- Pinned skills for Hermes (`gbrain skills pin add <id> --catalog hermes-user`) go in a marked block in `$HERMES_HOME/SOUL.md` while the resolver is on. With no pins there is no block, and SOUL.md is never created.
- `gbrain doctor`'s `skill_resolver` check now covers Hermes, and warns when Hermes's allowlist no longer approves the hook.
diff --git a/docs/guides/skill-resolver.md b/docs/guides/skill-resolver.md
index d72b59f9ae..c042c19b3e 100644
--- a/docs/guides/skill-resolver.md
+++ b/docs/guides/skill-resolver.md
@@ -106,7 +106,8 @@ with `/usr/bin/env`:
`/usr/bin/env GBRAIN_HOOK_LANE=skill-resolver <launcher> /abs/path/to/gbrain hook user-prompt --harness hermes`.
When config.yaml already has a `hooks:` section of yours, setup refuses with
the entry to paste under it; once pasted, the next run approves and keeps it.
-A Hermes with no SOUL.md still gets the resolver. `hermes hooks doctor` checks
+`--skill-loading off` withdraws that approval but leaves your own section
+alone, so delete the pasted entry yourself. A Hermes with no SOUL.md still gets the resolver. `hermes hooks doctor` checks
the entry on the Hermes host, and gbrain's doctor `skill_resolver` check
covers Hermes.
diff --git a/scripts/structural-suites.tsv b/scripts/structural-suites.tsv
index 577aa8f426..0a0f8528a9 100644
--- a/scripts/structural-suites.tsv
+++ b/scripts/structural-suites.tsv
@@ -378,7 +378,7 @@ test/serve-http-github-webhook.test.ts handler wiring (source pin) 1 source-surf
test/serve-http-mcp-transport-cleanup.test.ts POST /mcp transport cleanup (#2844) 2 source-surface-helper
test/serve-http-metrics.test.ts serve-http.ts wiring (structural — the two defects of the original PR) 2 source-surface-helper
test/serve-stdin-eof-drain.test.ts serve-sync-runner stays off the boot path (#4409) 1 readFileSync
-test/setup-pi-skill-extension.test.ts (file-level) 5 readFileSync
+test/setup-pi-skill-extension.test.ts (file-level) 6 readFileSync
test/setup-serves-several.test.ts gbrain setup --serves (spawned, PGLite) 11 readFileSync
test/setup-serves-several.test.ts labelling refuses or reports what it cannot make safe (pglite, repo-less) 8 readFileSync
test/setup.test.ts gbrain setup: setup migrations on the brain it creates (Cat 41 run 4) 3 readFileSync