diff --git a/CHANGELOG.md b/CHANGELOG.md
index b122e8e1bbd..91ce5d227c1 100644
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -32,6 +32,7 @@ Docs: https://docs.openclaw.ai
 ### Fixes
 
 - Google Meet: grant Meet media permissions through the Playwright browser context when CDP grants do not affect the attached Chrome page, and report in-call microphone/speaker permission problems instead of marking realtime speech ready.
+- Google Chat: update the setup example to use the accepted `groups.<space>.enabled` key instead of the legacy `allow` alias, with a schema regression for the documented group shape. Thanks @vincentkoc.
 - Control UI/WebChat: collapse duplicate in-flight internal text sends onto the active Gateway run so rapid repeat submits do not start fresh `agent:main:main` dispatches. Fixes #75737. Thanks @dsdsddd1 and @BunsDev.
 - Mattermost: accept the documented `channels.mattermost.streaming` config and honor `streaming: "off"` by disabling draft preview posts. Thanks @vincentkoc.
 - Channels/streaming: expose `streaming.progress.label`, `labels`, `maxLines`, and `toolProgress` in bundled channel config metadata so progress draft settings appear in config, docs, and control surfaces. Thanks @vincentkoc.
diff --git a/docs/channels/googlechat.md b/docs/channels/googlechat.md
index d3c0ef95421..8701c11455f 100644
--- a/docs/channels/googlechat.md
+++ b/docs/channels/googlechat.md
@@ -192,7 +192,7 @@ Use these identifiers for delivery and allowlists:
       groupPolicy: "allowlist",
       groups: {
         "spaces/AAAA": {
-          allow: true,
+          enabled: true,
           requireMention: true,
           users: ["users/1234567890"],
           systemPrompt: "Short answers only.",
diff --git a/extensions/googlechat/src/config-schema.test.ts b/extensions/googlechat/src/config-schema.test.ts
index 93ab1d15d2a..df21a46d279 100644
--- a/extensions/googlechat/src/config-schema.test.ts
+++ b/extensions/googlechat/src/config-schema.test.ts
@@ -13,4 +13,19 @@ describe("googlechat config schema", () => {
 
     expect(result.success).toBe(true);
   });
+
+  it("accepts the documented group config shape", () => {
+    const result = GoogleChatConfigSchema.safeParse({
+      groups: {
+        "spaces/AAAA": {
+          enabled: true,
+          requireMention: true,
+          users: ["users/1234567890"],
+          systemPrompt: "Short answers only.",
+        },
+      },
+    });
+
+    expect(result.success).toBe(true);
+  });
 });