Skip to content

Garry's Opinionated OpenClaw/Hermes Agent Brain

TypeScript

docs(skills): v0.9.0 migration Step 4 sets object storage in the config file, documents endpoint for R2/MinIO, and separates it from storage status (#7346)

garrytan9f3c2aa203a7
diff --git a/skills/migrations/v0.9.0.md b/skills/migrations/v0.9.0.md
index 1500107253..f445967053 100644
--- a/skills/migrations/v0.9.0.md
+++ b/skills/migrations/v0.9.0.md
@@ -166,23 +166,29 @@ gbrain report --type migration \
### Step 4: Configure storage backend (if not already done)
If your brain repo has binary files (images, PDFs, audio, video), configure
-cloud storage to keep git lean:
+cloud storage to keep git lean. `gbrain files` reads one `storage` object from
+`~/.gbrain/config.json` (`$GBRAIN_HOME/.gbrain/config.json`). `gbrain config set
+storage.<field>` refuses as an unknown key, and `gbrain config set storage '<json>'`
+stores a database row that `gbrain files` does not read, so add the object to
+that file. Supabase Storage (recommended if you already use Supabase):
-```bash
-# Supabase Storage (recommended if you already use Supabase)
-gbrain config set storage.backend supabase
-gbrain config set storage.bucket brain-files
-gbrain config set storage.projectUrl https://YOUR-PROJECT.supabase.co
-gbrain config set storage.serviceRoleKey YOUR_SERVICE_ROLE_KEY
-
-# Or S3-compatible (AWS, Cloudflare R2, MinIO)
-gbrain config set storage.backend s3
-gbrain config set storage.bucket brain-files
-gbrain config set storage.region us-east-1
-gbrain config set storage.accessKeyId YOUR_KEY
-gbrain config set storage.secretAccessKey YOUR_SECRET
+```json
+"storage": { "backend": "supabase", "bucket": "brain-files", "projectUrl": "https://YOUR-PROJECT.supabase.co", "serviceRoleKey": "YOUR_SERVICE_ROLE_KEY" }
```
+Or S3-compatible (AWS S3, Cloudflare R2, MinIO):
+
+```json
+"storage": { "backend": "s3", "bucket": "brain-files", "region": "us-east-1", "accessKeyId": "YOUR_KEY", "secretAccessKey": "YOUR_SECRET" }
+```
+
+For R2 or MinIO, add `"endpoint"` with the server URL (for example
+`"endpoint": "http://127.0.0.1:9000"`); with an endpoint set, gbrain uses
+path-style bucket addressing. `gbrain config get storage` prints the object
+with the credentials masked. `gbrain storage status` is a different feature:
+it reports page tiering from `gbrain.yml` (which pages live in git or only in
+the database), not this backend.
+
Then migrate existing binaries:
```bash
gbrain files status
diff --git a/skills/skills.lock.json b/skills/skills.lock.json
index d4847e6e3d..c8f84932b6 100644
--- a/skills/skills.lock.json
+++ b/skills/skills.lock.json
@@ -187,7 +187,7 @@
"migrations/v0.7.0.md": "97c2740445a10b1c5c7123c17dbd625fa27a94095b85d27c2b278da756c4c59a",
"migrations/v0.8.0.md": "1919ff8b8f3680612ff888e7cfcc0d86ece5d5304ae19af4497bdf40b050561a",
"migrations/v0.8.1.md": "fad7341cfb5e02545fb8a23221d12ab395fc3d8db15d1d8ee8a18844aea6563a",
- "migrations/v0.9.0.md": "773fab0a8d7f330576265a3f510c1f318f47789b6136c46d43e08121acbc20eb",
+ "migrations/v0.9.0.md": "733914417aca16e476d9ab76044380a5ff83039a81f9b541dd47c7be0083bc4d",
"migrations/v0.9.1.md": "75761bad6c0ad37b69ec8197c6a678bb6a1484f9a76e4b70f2d1e86dc80102b3",
"minion-orchestrator/SKILL.md": "9522cf2a740ab92f58a46dc054703649724f97dd080c699310cadcf4307d8e54",
"minion-orchestrator/routing-eval.jsonl": "501ed2e19cb16847ff8425219d246b7a774de1accd42cb28fd44edbb64204992",