From 0c4e08ea0ff0d99c2697b5c2cb21516798c92ee9 Mon Sep 17 00:00:00 2001
From: Suvin Nimnaka <suvin@wso2.com>
Date: Mon, 2 Feb 2026 19:28:19 +0530
Subject: [PATCH] Fix review comments

---
 docs/channels/imessage.md             | 4 +---
 docs/concepts/architecture.md         | 1 -
 docs/gateway/remote-gateway-readme.md | 2 --
 docs/gateway/security/index.md        | 5 ++---
 docs/start/openclaw.md                | 7 ++++++-
 5 files changed, 9 insertions(+), 10 deletions(-)

diff --git a/docs/channels/imessage.md b/docs/channels/imessage.md
index fc11b5c05dd..296e5775f2c 100644
--- a/docs/channels/imessage.md
+++ b/docs/channels/imessage.md
@@ -172,7 +172,6 @@ If the Gateway runs on a Linux host/VM but iMessage must run on a Mac, Tailscale
 
 Architecture:
 
-<p align="center">
 ```mermaid
 %%{init: {
   'theme': 'base',
@@ -200,10 +199,9 @@ flowchart TB
     Gateway -- SSH (imsg rpc) --> Mac
     Mac -- SCP (attachments) --> Gateway
     direction BT
-    User["user@gateway-host"] -- "<span style=color:>Tailscale tailnet (hostname or 100.x.y.z)</span>" --> Gateway
+    User["user@gateway-host"] -- "Tailscale tailnet (hostname or 100.x.y.z)" --> Gateway
 end
 ```
-</p>
 
 Concrete config example (Tailscale hostname):
 
diff --git a/docs/concepts/architecture.md b/docs/concepts/architecture.md
index d9965f2dea8..a5c17eae83d 100644
--- a/docs/concepts/architecture.md
+++ b/docs/concepts/architecture.md
@@ -55,7 +55,6 @@ Protocol details:
 
 ## Connection lifecycle (single client)
 
-<p align="center">
 ```mermaid
 %%{init: {
   'theme': 'base',
diff --git a/docs/gateway/remote-gateway-readme.md b/docs/gateway/remote-gateway-readme.md
index 0640c1fc971..8fa9cd1f097 100644
--- a/docs/gateway/remote-gateway-readme.md
+++ b/docs/gateway/remote-gateway-readme.md
@@ -10,7 +10,6 @@ OpenClaw.app uses SSH tunneling to connect to a remote gateway. This guide shows
 
 ## Overview
 
-<p align="center">
 ```mermaid
 %%{init: {
   'theme': 'base',
@@ -47,7 +46,6 @@ flowchart TB
     end
     T --> C
 ```
-</p>
 
 ## Quick Setup
 
diff --git a/docs/gateway/security/index.md b/docs/gateway/security/index.md
index 904b536b9cd..570952ad326 100644
--- a/docs/gateway/security/index.md
+++ b/docs/gateway/security/index.md
@@ -797,7 +797,6 @@ Commit the updated `.secrets.baseline` once it reflects the intended state.
 
 ## The Trust Hierarchy
 
-<p align="center">
 ```mermaid
 %%{init: {
   'theme': 'base',
@@ -821,11 +820,11 @@ flowchart TB
     C -- Limited trust --> D["Strangers"]
     D -- No trust --> E["Mario asking for find ~"]
     E -- Definitely no trust 😏 --> F[" "]
-
+    
+     %% The transparent box is needed to show the bottom-most label correctly
      F:::Class_transparent_box
     classDef Class_transparent_box fill:transparent, stroke:transparent
 ```
-</p>
 
 ## Reporting Security Issues
 
diff --git a/docs/start/openclaw.md b/docs/start/openclaw.md
index 4518a9fdca4..70e06810fcb 100644
--- a/docs/start/openclaw.md
+++ b/docs/start/openclaw.md
@@ -1,5 +1,10 @@
 ---
-summary: "End-to-end guide for running OpenClaw as a personal assistant with safety cautions"
+summary: "End-to-end guide for running OpenClaw as a personal assist    B -- linked via QR --> C["<b>Your Mac (openclaw)<br></b><br>Pi agent"]
+```
+
+If you link your personal WhatsApp to OpenClaw, every message to you becomes "agent input". That's rarely what you want.
+
+## 5-minute quick starth safety cautions"
 read_when:
   - Onboarding a new assistant instance
   - Reviewing safety/permission implications