diff --git a/.github/workflows/ci.yml b/.github/workflows/ci.yml
index 974670957b57..36d84299f1ad 100644
--- a/.github/workflows/ci.yml
+++ b/.github/workflows/ci.yml
@@ -342,7 +342,7 @@ jobs:
         run: ${{ matrix.command }}
 
   macos-app:
-    if: github.event_name == 'pull_request'
+    if: github.event_name == 'pull_request' && github.repository_owner == 'openclaw'
     runs-on: macos-latest
     strategy:
       fail-fast: false
diff --git a/.github/workflows/claude.yml b/.github/workflows/claude.yml
new file mode 100644
index 000000000000..ca24bf7aa211
--- /dev/null
+++ b/.github/workflows/claude.yml
@@ -0,0 +1,30 @@
+name: Claude Code
+
+on:
+  issues:
+    types: [opened, edited]
+  issue_comment:
+    types: [created, edited]
+
+jobs:
+  claude:
+    runs-on: ubuntu-latest
+    # Only run when @claude is mentioned in issues/comments
+    if: contains(github.event.comment.body, '@claude') || contains(github.event.issue.body, '@claude')
+    steps:
+      - name: Checkout
+        uses: actions/checkout@v4
+        with:
+          fetch-depth: 0
+          
+      - name: Run Claude Code
+        uses: anthropics/claude-code-action@v1
+        with:
+          prompt: |
+            ${{ github.event.comment.body || github.event.issue.body }}
+          claude_args: |
+            --max-turns 10
+        env:
+          # Use OAuth token for Claude Max/Pro subscription (no API key needed)
+          CLAUDE_CODE_OAUTH_TOKEN: ${{ secrets.CLAUDE_CODE_OAUTH_TOKEN }}
+          GITHUB_TOKEN: ${{ secrets.GITHUB_TOKEN }}
diff --git a/.github/workflows/labeler.yml b/.github/workflows/labeler.yml
index f403c1030c02..1368bbaf45c5 100644
--- a/.github/workflows/labeler.yml
+++ b/.github/workflows/labeler.yml
@@ -10,6 +10,7 @@ permissions: {}
 
 jobs:
   label:
+    if: github.repository_owner == 'openclaw' && secrets.GH_APP_PRIVATE_KEY != ''
     permissions:
       contents: read
       pull-requests: write
@@ -48,6 +49,7 @@ jobs:
             });
 
   label-issues:
+    if: github.repository_owner == 'openclaw' && secrets.GH_APP_PRIVATE_KEY != ''
     permissions:
       issues: write
     runs-on: ubuntu-latest
diff --git a/extensions/memory-lancedb/index.ts b/extensions/memory-lancedb/index.ts
index 5e4def80fa2e..47ecbb1cd563 100644
--- a/extensions/memory-lancedb/index.ts
+++ b/extensions/memory-lancedb/index.ts
@@ -6,8 +6,8 @@
  * Provides seamless auto-recall and auto-capture via lifecycle hooks.
  */
 
+import type * as LanceDB from "@lancedb/lancedb";
 import type { OpenClawPluginApi } from "openclaw/plugin-sdk";
-import * as lancedb from "@lancedb/lancedb";
 import { Type } from "@sinclair/typebox";
 import { randomUUID } from "node:crypto";
 import OpenAI from "openai";
@@ -44,8 +44,9 @@ type MemorySearchResult = {
 const TABLE_NAME = "memories";
 
 class MemoryDB {
-  private db: lancedb.Connection | null = null;
-  private table: lancedb.Table | null = null;
+  private lancedb: typeof import("@lancedb/lancedb") | null = null;
+  private db: LanceDB.Connection | null = null;
+  private table: LanceDB.Table | null = null;
   private initPromise: Promise<void> | null = null;
 
   constructor(
@@ -65,7 +66,21 @@ class MemoryDB {
     return this.initPromise;
   }
 
+  private async getLanceDB(): Promise<typeof import("@lancedb/lancedb")> {
+    if (this.lancedb) return this.lancedb;
+    try {
+      this.lancedb = await import("@lancedb/lancedb");
+      return this.lancedb;
+    } catch (err) {
+      // LanceDB currently ships platform-specific native deps. Fail gracefully on unsupported platforms.
+      throw new Error(
+        `memory-lancedb: LanceDB native module unavailable on ${process.platform}/${process.arch}: ${String(err)}`,
+      );
+    }
+  }
+
   private async doInitialize(): Promise<void> {
+    const lancedb = await this.getLanceDB();
     this.db = await lancedb.connect(this.dbPath);
     const tables = await this.db.tableNames();
 
diff --git a/hooks/logs/hooks.jsonl b/hooks/logs/hooks.jsonl
new file mode 100644
index 000000000000..52b9b613c819
--- /dev/null
+++ b/hooks/logs/hooks.jsonl
@@ -0,0 +1 @@
+{"timestamp":"2026-02-07T03:11:12.846Z","level":"debug","hook":"voice-macos","event":"voice","message":"Speech completed"}
diff --git a/src/channels/plugins/catalog.ts b/src/channels/plugins/catalog.ts
index e5774fba724f..35d0f12ac6fc 100644
--- a/src/channels/plugins/catalog.ts
+++ b/src/channels/plugins/catalog.ts
@@ -12,6 +12,9 @@ export type ChannelUiMetaEntry = {
   label: string;
   detailLabel: string;
   systemImage?: string;
+  description?: string;
+  docsPath?: string;
+  docsLabel?: string;
 };
 
 export type ChannelUiCatalog = {
@@ -242,6 +245,9 @@ export function buildChannelUiCatalog(
       label: plugin.meta.label,
       detailLabel,
       ...(plugin.meta.systemImage ? { systemImage: plugin.meta.systemImage } : {}),
+      ...(plugin.meta.blurb ? { description: plugin.meta.blurb } : {}),
+      ...(plugin.meta.docsPath ? { docsPath: plugin.meta.docsPath } : {}),
+      ...(plugin.meta.docsLabel ? { docsLabel: plugin.meta.docsLabel } : {}),
     };
   });
   const order = entries.map((entry) => entry.id);
diff --git a/src/channels/plugins/types.plugin.ts b/src/channels/plugins/types.plugin.ts
index 044cbd5864d0..306aed15c79b 100644
--- a/src/channels/plugins/types.plugin.ts
+++ b/src/channels/plugins/types.plugin.ts
@@ -33,10 +33,32 @@ import type {
 export type ChannelConfigUiHint = {
   label?: string;
   help?: string;
+  group?: string;
+  order?: number;
   advanced?: boolean;
   sensitive?: boolean;
   placeholder?: string;
   itemTemplate?: unknown;
+  docsPath?: string;
+  impacts?: Array<{
+    relation?: "requires" | "conflicts" | "recommends" | "risk";
+    targetPath?: string;
+    when?: "truthy" | "falsy" | "defined" | "notDefined" | "equals" | "notEquals" | "includes";
+    whenValue?: unknown;
+    targetWhen?:
+      | "truthy"
+      | "falsy"
+      | "defined"
+      | "notDefined"
+      | "equals"
+      | "notEquals"
+      | "includes";
+    targetValue?: unknown;
+    message: string;
+    fixValue?: unknown;
+    fixLabel?: string;
+    docsPath?: string;
+  }>;
 };
 
 export type ChannelConfigSchema = {
diff --git a/src/cli/gateway-cli/run-loop.ts b/src/cli/gateway-cli/run-loop.ts
index 9cdcf18652a1..42ab87c3da7d 100644
--- a/src/cli/gateway-cli/run-loop.ts
+++ b/src/cli/gateway-cli/run-loop.ts
@@ -39,7 +39,7 @@ export async function runGatewayLoop(params: {
       gatewayLog.error("shutdown timed out; exiting without full cleanup");
       cleanupSignals();
       params.runtime.exit(0);
-    }, 5000);
+    }, 15_000);
 
     void (async () => {
       try {
diff --git a/src/config/schema.test.ts b/src/config/schema.test.ts
index f7f90f37e47e..24b928fd70e5 100644
--- a/src/config/schema.test.ts
+++ b/src/config/schema.test.ts
@@ -101,4 +101,30 @@ describe("config schema", () => {
     expect(defaultsHint?.help).toContain("last");
     expect(listHint?.help).toContain("bluebubbles");
   });
+
+  it("adds docs and impact metadata for high-risk settings", () => {
+    const res = buildConfigSchema({
+      channels: [
+        {
+          id: "discord",
+          label: "Discord",
+          description: "Discord bot channel",
+          docsPath: "/channels/discord",
+          configSchema: { type: "object" },
+        },
+      ],
+    });
+
+    expect(res.uiHints["gateway.mode"]?.docsPath).toBe("/web/dashboard");
+    expect(res.uiHints["gateway.mode"]?.impacts?.length).toBeGreaterThan(0);
+    expect(res.uiHints["channels.discord"]?.docsPath).toBe("/channels/discord");
+    expect(res.uiHints["channels.discord.actions.roles"]?.docsPath).toBe("/channels/discord");
+    expect(res.uiHints["channels.discord.actions.roles"]?.impacts?.[0]?.relation).toBe("requires");
+    expect(res.uiHints["channels.*.allowBots"]?.docsPath).toBe("/gateway/configuration");
+    expect(res.uiHints["channels.*.allowBots"]?.impacts?.[0]?.relation).toBe("risk");
+    expect(res.uiHints["channels.*.dm.policy"]?.impacts?.[0]?.targetPath).toBe(
+      "channels.*.dm.allowFrom",
+    );
+    expect(res.uiHints["channels.telegram.streamMode"]?.impacts?.[0]?.relation).toBe("conflicts");
+  });
 });
diff --git a/src/config/schema.ts b/src/config/schema.ts
index a9c177c82490..34d6baa1b326 100644
--- a/src/config/schema.ts
+++ b/src/config/schema.ts
@@ -11,6 +11,21 @@ export type ConfigUiHint = {
   sensitive?: boolean;
   placeholder?: string;
   itemTemplate?: unknown;
+  docsPath?: string;
+  impacts?: ConfigUiHintImpact[];
+};
+
+export type ConfigUiHintImpact = {
+  relation?: "requires" | "conflicts" | "recommends" | "risk";
+  targetPath?: string;
+  when?: "truthy" | "falsy" | "defined" | "notDefined" | "equals" | "notEquals" | "includes";
+  whenValue?: unknown;
+  targetWhen?: "truthy" | "falsy" | "defined" | "notDefined" | "equals" | "notEquals" | "includes";
+  targetValue?: unknown;
+  message: string;
+  fixValue?: unknown;
+  fixLabel?: string;
+  docsPath?: string;
 };
 
 export type ConfigUiHints = Record<string, ConfigUiHint>;
@@ -32,7 +47,19 @@ export type PluginUiMetadata = {
   description?: string;
   configUiHints?: Record<
     string,
-    Pick<ConfigUiHint, "label" | "help" | "advanced" | "sensitive" | "placeholder">
+    Pick<
+      ConfigUiHint,
+      | "label"
+      | "help"
+      | "group"
+      | "order"
+      | "advanced"
+      | "sensitive"
+      | "placeholder"
+      | "itemTemplate"
+      | "docsPath"
+      | "impacts"
+    >
   >;
   configSchema?: JsonSchemaNode;
 };
@@ -41,6 +68,7 @@ export type ChannelUiMetadata = {
   id: string;
   label?: string;
   description?: string;
+  docsPath?: string;
   configSchema?: JsonSchemaNode;
   configUiHints?: Record<string, ConfigUiHint>;
 };
@@ -125,6 +153,9 @@ const FIELD_LABELS: Record<string, string> = {
   "diagnostics.cacheTrace.includeSystem": "Cache Trace Include System",
   "agents.list.*.identity.avatar": "Identity Avatar",
   "agents.list.*.skills": "Agent Skill Filter",
+  "gateway.mode": "Gateway Mode",
+  "gateway.port": "Gateway Port",
+  "gateway.bind": "Bind Address",
   "gateway.remote.url": "Remote Gateway URL",
   "gateway.remote.sshTarget": "Remote Gateway SSH Target",
   "gateway.remote.sshIdentity": "Remote Gateway SSH Identity",
@@ -503,6 +534,38 @@ const FIELD_HELP: Record<string, string> = {
   "tools.web.fetch.firecrawl.timeoutSeconds": "Timeout in seconds for Firecrawl requests.",
   "channels.slack.allowBots":
     "Allow bot-authored messages to trigger Slack replies (default: false).",
+  "channels.*.allowBots":
+    "Allow replies to bot-authored messages for this channel (default: false). Keep mention/allowlist guardrails to avoid bot loops.",
+  "channels.*.accounts.*.allowBots":
+    "Allow replies to bot-authored messages for this account (default: false). Keep mention/allowlist guardrails to avoid bot loops.",
+  "channels.*.blockStreaming":
+    "Send completed reply blocks while the model is still generating for this channel/account.",
+  "channels.*.accounts.*.blockStreaming":
+    "Send completed reply blocks while the model is still generating for this account.",
+  "channels.*.capabilities":
+    "Optional runtime capability tags. Leave empty unless a feature/docs explicitly require a tag.",
+  "channels.*.accounts.*.capabilities":
+    "Optional runtime capability tags for this account. Leave empty unless a feature/docs explicitly require a tag.",
+  "channels.*.dm.policy":
+    'Direct message access policy for this channel account. "open" requires allowFrom to include "*".',
+  "channels.*.accounts.*.dm.policy":
+    'Direct message access policy for this account. "open" requires allowFrom to include "*".',
+  "channels.*.dmPolicy":
+    'Direct message access policy for this channel. "open" requires allowFrom to include "*".',
+  "channels.*.accounts.*.dmPolicy":
+    'Direct message access policy for this account. "open" requires allowFrom to include "*".',
+  "channels.discord.groupPolicy":
+    'Guild message policy. "allowlist" requires guild entries under channels.discord.guilds.',
+  "channels.discord.accounts.*.groupPolicy":
+    'Guild message policy for this account. "allowlist" requires guild entries under channels.discord.accounts.<id>.guilds.',
+  "channels.slack.groupPolicy":
+    'Channel message policy. "allowlist" requires channel entries under channels.slack.channels.',
+  "channels.slack.accounts.*.groupPolicy":
+    'Channel message policy for this account. "allowlist" requires channel entries under channels.slack.accounts.<id>.channels.',
+  "channels.googlechat.groupPolicy":
+    'Space message policy. "allowlist" requires space entries under channels.googlechat.groups.',
+  "channels.googlechat.accounts.*.groupPolicy":
+    'Space message policy for this account. "allowlist" requires space entries under channels.googlechat.accounts.<id>.groups.',
   "channels.slack.thread.historyScope":
     'Scope for Slack thread history context ("thread" isolates per thread; "channel" reuses channel history).',
   "channels.slack.thread.inheritParent":
@@ -750,8 +813,251 @@ const FIELD_HELP: Record<string, string> = {
     "Resolve PluralKit proxied messages and treat system members as distinct senders.",
   "channels.discord.pluralkit.token":
     "Optional PluralKit token for resolving private systems or members.",
+
+  // --- discord actions (top-level + per-account wildcard) ---
+  "channels.discord.actions.reactions":
+    "Allow the agent to add, remove, and list emoji reactions on Discord messages. Default: on.",
+  "channels.discord.actions.stickers":
+    "Allow the agent to send sticker messages in Discord channels. Default: on.",
+  "channels.discord.actions.emojiUploads":
+    "Allow the agent to upload custom emoji to the server. Default: on.",
+  "channels.discord.actions.stickerUploads":
+    "Allow the agent to upload custom stickers to the server. Default: on.",
+  "channels.discord.actions.polls":
+    "Allow the agent to create polls in Discord channels. Default: on.",
+  "channels.discord.actions.permissions":
+    "Allow the agent to view and manage channel permissions. Default: on.",
+  "channels.discord.actions.messages":
+    "Allow the agent to read, edit, and delete messages in Discord channels. Default: on.",
+  "channels.discord.actions.threads":
+    "Allow the agent to create, list, and reply in threads. Default: on.",
+  "channels.discord.actions.pins":
+    "Allow the agent to pin, unpin, and list pinned messages. Default: on.",
+  "channels.discord.actions.search":
+    "Allow the agent to search message history in Discord channels. Default: on.",
+  "channels.discord.actions.memberInfo":
+    "Allow the agent to look up member profiles, roles, and join dates. Default: on.",
+  "channels.discord.actions.roleInfo":
+    "Allow the agent to view role details (name, color, permissions). Default: on.",
+  "channels.discord.actions.roles":
+    "Allow the agent to assign and remove roles from members. Default: off — enable with caution.",
+  "channels.discord.actions.channelInfo":
+    "Allow the agent to read channel names, topics, and categories. Default: on.",
+  "channels.discord.actions.channels":
+    "Allow the agent to create, edit, delete, and move channels and categories. Default: on.",
+  "channels.discord.actions.voiceStatus":
+    "Allow the agent to view voice channel status (who is connected). Default: on.",
+  "channels.discord.actions.events":
+    "Allow the agent to list and create scheduled events in the server. Default: on.",
+  "channels.discord.actions.moderation":
+    "Allow the agent to timeout, kick, and ban members. Default: off — enable with caution.",
+  "channels.discord.actions.presence":
+    "Allow the agent to set its own presence/status (online, idle, DND). Default: off.",
+
+  // per-account discord action hints (wildcard)
+  "channels.discord.accounts.*.actions.reactions":
+    "Allow the agent to add, remove, and list emoji reactions on Discord messages. Default: on.",
+  "channels.discord.accounts.*.actions.stickers":
+    "Allow the agent to send sticker messages in Discord channels. Default: on.",
+  "channels.discord.accounts.*.actions.emojiUploads":
+    "Allow the agent to upload custom emoji to the server. Default: on.",
+  "channels.discord.accounts.*.actions.stickerUploads":
+    "Allow the agent to upload custom stickers to the server. Default: on.",
+  "channels.discord.accounts.*.actions.polls":
+    "Allow the agent to create polls in Discord channels. Default: on.",
+  "channels.discord.accounts.*.actions.permissions":
+    "Allow the agent to view and manage channel permissions. Default: on.",
+  "channels.discord.accounts.*.actions.messages":
+    "Allow the agent to read, edit, and delete messages in Discord channels. Default: on.",
+  "channels.discord.accounts.*.actions.threads":
+    "Allow the agent to create, list, and reply in threads. Default: on.",
+  "channels.discord.accounts.*.actions.pins":
+    "Allow the agent to pin, unpin, and list pinned messages. Default: on.",
+  "channels.discord.accounts.*.actions.search":
+    "Allow the agent to search message history in Discord channels. Default: on.",
+  "channels.discord.accounts.*.actions.memberInfo":
+    "Allow the agent to look up member profiles, roles, and join dates. Default: on.",
+  "channels.discord.accounts.*.actions.roleInfo":
+    "Allow the agent to view role details (name, color, permissions). Default: on.",
+  "channels.discord.accounts.*.actions.roles":
+    "Allow the agent to assign and remove roles from members. Default: off — enable with caution.",
+  "channels.discord.accounts.*.actions.channelInfo":
+    "Allow the agent to read channel names, topics, and categories. Default: on.",
+  "channels.discord.accounts.*.actions.channels":
+    "Allow the agent to create, edit, delete, and move channels and categories. Default: on.",
+  "channels.discord.accounts.*.actions.voiceStatus":
+    "Allow the agent to view voice channel status (who is connected). Default: on.",
+  "channels.discord.accounts.*.actions.events":
+    "Allow the agent to list and create scheduled events in the server. Default: on.",
+  "channels.discord.accounts.*.actions.moderation":
+    "Allow the agent to timeout, kick, and ban members. Default: off — enable with caution.",
+  "channels.discord.accounts.*.actions.presence":
+    "Allow the agent to set its own presence/status (online, idle, DND). Default: off.",
+
   "channels.slack.dm.policy":
     'Direct message access control ("pairing" recommended). "open" requires channels.slack.dm.allowFrom=["*"].',
+
+  // --- gateway ---
+  "gateway.mode":
+    'Gateway run mode ("local" for local-only, "remote" to connect to a remote gateway).',
+  "gateway.port": "Port for the gateway HTTP/WebSocket server (default: 18789).",
+  "gateway.bind":
+    'Network interface to bind ("loopback" for 127.0.0.1, "all" for 0.0.0.0, or a specific address).',
+
+  // --- diagnostics ---
+  "diagnostics.enabled": "Enable diagnostics subsystem (default: true).",
+  "diagnostics.otel.enabled":
+    "Enable OpenTelemetry export (traces, metrics, and/or logs). Requires an OTLP-compatible collector.",
+  "diagnostics.otel.endpoint":
+    "OTLP collector endpoint (e.g. http://localhost:4318 for HTTP or http://localhost:4317 for gRPC).",
+  "diagnostics.otel.protocol": 'OTLP transport protocol ("http/protobuf" or "grpc").',
+  "diagnostics.otel.headers":
+    "Extra headers sent with OTLP requests (key-value pairs for auth, routing, etc.).",
+  "diagnostics.otel.serviceName":
+    'Service name reported to the collector (default: "openclaw-gateway").',
+  "diagnostics.otel.traces":
+    "Export distributed traces via OTLP (default: true when OTEL enabled).",
+  "diagnostics.otel.metrics": "Export metrics via OTLP (default: true when OTEL enabled).",
+  "diagnostics.otel.logs": "Export logs via OTLP (default: false).",
+  "diagnostics.otel.sampleRate":
+    "Trace sample rate (0.0-1.0). 1.0 traces everything; lower values reduce volume.",
+  "diagnostics.otel.flushIntervalMs":
+    "How often (ms) the OTLP exporter flushes buffered telemetry (default: 5000).",
+
+  // --- tools.exec ---
+  "tools.exec.host":
+    'Exec host environment ("local" runs commands on the gateway host; other values may route to sandboxes).',
+  "tools.exec.security":
+    'Exec security mode ("elevated" allows all commands; "standard" restricts to safe bins and approved tools).',
+  "tools.exec.ask":
+    'Exec ask/approval mode ("always" prompts before every exec; "auto" prompts only for unknown commands; "never" skips prompts).',
+  "tools.exec.node": "Node.js binary used for exec-based tools (default: auto-detected).",
+  "tools.exec.approvalRunningNoticeMs":
+    "Delay (ms) before showing a notice that an exec approval is pending (default: 5000).",
+
+  // --- tools.profile / alsoAllow / byProvider ---
+  "tools.profile":
+    'Active tool profile ("standard", "elevated", or "minimal"). Controls which tools are available by default.',
+  "tools.alsoAllow":
+    "Additional tools to allow on top of the active profile (array of tool names).",
+  "agents.list[].tools.profile":
+    'Per-agent tool profile override ("standard", "elevated", or "minimal").',
+  "agents.list[].tools.alsoAllow":
+    "Per-agent additional tool allowlist (merged with the global alsoAllow).",
+  "tools.byProvider":
+    "Per-provider tool policy overrides (keyed by provider ID). Lets you enable/disable specific tools for certain providers.",
+  "agents.list[].tools.byProvider": "Per-agent, per-provider tool policy overrides.",
+
+  // --- tools.media ---
+  "tools.media.image.enabled":
+    "Enable image understanding (vision). When enabled, images are analyzed and described for the agent.",
+  "tools.media.image.maxBytes":
+    "Maximum image file size (bytes) accepted for understanding (larger images are skipped).",
+  "tools.media.image.maxChars":
+    "Maximum characters in the image description returned to the agent.",
+  "tools.media.image.prompt":
+    "Custom prompt sent to the vision model when describing images (overrides the default).",
+  "tools.media.image.timeoutSeconds": "Timeout (seconds) for image understanding requests.",
+  "tools.media.image.attachments":
+    'Attachment handling policy for images ("inline" sends image data with the message; "describe" sends only the text description; "skip" ignores).',
+  "tools.media.image.models":
+    "Model(s) to use for image understanding (overrides the shared tools.media.models).",
+  "tools.media.image.scope":
+    'Channel scope for image understanding ("all", "direct", "group", or a channel ID list).',
+  "tools.media.models":
+    "Shared model list for all media understanding pipelines (image, audio, video). Per-type models override this.",
+  "tools.media.concurrency":
+    "Max concurrent media understanding jobs across all types (default: 2).",
+  "tools.media.audio.enabled":
+    "Enable audio understanding (speech-to-text transcription + analysis).",
+  "tools.media.audio.maxBytes": "Maximum audio file size (bytes) accepted for understanding.",
+  "tools.media.audio.maxChars":
+    "Maximum characters in the audio transcription returned to the agent.",
+  "tools.media.audio.prompt":
+    "Custom prompt sent to the audio model when transcribing audio (overrides the default).",
+  "tools.media.audio.timeoutSeconds": "Timeout (seconds) for audio understanding requests.",
+  "tools.media.audio.language":
+    'Language hint for audio transcription (ISO 639-1 code, e.g. "en", "es", "zh").',
+  "tools.media.audio.attachments":
+    'Attachment handling policy for audio ("inline", "describe", or "skip").',
+  "tools.media.audio.models":
+    "Model(s) to use for audio understanding (overrides the shared tools.media.models).",
+  "tools.media.audio.scope":
+    'Channel scope for audio understanding ("all", "direct", "group", or a channel ID list).',
+  "tools.media.video.enabled": "Enable video understanding (frame extraction + analysis).",
+  "tools.media.video.maxBytes": "Maximum video file size (bytes) accepted for understanding.",
+  "tools.media.video.maxChars":
+    "Maximum characters in the video description returned to the agent.",
+  "tools.media.video.prompt":
+    "Custom prompt sent to the vision model when describing video frames (overrides the default).",
+  "tools.media.video.timeoutSeconds": "Timeout (seconds) for video understanding requests.",
+  "tools.media.video.attachments":
+    'Attachment handling policy for videos ("inline", "describe", or "skip").',
+  "tools.media.video.models":
+    "Model(s) to use for video understanding (overrides the shared tools.media.models).",
+  "tools.media.video.scope":
+    'Channel scope for video understanding ("all", "direct", "group", or a channel ID list).',
+  "tools.links.enabled":
+    "Enable link understanding (fetches URLs shared in messages and summarizes them).",
+  "tools.links.maxLinks": "Maximum number of links to process per message (default: 3).",
+  "tools.links.timeoutSeconds": "Timeout (seconds) for fetching and understanding links.",
+  "tools.links.models": "Model(s) to use for link understanding.",
+  "tools.links.scope":
+    'Channel scope for link understanding ("all", "direct", "group", or a channel ID list).',
+
+  // --- ui ---
+  "ui.seamColor": "Accent color used in the Control UI and CLI output (hex color code).",
+  "ui.assistant.name": "Display name for the assistant shown in the UI and message headers.",
+  "ui.assistant.avatar": "Avatar emoji or image URL for the assistant shown in the UI.",
+
+  // --- browser ---
+  "browser.evaluateEnabled":
+    "Allow the browser_evaluate tool to run arbitrary JavaScript in the controlled browser (default: false).",
+  "browser.snapshotDefaults":
+    "Default settings for browser snapshots (screenshots and DOM captures).",
+  "browser.snapshotDefaults.mode": 'Default snapshot mode ("screenshot", "dom", or "hybrid").',
+  "browser.remoteCdpTimeoutMs":
+    "Timeout (ms) for connecting to a remote Chrome DevTools Protocol endpoint (default: 10000).",
+  "browser.remoteCdpHandshakeTimeoutMs":
+    "Timeout (ms) for the CDP WebSocket handshake after connection (default: 5000).",
+
+  // --- talk ---
+  "talk.apiKey":
+    "API key for the Talk voice provider (e.g. OpenAI Realtime API key). Falls back to OPENAI_API_KEY env var.",
+
+  // --- skills ---
+  "skills.load.watch":
+    "Watch skill directories for changes and hot-reload on save (default: true in dev).",
+  "skills.load.watchDebounceMs":
+    "Debounce window (ms) before reloading skills after a file change (default: 300).",
+
+  // --- agents.defaults ---
+  "agents.defaults.workspace":
+    "Default workspace directory for agents (used for file operations and relative path resolution).",
+  "agents.defaults.memorySearch.enabled":
+    "Enable vector-based memory search for agents (default: true).",
+  "agents.defaults.memorySearch.model":
+    'Embedding model for memory search (e.g. "text-embedding-3-small").',
+  "agents.defaults.memorySearch.chunking.tokens":
+    "Target chunk size in tokens for memory indexing (default: 256).",
+  "agents.defaults.memorySearch.chunking.overlap":
+    "Overlap tokens between consecutive memory chunks (default: 32).",
+  "agents.defaults.memorySearch.sync.onSessionStart":
+    "Trigger a memory reindex when a new session starts (default: true).",
+  "agents.defaults.memorySearch.sync.watchDebounceMs":
+    "Debounce window (ms) before reindexing after a memory file change (default: 1000).",
+  "agents.defaults.memorySearch.query.maxResults":
+    "Maximum number of memory search results returned per query (default: 5).",
+  "agents.defaults.memorySearch.query.minScore":
+    "Minimum similarity score (0-1) for memory search results to be included.",
+
+  // --- channels (missing help) ---
+  "channels.telegram.capabilities.inlineButtons":
+    "Enable inline button support for Telegram messages (default: true). Disable to suppress inline keyboards.",
+  "channels.signal.account":
+    "Phone number registered with Signal for the bot (E.164 format, e.g. +15551234567). Used by signal-cli.",
+  "channels.imessage.cliPath":
+    "Path to the openclaw-imessage CLI binary used for sending/receiving iMessages.",
 };
 
 const FIELD_PLACEHOLDERS: Record<string, string> = {
@@ -763,6 +1069,312 @@ const FIELD_PLACEHOLDERS: Record<string, string> = {
   "gateway.controlUi.allowedOrigins": "https://control.example.com",
   "channels.mattermost.baseUrl": "https://chat.example.com",
   "agents.list[].identity.avatar": "avatars/openclaw.png",
+  "channels.telegram.botToken": "123456:ABC-DEF1234...",
+  "channels.discord.token": "MTk...",
+  "channels.slack.botToken": "xoxb-...",
+  "channels.slack.appToken": "xapp-...",
+  "channels.signal.account": "+15551234567",
+  "channels.imessage.cliPath": "/usr/local/bin/openclaw-imessage",
+  "tools.web.search.apiKey": "BSA...",
+  "talk.apiKey": "sk-...",
+  "agents.defaults.model.primary": "anthropic/claude-sonnet-4-5-20250929",
+  "ui.assistant.name": "Mr. Fox",
+  "ui.assistant.avatar": "\u{1F98A}",
+  "ui.seamColor": "#6366f1",
+};
+
+const FIELD_DOCS: Record<string, string> = {
+  "gateway.mode": "/web/dashboard",
+  "gateway.bind": "/web/dashboard",
+  "gateway.controlUi.allowInsecureAuth": "/web/control-ui#insecure-http",
+  "channels.*.allowBots": "/gateway/configuration",
+  "channels.*.accounts.*.allowBots": "/gateway/configuration",
+  "channels.*.blockStreaming": "/concepts/streaming",
+  "channels.*.accounts.*.blockStreaming": "/concepts/streaming",
+  "channels.*.dm.policy": "/gateway/security",
+  "channels.*.accounts.*.dm.policy": "/gateway/security",
+  "channels.*.dmPolicy": "/gateway/security",
+  "channels.*.accounts.*.dmPolicy": "/gateway/security",
+  "channels.discord.groupPolicy": "/channels/discord",
+  "channels.discord.accounts.*.groupPolicy": "/channels/discord",
+  "channels.slack.groupPolicy": "/channels/slack",
+  "channels.slack.accounts.*.groupPolicy": "/channels/slack",
+  "channels.googlechat.groupPolicy": "/channels/googlechat",
+  "channels.googlechat.accounts.*.groupPolicy": "/channels/googlechat",
+  "channels.discord.actions.roles": "/channels/discord",
+  "channels.discord.actions.moderation": "/channels/discord",
+  "channels.discord.accounts.*.actions.roles": "/channels/discord",
+  "channels.discord.accounts.*.actions.moderation": "/channels/discord",
+};
+
+const FIELD_IMPACTS: Record<string, ConfigUiHintImpact[]> = {
+  "gateway.mode": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "remote",
+      targetPath: "gateway.remote.url",
+      targetWhen: "defined",
+      message: "Remote mode requires a Remote Gateway URL.",
+    },
+    {
+      relation: "recommends",
+      when: "equals",
+      whenValue: "remote",
+      targetPath: "gateway.remote.token",
+      targetWhen: "defined",
+      message: "Set a remote token (or password) to avoid unauthorized connection errors.",
+    },
+  ],
+  "gateway.bind": [
+    {
+      relation: "risk",
+      when: "notEquals",
+      whenValue: "loopback",
+      message:
+        "Non-loopback bind exposes the gateway over the network. Keep auth on and firewall access tightly.",
+    },
+  ],
+  "gateway.controlUi.allowInsecureAuth": [
+    {
+      relation: "risk",
+      when: "truthy",
+      message:
+        "Insecure auth allows token auth over plain HTTP. Prefer HTTPS (or loopback) for dashboard access.",
+    },
+  ],
+  "channels.*.allowBots": [
+    {
+      relation: "risk",
+      when: "truthy",
+      message:
+        "Allowing bot-authored messages can create bot-to-bot reply loops. Prefer mention/allowlist guardrails.",
+      docsPath: "/gateway/security",
+    },
+  ],
+  "channels.*.accounts.*.allowBots": [
+    {
+      relation: "risk",
+      when: "truthy",
+      message:
+        "Allowing bot-authored messages can create bot-to-bot reply loops. Prefer mention/allowlist guardrails.",
+      docsPath: "/gateway/security",
+    },
+  ],
+  "channels.*.dm.policy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "open",
+      targetPath: "channels.*.dm.allowFrom",
+      targetWhen: "includes",
+      targetValue: "*",
+      message: 'Open DM policy requires allowFrom to include "*".',
+      fixValue: ["*"],
+      fixLabel: 'Allow all ("*")',
+      docsPath: "/gateway/security",
+    },
+  ],
+  "channels.*.accounts.*.dm.policy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "open",
+      targetPath: "channels.*.accounts.*.dm.allowFrom",
+      targetWhen: "includes",
+      targetValue: "*",
+      message: 'Open DM policy requires allowFrom to include "*".',
+      fixValue: ["*"],
+      fixLabel: 'Allow all ("*")',
+      docsPath: "/gateway/security",
+    },
+  ],
+  "channels.*.dmPolicy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "open",
+      targetPath: "channels.*.allowFrom",
+      targetWhen: "includes",
+      targetValue: "*",
+      message: 'Open DM policy requires allowFrom to include "*".',
+      fixValue: ["*"],
+      fixLabel: 'Allow all ("*")',
+      docsPath: "/gateway/security",
+    },
+  ],
+  "channels.*.accounts.*.dmPolicy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "open",
+      targetPath: "channels.*.accounts.*.allowFrom",
+      targetWhen: "includes",
+      targetValue: "*",
+      message: 'Open DM policy requires allowFrom to include "*".',
+      fixValue: ["*"],
+      fixLabel: 'Allow all ("*")',
+      docsPath: "/gateway/security",
+    },
+  ],
+  "channels.discord.groupPolicy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "allowlist",
+      targetPath: "channels.discord.guilds",
+      targetWhen: "defined",
+      message: 'Discord "allowlist" policy needs at least one guild entry.',
+      docsPath: "/channels/discord",
+    },
+  ],
+  "channels.discord.accounts.*.groupPolicy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "allowlist",
+      targetPath: "channels.discord.accounts.*.guilds",
+      targetWhen: "defined",
+      message: 'Discord "allowlist" policy needs at least one guild entry for this account.',
+      docsPath: "/channels/discord",
+    },
+  ],
+  "channels.slack.groupPolicy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "allowlist",
+      targetPath: "channels.slack.channels",
+      targetWhen: "defined",
+      message: 'Slack "allowlist" policy needs at least one channel entry.',
+      docsPath: "/channels/slack",
+    },
+  ],
+  "channels.slack.accounts.*.groupPolicy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "allowlist",
+      targetPath: "channels.slack.accounts.*.channels",
+      targetWhen: "defined",
+      message: 'Slack "allowlist" policy needs at least one channel entry for this account.',
+      docsPath: "/channels/slack",
+    },
+  ],
+  "channels.googlechat.groupPolicy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "allowlist",
+      targetPath: "channels.googlechat.groups",
+      targetWhen: "defined",
+      message: 'Google Chat "allowlist" policy needs at least one space entry.',
+      docsPath: "/channels/googlechat",
+    },
+  ],
+  "channels.googlechat.accounts.*.groupPolicy": [
+    {
+      relation: "requires",
+      when: "equals",
+      whenValue: "allowlist",
+      targetPath: "channels.googlechat.accounts.*.groups",
+      targetWhen: "defined",
+      message: 'Google Chat "allowlist" policy needs at least one space entry for this account.',
+      docsPath: "/channels/googlechat",
+    },
+  ],
+  "channels.telegram.streamMode": [
+    {
+      relation: "conflicts",
+      when: "notEquals",
+      whenValue: "off",
+      targetPath: "channels.telegram.blockStreaming",
+      targetWhen: "truthy",
+      message:
+        "Telegram draft streaming can suppress block streaming for a reply. Set streamMode=off for block-only behavior.",
+      docsPath: "/concepts/streaming",
+    },
+  ],
+  "channels.telegram.accounts.*.streamMode": [
+    {
+      relation: "conflicts",
+      when: "notEquals",
+      whenValue: "off",
+      targetPath: "channels.telegram.accounts.*.blockStreaming",
+      targetWhen: "truthy",
+      message:
+        "Telegram draft streaming can suppress block streaming for a reply. Set streamMode=off for block-only behavior.",
+      docsPath: "/concepts/streaming",
+    },
+  ],
+  "channels.telegram.blockStreaming": [
+    {
+      relation: "conflicts",
+      when: "truthy",
+      targetPath: "channels.telegram.streamMode",
+      targetWhen: "notEquals",
+      targetValue: "off",
+      message:
+        "Telegram streamMode is enabled. Use streamMode=off if you want block streaming to drive replies.",
+      docsPath: "/concepts/streaming",
+    },
+  ],
+  "channels.telegram.accounts.*.blockStreaming": [
+    {
+      relation: "conflicts",
+      when: "truthy",
+      targetPath: "channels.telegram.accounts.*.streamMode",
+      targetWhen: "notEquals",
+      targetValue: "off",
+      message:
+        "Telegram streamMode is enabled for this account. Use streamMode=off for block-only behavior.",
+      docsPath: "/concepts/streaming",
+    },
+  ],
+  "channels.discord.actions.roles": [
+    {
+      relation: "requires",
+      when: "truthy",
+      targetPath: "channels.discord.actions.permissions",
+      targetWhen: "truthy",
+      message: "Role management depends on permissions actions being enabled.",
+      fixValue: true,
+      fixLabel: "Enable permissions",
+    },
+  ],
+  "channels.discord.actions.moderation": [
+    {
+      relation: "requires",
+      when: "truthy",
+      targetPath: "channels.discord.actions.permissions",
+      targetWhen: "truthy",
+      message: "Moderation actions depend on permissions actions being enabled.",
+      fixValue: true,
+      fixLabel: "Enable permissions",
+    },
+  ],
+  "channels.discord.accounts.*.actions.roles": [
+    {
+      relation: "requires",
+      when: "truthy",
+      targetPath: "channels.discord.accounts.*.actions.permissions",
+      targetWhen: "truthy",
+      message: "Role management depends on permissions actions being enabled for this account.",
+      fixValue: true,
+      fixLabel: "Enable permissions",
+    },
+  ],
+  "channels.discord.accounts.*.actions.moderation": [
+    {
+      relation: "requires",
+      when: "truthy",
+      targetPath: "channels.discord.accounts.*.actions.permissions",
+      targetWhen: "truthy",
+      message: "Moderation actions depend on permissions actions being enabled for this account.",
+      fixValue: true,
+      fixLabel: "Enable permissions",
+    },
+  ],
 };
 
 const SENSITIVE_PATTERNS = [/token/i, /password/i, /secret/i, /api.?key/i];
@@ -844,6 +1456,14 @@ function buildBaseHints(): ConfigUiHints {
     const current = hints[path];
     hints[path] = current ? { ...current, placeholder } : { placeholder };
   }
+  for (const [path, docsPath] of Object.entries(FIELD_DOCS)) {
+    const current = hints[path];
+    hints[path] = current ? { ...current, docsPath } : { docsPath };
+  }
+  for (const [path, impacts] of Object.entries(FIELD_IMPACTS)) {
+    const current = hints[path];
+    hints[path] = current ? { ...current, impacts } : { impacts };
+  }
   return hints;
 }
 
@@ -911,10 +1531,12 @@ function applyChannelHints(hints: ConfigUiHints, channels: ChannelUiMetadata[]):
     const current = next[basePath] ?? {};
     const label = channel.label?.trim();
     const help = channel.description?.trim();
+    const docsPath = channel.docsPath?.trim();
     next[basePath] = {
       ...current,
       ...(label ? { label } : {}),
       ...(help ? { help } : {}),
+      ...(docsPath ? { docsPath } : {}),
     };
 
     const uiHints = channel.configUiHints ?? {};
diff --git a/src/cron/isolated-agent.uses-last-non-empty-agent-text-as.test.ts b/src/cron/isolated-agent.uses-last-non-empty-agent-text-as.test.ts
index 3ec1c935b08f..d9e5496647ac 100644
--- a/src/cron/isolated-agent.uses-last-non-empty-agent-text-as.test.ts
+++ b/src/cron/isolated-agent.uses-last-non-empty-agent-text-as.test.ts
@@ -479,7 +479,15 @@ describe("runCronIsolatedAgentTurn", () => {
         sendMessageSignal: vi.fn(),
         sendMessageIMessage: vi.fn(),
       };
-      vi.mocked(runEmbeddedPiAgent).mockReset();
+      vi.mocked(runEmbeddedPiAgent).mockResolvedValue({
+        payloads: [{ text: "done" }],
+        meta: {
+          durationMs: 5,
+          providerModel: "test/model",
+          inputTokens: 10,
+          outputTokens: 5,
+        },
+      });
 
       const res = await runCronIsolatedAgentTurn({
         cfg: makeCfg(home, storePath),
@@ -494,9 +502,9 @@ describe("runCronIsolatedAgentTurn", () => {
         lane: "cron",
       });
 
-      expect(res.status).toBe("error");
-      expect(res.error).toMatch("invalid model");
-      expect(vi.mocked(runEmbeddedPiAgent)).not.toHaveBeenCalled();
+      // Invalid model override should warn and fall back to default, not fail
+      expect(res.status).toBe("ok");
+      expect(vi.mocked(runEmbeddedPiAgent)).toHaveBeenCalled();
     });
   });
 
diff --git a/src/cron/isolated-agent/run.ts b/src/cron/isolated-agent/run.ts
index 3dd0cc416579..57b4bcf43710 100644
--- a/src/cron/isolated-agent/run.ts
+++ b/src/cron/isolated-agent/run.ts
@@ -200,10 +200,14 @@ export async function runCronIsolatedAgentTurn(params: {
       defaultModel: resolvedDefault.model,
     });
     if ("error" in resolvedOverride) {
-      return { status: "error", error: resolvedOverride.error };
+      // Fall through to the default model instead of failing the entire cron job
+      logWarn(
+        `[cron:${params.job.id}] model override "${modelOverrideRaw}" rejected (${resolvedOverride.error}); using default model`,
+      );
+    } else {
+      provider = resolvedOverride.ref.provider;
+      model = resolvedOverride.ref.model;
     }
-    provider = resolvedOverride.ref.provider;
-    model = resolvedOverride.ref.model;
   }
   const now = Date.now();
   const cronSession = resolveCronSession({
diff --git a/src/daemon/launchd-plist.ts b/src/daemon/launchd-plist.ts
index e685cd9941cf..20f466072a82 100644
--- a/src/daemon/launchd-plist.ts
+++ b/src/daemon/launchd-plist.ts
@@ -106,5 +106,5 @@ export function buildLaunchAgentPlist({
     ? `\n    <key>Comment</key>\n    <string>${plistEscape(comment.trim())}</string>`
     : "";
   const envXml = renderEnvDict(environment);
-  return `<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0">\n  <dict>\n    <key>Label</key>\n    <string>${plistEscape(label)}</string>\n    ${commentXml}\n    <key>RunAtLoad</key>\n    <true/>\n    <key>KeepAlive</key>\n    <true/>\n    <key>ProgramArguments</key>\n    <array>${argsXml}\n    </array>\n    ${workingDirXml}\n    <key>StandardOutPath</key>\n    <string>${plistEscape(stdoutPath)}</string>\n    <key>StandardErrorPath</key>\n    <string>${plistEscape(stderrPath)}</string>${envXml}\n  </dict>\n</plist>\n`;
+  return `<?xml version="1.0" encoding="UTF-8"?>\n<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">\n<plist version="1.0">\n  <dict>\n    <key>Label</key>\n    <string>${plistEscape(label)}</string>\n    ${commentXml}\n    <key>RunAtLoad</key>\n    <true/>\n    <key>KeepAlive</key>\n    <true/>\n    <key>ThrottleInterval</key>\n    <integer>10</integer>\n    <key>ProgramArguments</key>\n    <array>${argsXml}\n    </array>\n    ${workingDirXml}\n    <key>StandardOutPath</key>\n    <string>${plistEscape(stdoutPath)}</string>\n    <key>StandardErrorPath</key>\n    <string>${plistEscape(stderrPath)}</string>${envXml}\n  </dict>\n</plist>\n`;
 }
diff --git a/src/gateway/protocol/schema/channels.ts b/src/gateway/protocol/schema/channels.ts
index cbbaaa1922c8..36700bfa369c 100644
--- a/src/gateway/protocol/schema/channels.ts
+++ b/src/gateway/protocol/schema/channels.ts
@@ -60,6 +60,9 @@ export const ChannelUiMetaSchema = Type.Object(
     label: NonEmptyString,
     detailLabel: NonEmptyString,
     systemImage: Type.Optional(Type.String()),
+    description: Type.Optional(Type.String()),
+    docsPath: Type.Optional(Type.String()),
+    docsLabel: Type.Optional(Type.String()),
   },
   { additionalProperties: false },
 );
diff --git a/src/gateway/protocol/schema/config.ts b/src/gateway/protocol/schema/config.ts
index eb7389a4d1d0..264627f46cf1 100644
--- a/src/gateway/protocol/schema/config.ts
+++ b/src/gateway/protocol/schema/config.ts
@@ -47,6 +47,7 @@ export const UpdateRunParamsSchema = Type.Object(
 
 export const ConfigUiHintSchema = Type.Object(
   {
+    docsPath: Type.Optional(Type.String()),
     label: Type.Optional(Type.String()),
     help: Type.Optional(Type.String()),
     group: Type.Optional(Type.String()),
@@ -55,6 +56,25 @@ export const ConfigUiHintSchema = Type.Object(
     sensitive: Type.Optional(Type.Boolean()),
     placeholder: Type.Optional(Type.String()),
     itemTemplate: Type.Optional(Type.Unknown()),
+    impacts: Type.Optional(
+      Type.Array(
+        Type.Object(
+          {
+            relation: Type.Optional(Type.String()),
+            targetPath: Type.Optional(Type.String()),
+            when: Type.Optional(Type.String()),
+            whenValue: Type.Optional(Type.Unknown()),
+            targetWhen: Type.Optional(Type.String()),
+            targetValue: Type.Optional(Type.Unknown()),
+            message: Type.String(),
+            fixValue: Type.Optional(Type.Unknown()),
+            fixLabel: Type.Optional(Type.String()),
+            docsPath: Type.Optional(Type.String()),
+          },
+          { additionalProperties: false },
+        ),
+      ),
+    ),
   },
   { additionalProperties: false },
 );
diff --git a/src/gateway/server-close.ts b/src/gateway/server-close.ts
index ea0323587a98..8ab396e2f477 100644
--- a/src/gateway/server-close.ts
+++ b/src/gateway/server-close.ts
@@ -5,6 +5,9 @@ import type { HeartbeatRunner } from "../infra/heartbeat-runner.js";
 import type { PluginServicesHandle } from "../plugins/services.js";
 import { type ChannelId, listChannelPlugins } from "../channels/plugins/index.js";
 import { stopGmailWatcher } from "../hooks/gmail-watcher.js";
+import { createSubsystemLogger } from "../logging/subsystem.js";
+
+const log = createSubsystemLogger("gateway");
 
 export function createGatewayCloseHandler(params: {
   bonjourStop: (() => Promise<void>) | null;
@@ -40,8 +43,8 @@ export function createGatewayCloseHandler(params: {
     if (params.bonjourStop) {
       try {
         await params.bonjourStop();
-      } catch {
-        /* ignore */
+      } catch (err) {
+        log.warn(`cleanup: bonjour stop failed: ${String(err)}`);
       }
     }
     if (params.tailscaleCleanup) {
@@ -50,22 +53,24 @@ export function createGatewayCloseHandler(params: {
     if (params.canvasHost) {
       try {
         await params.canvasHost.close();
-      } catch {
-        /* ignore */
+      } catch (err) {
+        log.warn(`cleanup: canvas host close failed: ${String(err)}`);
       }
     }
     if (params.canvasHostServer) {
       try {
         await params.canvasHostServer.close();
-      } catch {
-        /* ignore */
+      } catch (err) {
+        log.warn(`cleanup: canvas host server close failed: ${String(err)}`);
       }
     }
     for (const plugin of listChannelPlugins()) {
       await params.stopChannel(plugin.id);
     }
     if (params.pluginServices) {
-      await params.pluginServices.stop().catch(() => {});
+      await params.pluginServices.stop().catch((err) => {
+        log.warn(`cleanup: plugin services stop failed: ${String(err)}`);
+      });
     }
     await stopGmailWatcher();
     params.cron.stop();
@@ -84,29 +89,33 @@ export function createGatewayCloseHandler(params: {
     if (params.agentUnsub) {
       try {
         params.agentUnsub();
-      } catch {
-        /* ignore */
+      } catch (err) {
+        log.warn(`cleanup: agent unsub failed: ${String(err)}`);
       }
     }
     if (params.heartbeatUnsub) {
       try {
         params.heartbeatUnsub();
-      } catch {
-        /* ignore */
+      } catch (err) {
+        log.warn(`cleanup: heartbeat unsub failed: ${String(err)}`);
       }
     }
     params.chatRunState.clear();
     for (const c of params.clients) {
       try {
         c.socket.close(1012, "service restart");
-      } catch {
-        /* ignore */
+      } catch (err) {
+        log.warn(`cleanup: client socket close failed: ${String(err)}`);
       }
     }
     params.clients.clear();
-    await params.configReloader.stop().catch(() => {});
+    await params.configReloader.stop().catch((err) => {
+      log.warn(`cleanup: config reloader stop failed: ${String(err)}`);
+    });
     if (params.browserControl) {
-      await params.browserControl.stop().catch(() => {});
+      await params.browserControl.stop().catch((err) => {
+        log.warn(`cleanup: browser control stop failed: ${String(err)}`);
+      });
     }
     await new Promise<void>((resolve) => params.wss.close(() => resolve()));
     const servers =
diff --git a/src/gateway/server-methods/config.ts b/src/gateway/server-methods/config.ts
index 05a534454ac0..82e10949f2c3 100644
--- a/src/gateway/server-methods/config.ts
+++ b/src/gateway/server-methods/config.ts
@@ -143,6 +143,7 @@ export const configHandlers: GatewayRequestHandlers = {
         id: entry.id,
         label: entry.meta.label,
         description: entry.meta.blurb,
+        docsPath: entry.meta.docsPath,
         configSchema: entry.configSchema?.schema,
         configUiHints: entry.configSchema?.uiHints,
       })),
diff --git a/src/plugins/types.ts b/src/plugins/types.ts
index 4dbab48ff143..397a13be68c7 100644
--- a/src/plugins/types.ts
+++ b/src/plugins/types.ts
@@ -28,9 +28,32 @@ export type PluginLogger = {
 export type PluginConfigUiHint = {
   label?: string;
   help?: string;
+  group?: string;
+  order?: number;
   advanced?: boolean;
   sensitive?: boolean;
   placeholder?: string;
+  itemTemplate?: unknown;
+  docsPath?: string;
+  impacts?: Array<{
+    relation?: "requires" | "conflicts" | "recommends" | "risk";
+    targetPath?: string;
+    when?: "truthy" | "falsy" | "defined" | "notDefined" | "equals" | "notEquals" | "includes";
+    whenValue?: unknown;
+    targetWhen?:
+      | "truthy"
+      | "falsy"
+      | "defined"
+      | "notDefined"
+      | "equals"
+      | "notEquals"
+      | "includes";
+    targetValue?: unknown;
+    message: string;
+    fixValue?: unknown;
+    fixLabel?: string;
+    docsPath?: string;
+  }>;
 };
 
 export type PluginKind = "memory";
diff --git a/src/signal/client.ts b/src/signal/client.ts
index 1551183f141c..3a7f716e7289 100644
--- a/src/signal/client.ts
+++ b/src/signal/client.ts
@@ -81,7 +81,12 @@ export async function signalRpcRequest<T = unknown>(
   if (!text) {
     throw new Error(`Signal RPC empty response (status ${res.status})`);
   }
-  const parsed = JSON.parse(text) as SignalRpcResponse<T>;
+  let parsed: SignalRpcResponse<T>;
+  try {
+    parsed = JSON.parse(text) as SignalRpcResponse<T>;
+  } catch {
+    throw new Error(`Signal RPC malformed JSON (status ${res.status}): ${text.slice(0, 200)}`);
+  }
   if (parsed.error) {
     const code = parsed.error.code ?? "unknown";
     const msg = parsed.error.message ?? "Signal RPC error";
diff --git a/ui/src/styles/components.css b/ui/src/styles/components.css
index f0438eeec2fb..9bd97396ce58 100644
--- a/ui/src/styles/components.css
+++ b/ui/src/styles/components.css
@@ -91,6 +91,14 @@
   gap: 6px;
 }
 
+.stat-card-clickable {
+  transition: border-color var(--duration-fast) ease;
+}
+
+.stat-card-clickable:hover {
+  border-color: var(--border-strong);
+}
+
 .note-title {
   font-weight: 600;
   letter-spacing: -0.01em;
@@ -397,6 +405,20 @@
   color: var(--accent);
 }
 
+.btn.quiet {
+  background: transparent;
+  border-color: transparent;
+  color: var(--muted);
+  box-shadow: none;
+}
+
+.btn.quiet:hover {
+  background: var(--bg-hover);
+  border-color: var(--border);
+  color: var(--text);
+  transform: none;
+}
+
 .btn.danger {
   border-color: transparent;
   background: var(--danger-subtle);
@@ -407,6 +429,30 @@
   background: rgba(239, 68, 68, 0.15);
 }
 
+.section-header {
+  display: flex;
+  align-items: flex-start;
+  justify-content: space-between;
+  gap: 12px;
+  flex-wrap: wrap;
+}
+
+.section-header__meta {
+  min-width: 0;
+}
+
+.section-header__actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+}
+
+.subtle-divider {
+  height: 1px;
+  background: var(--border);
+  margin: 12px 0;
+}
+
 .btn--sm {
   padding: 6px 10px;
   font-size: 12px;
@@ -1042,6 +1088,16 @@
   border-color: var(--danger-subtle);
 }
 
+/* Severity row tinting — subtle background to distinguish warn/error rows */
+.log-row.log-row--warn {
+  background: color-mix(in srgb, var(--warn) 5%, transparent);
+}
+
+.log-row.log-row--error,
+.log-row.log-row--fatal {
+  background: color-mix(in srgb, var(--danger) 6%, transparent);
+}
+
 .log-subsystem {
   color: var(--muted);
   font-family: var(--mono);
diff --git a/ui/src/styles/config.css b/ui/src/styles/config.css
index ec4003a12444..58787ba69641 100644
--- a/ui/src/styles/config.css
+++ b/ui/src/styles/config.css
@@ -615,6 +615,55 @@
   gap: 22px;
 }
 
+.cfg-group {
+  display: grid;
+  gap: 14px;
+  padding: 14px;
+  border: 1px solid var(--border);
+  border-radius: var(--radius-md);
+  background: color-mix(in srgb, var(--bg-elevated) 85%, transparent);
+}
+
+.cfg-group__title {
+  margin: 0;
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  color: var(--text-muted, var(--muted));
+}
+
+.cfg-group__body {
+  display: grid;
+  gap: 14px;
+}
+
+.cfg-group--advanced {
+  padding: 0;
+  overflow: hidden;
+}
+
+.cfg-group--advanced > summary {
+  list-style: none;
+  cursor: pointer;
+  padding: 12px 14px;
+  border-bottom: 1px solid var(--border);
+  font-size: 12px;
+  font-weight: 600;
+  letter-spacing: 0.04em;
+  text-transform: uppercase;
+  color: var(--muted);
+  background: var(--bg-accent);
+}
+
+.cfg-group--advanced > summary::-webkit-details-marker {
+  display: none;
+}
+
+.cfg-group--advanced .cfg-group__body {
+  padding: 14px;
+}
+
 .cfg-field {
   display: grid;
   gap: 8px;
@@ -639,6 +688,70 @@
   line-height: 1.45;
 }
 
+.cfg-field__assist {
+  display: grid;
+  gap: 8px;
+}
+
+.cfg-field__docs {
+  display: inline-flex;
+  width: fit-content;
+  font-size: 12px;
+  color: var(--accent);
+  text-decoration: none;
+}
+
+.cfg-field__docs:hover {
+  text-decoration: underline;
+}
+
+.cfg-impact-list {
+  display: grid;
+  gap: 8px;
+}
+
+.cfg-impact {
+  display: grid;
+  gap: 8px;
+  padding: 10px 12px;
+  border-radius: var(--radius-md);
+  border: 1px solid var(--border);
+  background: var(--bg-accent);
+  font-size: 12px;
+  line-height: 1.45;
+}
+
+.cfg-impact--info {
+  border-color: rgba(59, 130, 246, 0.25);
+}
+
+.cfg-impact--warn {
+  border-color: rgba(245, 158, 11, 0.3);
+  background: color-mix(in srgb, rgba(245, 158, 11, 0.08) 60%, var(--bg-accent));
+}
+
+.cfg-impact--danger {
+  border-color: rgba(239, 68, 68, 0.3);
+  background: color-mix(in srgb, rgba(239, 68, 68, 0.08) 60%, var(--bg-accent));
+}
+
+.cfg-impact__actions {
+  display: flex;
+  align-items: center;
+  gap: 8px;
+  flex-wrap: wrap;
+}
+
+.cfg-impact__link {
+  font-size: 12px;
+  color: var(--accent);
+  text-decoration: none;
+}
+
+.cfg-impact__link:hover {
+  text-decoration: underline;
+}
+
 .cfg-field__error {
   font-size: 12px;
   color: var(--danger);
@@ -985,7 +1098,7 @@
   box-shadow: var(--focus-ring);
 }
 
-/* Object (collapsible) */
+/* Object (collapsible) — top level */
 .cfg-object {
   border: 1px solid var(--border);
   border-radius: var(--radius-lg);
@@ -993,10 +1106,25 @@
   overflow: hidden;
 }
 
+/* Nested objects: remove stacked boxes and rely on spacing */
+.cfg-object .cfg-object {
+  border: 1px solid color-mix(in srgb, var(--border) 80%, transparent);
+  border-radius: var(--radius-md);
+  background: transparent;
+}
+
+.cfg-object .cfg-object .cfg-object {
+  border-color: color-mix(in srgb, var(--border) 70%, transparent);
+}
+
 :root[data-theme="light"] .cfg-object {
   background: white;
 }
 
+:root[data-theme="light"] .cfg-object .cfg-object {
+  background: transparent;
+}
+
 .cfg-object__header {
   display: flex;
   align-items: center;
@@ -1007,6 +1135,11 @@
   transition: background var(--duration-fast) ease;
 }
 
+/* Nested object headers: less padding */
+.cfg-object .cfg-object .cfg-object__header {
+  padding: 10px 14px;
+}
+
 .cfg-object__header:hover {
   background: var(--bg-hover);
 }
@@ -1021,6 +1154,13 @@
   color: var(--text);
 }
 
+/* Nested object titles: smaller, less prominent */
+.cfg-object .cfg-object .cfg-object__title {
+  font-size: 13px;
+  font-weight: 500;
+  color: var(--text);
+}
+
 .cfg-object__chevron {
   width: 18px;
   height: 18px;
@@ -1044,12 +1184,24 @@
   border-bottom: 1px solid var(--border);
 }
 
+/* Nested help: no bottom border */
+.cfg-object .cfg-object .cfg-object__help {
+  border-bottom: none;
+  padding: 0 14px 10px;
+}
+
 .cfg-object__content {
   padding: 18px;
   display: grid;
   gap: 18px;
 }
 
+/* Nested content: tighter spacing */
+.cfg-object .cfg-object .cfg-object__content {
+  padding: 10px 14px;
+  gap: 14px;
+}
+
 /* Array */
 .cfg-array {
   border: 1px solid var(--border);
@@ -1123,6 +1275,18 @@
   height: 100%;
 }
 
+.cfg-array > .cfg-field__assist {
+  padding: 10px 18px;
+  border-bottom: 1px solid var(--border);
+}
+
+.cfg-array__meta {
+  padding: 10px 18px;
+  font-size: 12px;
+  color: var(--muted);
+  border-bottom: 1px solid var(--border);
+}
+
 .cfg-array__help {
   padding: 12px 18px;
   font-size: 12px;
@@ -1259,6 +1423,18 @@
   height: 100%;
 }
 
+.cfg-map > .cfg-field__assist {
+  padding: 10px 18px;
+  border-bottom: 1px solid var(--border);
+}
+
+.cfg-map__meta {
+  padding: 10px 18px;
+  font-size: 12px;
+  color: var(--muted);
+  border-bottom: 1px solid var(--border);
+}
+
 .cfg-map__empty {
   padding: 28px 18px;
   text-align: center;
diff --git a/ui/src/ui/app-render.ts b/ui/src/ui/app-render.ts
index d416bde447ef..b948b05301e5 100644
--- a/ui/src/ui/app-render.ts
+++ b/ui/src/ui/app-render.ts
@@ -236,6 +236,7 @@ export function renderApp(state: AppViewState) {
                 },
                 onConnect: () => state.connect(),
                 onRefresh: () => state.loadOverview(),
+                onNavigate: (tab) => state.setTab(tab),
               })
             : nothing
         }
diff --git a/ui/src/ui/config-form.browser.test.ts b/ui/src/ui/config-form.browser.test.ts
index 292c5780b35a..6e165ca3e7d7 100644
--- a/ui/src/ui/config-form.browser.test.ts
+++ b/ui/src/ui/config-form.browser.test.ts
@@ -158,6 +158,121 @@ describe("config form renderer", () => {
     expect(onPatch).toHaveBeenCalledWith(["slack"], {});
   });
 
+  it("shows contextual map-key guidance for discord guild maps", () => {
+    const onPatch = vi.fn();
+    const container = document.createElement("div");
+    const schema = {
+      type: "object",
+      properties: {
+        channels: {
+          type: "object",
+          properties: {
+            discord: {
+              type: "object",
+              properties: {
+                guilds: {
+                  type: "object",
+                  additionalProperties: {
+                    type: "string",
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    };
+    const analysis = analyzeConfigSchema(schema);
+    render(
+      renderConfigForm({
+        schema: analysis.schema,
+        uiHints: {},
+        unsupportedPaths: analysis.unsupportedPaths,
+        value: { channels: { discord: { guilds: { "123456789012345678": "on" } } } },
+        onPatch,
+      }),
+      container,
+    );
+
+    const addButton = Array.from(
+      container.querySelectorAll<HTMLButtonElement>(".cfg-map__add"),
+    ).find((button) => button.textContent?.includes("Add Guild"));
+    expect(addButton).toBeDefined();
+    expect(container.textContent).toContain("Use Discord guild IDs");
+    expect(
+      container
+        .querySelector<HTMLInputElement>(".cfg-map__item-key input")
+        ?.getAttribute("placeholder"),
+    ).toBe("123456789012345678");
+  });
+
+  it("uses singular add labels for arrays with named hints", () => {
+    const onPatch = vi.fn();
+    const container = document.createElement("div");
+    const schema = {
+      type: "object",
+      properties: {
+        owners: {
+          type: "array",
+          items: { type: "string" },
+        },
+      },
+    };
+    const analysis = analyzeConfigSchema(schema);
+    render(
+      renderConfigForm({
+        schema: analysis.schema,
+        uiHints: {
+          owners: { label: "Owners" },
+        },
+        unsupportedPaths: analysis.unsupportedPaths,
+        value: { owners: [] },
+        onPatch,
+      }),
+      container,
+    );
+
+    expect(container.textContent).toContain("Add Owner");
+    expect(container.textContent).toContain("Each owner expects text.");
+  });
+
+  it("applies fallback hints when backend uiHints are missing", () => {
+    const onPatch = vi.fn();
+    const container = document.createElement("div");
+    const schema = {
+      type: "object",
+      properties: {
+        channels: {
+          type: "object",
+          properties: {
+            discord: {
+              type: "object",
+              properties: {
+                allowBots: { type: "boolean" },
+              },
+            },
+          },
+        },
+      },
+    };
+    const analysis = analyzeConfigSchema(schema);
+    render(
+      renderConfigForm({
+        schema: analysis.schema,
+        uiHints: {},
+        unsupportedPaths: analysis.unsupportedPaths,
+        value: { channels: { discord: { allowBots: true } } },
+        onPatch,
+      }),
+      container,
+    );
+
+    expect(container.textContent).toContain("Allow replies to bot-authored messages");
+    expect(container.textContent).toContain("bot-to-bot reply loops");
+    const docsLink = container.querySelector("a.cfg-field__docs");
+    expect(docsLink?.getAttribute("href")).toBe("https://docs.openclaw.ai/gateway/configuration");
+  });
+
   it("supports wildcard uiHints for map entries", () => {
     const onPatch = vi.fn();
     const container = document.createElement("div");
@@ -197,6 +312,165 @@ describe("config form renderer", () => {
     expect(container.textContent).toContain("Plugin Enabled");
   });
 
+  it("groups fields by uiHints and collapses advanced groups", () => {
+    const onPatch = vi.fn();
+    const container = document.createElement("div");
+    const schema = {
+      type: "object",
+      properties: {
+        server: {
+          type: "object",
+          properties: {
+            host: { type: "string" },
+            port: { type: "number" },
+            token: { type: "string" },
+          },
+        },
+      },
+    };
+    const analysis = analyzeConfigSchema(schema);
+    render(
+      renderConfigForm({
+        schema: analysis.schema,
+        uiHints: {
+          "server.host": { group: "Connection" },
+          "server.port": { group: "Connection" },
+          "server.token": { group: "Security", advanced: true },
+        },
+        unsupportedPaths: analysis.unsupportedPaths,
+        value: { server: { host: "localhost", port: 8080, token: "secret" } },
+        onPatch,
+      }),
+      container,
+    );
+
+    expect(container.textContent).toContain("Connection");
+    const advancedGroup = Array.from(
+      container.querySelectorAll("details.cfg-group--advanced"),
+    ).find((el) => el.textContent?.includes("Security"));
+    expect(advancedGroup).toBeDefined();
+    expect((advancedGroup as HTMLDetailsElement).open).toBe(false);
+  });
+
+  it("collapses deep nested objects by default", () => {
+    const onPatch = vi.fn();
+    const container = document.createElement("div");
+    const schema = {
+      type: "object",
+      properties: {
+        gateway: {
+          type: "object",
+          properties: {
+            nested: {
+              type: "object",
+              properties: {
+                actions: {
+                  type: "object",
+                  properties: {
+                    enabled: { type: "boolean" },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    };
+    const analysis = analyzeConfigSchema(schema);
+    render(
+      renderConfigForm({
+        schema: analysis.schema,
+        uiHints: {},
+        unsupportedPaths: analysis.unsupportedPaths,
+        value: { gateway: { nested: { actions: { enabled: true } } } },
+        onPatch,
+      }),
+      container,
+    );
+
+    const deepObject = Array.from(container.querySelectorAll("details.cfg-object")).find((el) => {
+      const title = el.querySelector(".cfg-object__title")?.textContent?.trim();
+      return title === "Actions";
+    });
+    expect(deepObject).toBeDefined();
+    expect((deepObject as HTMLDetailsElement).open).toBe(false);
+  });
+
+  it("surfaces impact warnings and applies quick fixes", () => {
+    const onPatch = vi.fn();
+    const container = document.createElement("div");
+    const schema = {
+      type: "object",
+      properties: {
+        channels: {
+          type: "object",
+          properties: {
+            discord: {
+              type: "object",
+              properties: {
+                actions: {
+                  type: "object",
+                  properties: {
+                    roles: { type: "boolean" },
+                    permissions: { type: "boolean" },
+                  },
+                },
+              },
+            },
+          },
+        },
+      },
+    };
+    const analysis = analyzeConfigSchema(schema);
+    render(
+      renderConfigForm({
+        schema: analysis.schema,
+        uiHints: {
+          "channels.discord.actions.roles": {
+            docsPath: "/channels/discord",
+            impacts: [
+              {
+                relation: "requires",
+                when: "truthy",
+                targetPath: "channels.discord.actions.permissions",
+                targetWhen: "truthy",
+                message: "Role management depends on permissions actions being enabled.",
+                fixValue: true,
+                fixLabel: "Enable permissions",
+              },
+            ],
+          },
+        },
+        unsupportedPaths: analysis.unsupportedPaths,
+        value: {
+          channels: {
+            discord: {
+              actions: {
+                roles: true,
+                permissions: false,
+              },
+            },
+          },
+        },
+        onPatch,
+      }),
+      container,
+    );
+
+    expect(container.textContent).toContain(
+      "Role management depends on permissions actions being enabled.",
+    );
+    const docsLink = container.querySelector("a.cfg-field__docs");
+    expect(docsLink?.getAttribute("href")).toBe("https://docs.openclaw.ai/channels/discord");
+
+    const fixButton = Array.from(container.querySelectorAll("button")).find(
+      (btn) => btn.textContent?.trim() === "Enable permissions",
+    );
+    expect(fixButton).toBeDefined();
+    fixButton?.dispatchEvent(new MouseEvent("click", { bubbles: true }));
+    expect(onPatch).toHaveBeenCalledWith(["channels", "discord", "actions", "permissions"], true);
+  });
+
   it("flags unsupported unions", () => {
     const schema = {
       type: "object",
diff --git a/ui/src/ui/presenter.ts b/ui/src/ui/presenter.ts
index 7c99380a8612..9cd5e8e7ee26 100644
--- a/ui/src/ui/presenter.ts
+++ b/ui/src/ui/presenter.ts
@@ -21,13 +21,27 @@ export function formatNextRun(ms?: number | null) {
   return `${formatMs(ms)} (${formatAgo(ms)})`;
 }
 
+function formatTokenCount(n: number): string {
+  if (n >= 1_000_000) {
+    const val = n / 1_000_000;
+    return val % 1 === 0 ? `${val}M` : `${val.toFixed(1)}M`;
+  }
+  if (n >= 1_000) {
+    const val = n / 1_000;
+    return val % 1 === 0 ? `${val}K` : `${val.toFixed(1)}K`;
+  }
+  return String(n);
+}
+
 export function formatSessionTokens(row: GatewaySessionRow) {
   if (row.totalTokens == null) {
     return "n/a";
   }
   const total = row.totalTokens ?? 0;
   const ctx = row.contextTokens ?? 0;
-  return ctx ? `${total} / ${ctx}` : String(total);
+  return ctx
+    ? `${formatTokenCount(total)} / ${formatTokenCount(ctx)} tokens`
+    : `${formatTokenCount(total)} tokens`;
 }
 
 export function formatEventPayload(payload: unknown): string {
diff --git a/ui/src/ui/types.ts b/ui/src/ui/types.ts
index 1c85b87319b6..c031a6619204 100644
--- a/ui/src/ui/types.ts
+++ b/ui/src/ui/types.ts
@@ -15,6 +15,9 @@ export type ChannelUiMetaEntry = {
   label: string;
   detailLabel: string;
   systemImage?: string;
+  description?: string;
+  docsPath?: string;
+  docsLabel?: string;
 };
 
 export const CRON_CHANNEL_LAST = "last";
@@ -282,6 +285,7 @@ export type ConfigSnapshot = {
 };
 
 export type ConfigUiHint = {
+  docsPath?: string;
   label?: string;
   help?: string;
   group?: string;
@@ -290,6 +294,20 @@ export type ConfigUiHint = {
   sensitive?: boolean;
   placeholder?: string;
   itemTemplate?: unknown;
+  impacts?: ConfigUiHintImpact[];
+};
+
+export type ConfigUiHintImpact = {
+  relation?: "requires" | "conflicts" | "recommends" | "risk";
+  targetPath?: string;
+  when?: "truthy" | "falsy" | "defined" | "notDefined" | "equals" | "notEquals" | "includes";
+  whenValue?: unknown;
+  targetWhen?: "truthy" | "falsy" | "defined" | "notDefined" | "equals" | "notEquals" | "includes";
+  targetValue?: unknown;
+  message: string;
+  fixValue?: unknown;
+  fixLabel?: string;
+  docsPath?: string;
 };
 
 export type ConfigUiHints = Record<string, ConfigUiHint>;
diff --git a/ui/src/ui/views/channels.config.test.ts b/ui/src/ui/views/channels.config.test.ts
new file mode 100644
index 000000000000..351899438d48
--- /dev/null
+++ b/ui/src/ui/views/channels.config.test.ts
@@ -0,0 +1,75 @@
+import { render } from "lit";
+import { describe, expect, it, vi } from "vitest";
+import type { ChannelsProps } from "./channels.types.ts";
+import { renderChannelConfigSection } from "./channels.config.ts";
+
+function makeProps(overrides: Record<string, unknown> = {}): ChannelsProps {
+  return {
+    configSaving: false,
+    configSchemaLoading: false,
+    configFormDirty: false,
+    configForm: {
+      channels: {
+        discord: {
+          enabled: true,
+        },
+      },
+    },
+    configSchema: {
+      type: "object",
+      properties: {
+        channels: {
+          type: "object",
+          properties: {
+            discord: {
+              type: "object",
+              properties: {
+                enabled: { type: "boolean" },
+              },
+            },
+          },
+        },
+      },
+    },
+    configUiHints: {},
+    onConfigPatch: vi.fn(),
+    onConfigSave: vi.fn(),
+    onConfigReload: vi.fn(),
+    ...overrides,
+  } as unknown as ChannelsProps;
+}
+
+describe("channel config section", () => {
+  it("keeps channel settings collapsed by default", () => {
+    const container = document.createElement("div");
+    render(renderChannelConfigSection({ channelId: "discord", props: makeProps() }), container);
+
+    const details = container.querySelector<HTMLDetailsElement>("details.cfg-group--advanced");
+    expect(details).not.toBeNull();
+    expect(details?.open).toBe(false);
+
+    const saveButton = Array.from(container.querySelectorAll("button")).find(
+      (btn) => btn.textContent?.trim() === "Save",
+    );
+    const reloadButton = Array.from(container.querySelectorAll("button")).find(
+      (btn) => btn.textContent?.trim() === "Reload",
+    );
+    expect(saveButton?.className).toContain("primary");
+    expect(reloadButton?.className).toContain("quiet");
+  });
+
+  it("expands channel settings when form is dirty", () => {
+    const container = document.createElement("div");
+    render(
+      renderChannelConfigSection({
+        channelId: "discord",
+        props: makeProps({ configFormDirty: true }),
+      }),
+      container,
+    );
+
+    const details = container.querySelector<HTMLDetailsElement>("details.cfg-group--advanced");
+    expect(details).not.toBeNull();
+    expect(details?.open).toBe(true);
+  });
+});
diff --git a/ui/src/ui/views/channels.config.ts b/ui/src/ui/views/channels.config.ts
index b94b750134d5..17c03fc3cf81 100644
--- a/ui/src/ui/views/channels.config.ts
+++ b/ui/src/ui/views/channels.config.ts
@@ -124,6 +124,7 @@ export function renderChannelConfigForm(props: ChannelConfigFormProps) {
       ${renderNode({
         schema: node,
         value,
+        rootValue: configValue,
         path: ["channels", props.channelId],
         hints: props.uiHints,
         unsupported: new Set(analysis.unsupportedPaths),
@@ -139,38 +140,44 @@ export function renderChannelConfigForm(props: ChannelConfigFormProps) {
 export function renderChannelConfigSection(params: { channelId: string; props: ChannelsProps }) {
   const { channelId, props } = params;
   const disabled = props.configSaving || props.configSchemaLoading;
+  const openEditor = props.configFormDirty || props.configSchemaLoading;
   return html`
     <div style="margin-top: 16px;">
-      ${
-        props.configSchemaLoading
-          ? html`
-              <div class="muted">Loading config schema…</div>
-            `
-          : renderChannelConfigForm({
-              channelId,
-              configValue: props.configForm,
-              schema: props.configSchema,
-              uiHints: props.configUiHints,
-              disabled,
-              onPatch: props.onConfigPatch,
-            })
-      }
-      <div class="row" style="margin-top: 12px;">
-        <button
-          class="btn primary"
-          ?disabled=${disabled || !props.configFormDirty}
-          @click=${() => props.onConfigSave()}
-        >
-          ${props.configSaving ? "Saving…" : "Save"}
-        </button>
-        <button
-          class="btn"
-          ?disabled=${disabled}
-          @click=${() => props.onConfigReload()}
-        >
-          Reload
-        </button>
-      </div>
+      <details class="cfg-group cfg-group--advanced" ?open=${openEditor}>
+        <summary>Channel settings</summary>
+        <div class="cfg-group__body">
+          ${
+            props.configSchemaLoading
+              ? html`
+                  <div class="muted">Loading config schema…</div>
+                `
+              : renderChannelConfigForm({
+                  channelId,
+                  configValue: props.configForm,
+                  schema: props.configSchema,
+                  uiHints: props.configUiHints,
+                  disabled,
+                  onPatch: props.onConfigPatch,
+                })
+          }
+          <div class="section-header__actions">
+            <button
+              class="btn primary"
+              ?disabled=${disabled || !props.configFormDirty}
+              @click=${() => props.onConfigSave()}
+            >
+              ${props.configSaving ? "Saving…" : "Save"}
+            </button>
+            <button
+              class="btn quiet"
+              ?disabled=${disabled}
+              @click=${() => props.onConfigReload()}
+            >
+              Reload
+            </button>
+          </div>
+        </div>
+      </details>
     </div>
   `;
 }
diff --git a/ui/src/ui/views/channels.discord.ts b/ui/src/ui/views/channels.discord.ts
index 69df08288b14..73b9d9e7eedb 100644
--- a/ui/src/ui/views/channels.discord.ts
+++ b/ui/src/ui/views/channels.discord.ts
@@ -3,6 +3,7 @@ import type { DiscordStatus } from "../types.ts";
 import type { ChannelsProps } from "./channels.types.ts";
 import { formatAgo } from "../format.ts";
 import { renderChannelConfigSection } from "./channels.config.ts";
+import { renderChannelHeader } from "./channels.shared.ts";
 
 export function renderDiscordCard(params: {
   props: ChannelsProps;
@@ -13,8 +14,15 @@ export function renderDiscordCard(params: {
 
   return html`
     <div class="card">
-      <div class="card-title">Discord</div>
-      <div class="card-sub">Bot status and channel configuration.</div>
+      ${renderChannelHeader({
+        channelId: "discord",
+        props,
+        fallbackTitle: "Discord",
+        fallbackSub: "Bot status and channel configuration.",
+        actions: html`<button class="btn quiet btn--sm" @click=${() => props.onRefresh(true)}>
+          Probe
+        </button>`,
+      })}
       ${accountCountLabel}
 
       <div class="status-list" style="margin-top: 16px;">
@@ -46,20 +54,21 @@ export function renderDiscordCard(params: {
 
       ${
         discord?.probe
-          ? html`<div class="callout" style="margin-top: 12px;">
-            Probe ${discord.probe.ok ? "ok" : "failed"} ·
-            ${discord.probe.status ?? ""} ${discord.probe.error ?? ""}
-          </div>`
+          ? html`
+              <details class="cfg-group cfg-group--advanced" style="margin-top: 12px;">
+                <summary>Latest probe</summary>
+                <div class="cfg-group__body">
+                  <div class="callout">
+                    Probe ${discord.probe.ok ? "ok" : "failed"} ·
+                    ${discord.probe.status ?? ""} ${discord.probe.error ?? ""}
+                  </div>
+                </div>
+              </details>
+            `
           : nothing
       }
 
       ${renderChannelConfigSection({ channelId: "discord", props })}
-
-      <div class="row" style="margin-top: 12px;">
-        <button class="btn" @click=${() => props.onRefresh(true)}>
-          Probe
-        </button>
-      </div>
     </div>
   `;
 }
diff --git a/ui/src/ui/views/channels.googlechat.ts b/ui/src/ui/views/channels.googlechat.ts
index 506a902816af..180d5fd0c802 100644
--- a/ui/src/ui/views/channels.googlechat.ts
+++ b/ui/src/ui/views/channels.googlechat.ts
@@ -3,6 +3,7 @@ import type { GoogleChatStatus } from "../types.ts";
 import type { ChannelsProps } from "./channels.types.ts";
 import { formatAgo } from "../format.ts";
 import { renderChannelConfigSection } from "./channels.config.ts";
+import { renderChannelHeader } from "./channels.shared.ts";
 
 export function renderGoogleChatCard(params: {
   props: ChannelsProps;
@@ -13,8 +14,15 @@ export function renderGoogleChatCard(params: {
 
   return html`
     <div class="card">
-      <div class="card-title">Google Chat</div>
-      <div class="card-sub">Chat API webhook status and channel configuration.</div>
+      ${renderChannelHeader({
+        channelId: "googlechat",
+        props,
+        fallbackTitle: "Google Chat",
+        fallbackSub: "Chat API webhook status and channel configuration.",
+        actions: html`<button class="btn quiet btn--sm" @click=${() => props.onRefresh(true)}>
+          Probe
+        </button>`,
+      })}
       ${accountCountLabel}
 
       <div class="status-list" style="margin-top: 16px;">
@@ -68,12 +76,6 @@ export function renderGoogleChatCard(params: {
       }
 
       ${renderChannelConfigSection({ channelId: "googlechat", props })}
-
-      <div class="row" style="margin-top: 12px;">
-        <button class="btn" @click=${() => props.onRefresh(true)}>
-          Probe
-        </button>
-      </div>
     </div>
   `;
 }
diff --git a/ui/src/ui/views/channels.imessage.ts b/ui/src/ui/views/channels.imessage.ts
index c54cd6c5e4f2..95f9a60517ce 100644
--- a/ui/src/ui/views/channels.imessage.ts
+++ b/ui/src/ui/views/channels.imessage.ts
@@ -3,6 +3,7 @@ import type { IMessageStatus } from "../types.ts";
 import type { ChannelsProps } from "./channels.types.ts";
 import { formatAgo } from "../format.ts";
 import { renderChannelConfigSection } from "./channels.config.ts";
+import { renderChannelHeader } from "./channels.shared.ts";
 
 export function renderIMessageCard(params: {
   props: ChannelsProps;
@@ -13,8 +14,15 @@ export function renderIMessageCard(params: {
 
   return html`
     <div class="card">
-      <div class="card-title">iMessage</div>
-      <div class="card-sub">macOS bridge status and channel configuration.</div>
+      ${renderChannelHeader({
+        channelId: "imessage",
+        props,
+        fallbackTitle: "iMessage",
+        fallbackSub: "macOS bridge status and channel configuration.",
+        actions: html`<button class="btn quiet btn--sm" @click=${() => props.onRefresh(true)}>
+          Probe
+        </button>`,
+      })}
       ${accountCountLabel}
 
       <div class="status-list" style="margin-top: 16px;">
@@ -54,12 +62,6 @@ export function renderIMessageCard(params: {
       }
 
       ${renderChannelConfigSection({ channelId: "imessage", props })}
-
-      <div class="row" style="margin-top: 12px;">
-        <button class="btn" @click=${() => props.onRefresh(true)}>
-          Probe
-        </button>
-      </div>
     </div>
   `;
 }
diff --git a/ui/src/ui/views/channels.nostr.ts b/ui/src/ui/views/channels.nostr.ts
index 8bd8b7c0443a..a670b366d6f1 100644
--- a/ui/src/ui/views/channels.nostr.ts
+++ b/ui/src/ui/views/channels.nostr.ts
@@ -8,6 +8,7 @@ import {
   type NostrProfileFormState,
   type NostrProfileFormCallbacks,
 } from "./channels.nostr-profile-form.ts";
+import { renderChannelHeader } from "./channels.shared.ts";
 
 /**
  * Truncate a pubkey for display (shows first and last 8 chars)
@@ -184,8 +185,15 @@ export function renderNostrCard(params: {
 
   return html`
     <div class="card">
-      <div class="card-title">Nostr</div>
-      <div class="card-sub">Decentralized DMs via Nostr relays (NIP-04).</div>
+      ${renderChannelHeader({
+        channelId: "nostr",
+        props,
+        fallbackTitle: "Nostr",
+        fallbackSub: "Decentralized DMs via Nostr relays (NIP-04).",
+        actions: html`<button class="btn quiet btn--sm" @click=${() => props.onRefresh(false)}>
+          Refresh
+        </button>`,
+      })}
       ${accountCountLabel}
 
       ${
@@ -228,10 +236,6 @@ export function renderNostrCard(params: {
       ${renderProfileSection()}
 
       ${renderChannelConfigSection({ channelId: "nostr", props })}
-
-      <div class="row" style="margin-top: 12px;">
-        <button class="btn" @click=${() => props.onRefresh(false)}>Refresh</button>
-      </div>
     </div>
   `;
 }
diff --git a/ui/src/ui/views/channels.shared.test.ts b/ui/src/ui/views/channels.shared.test.ts
new file mode 100644
index 000000000000..9f7e51dd5f50
--- /dev/null
+++ b/ui/src/ui/views/channels.shared.test.ts
@@ -0,0 +1,50 @@
+import { render } from "lit";
+import { describe, expect, it } from "vitest";
+import type { ChannelsProps } from "./channels.types.ts";
+import { renderChannelHeader } from "./channels.shared.ts";
+
+function makeProps(overrides: Record<string, unknown> = {}): ChannelsProps {
+  return {
+    snapshot: null,
+    ...overrides,
+  } as unknown as ChannelsProps;
+}
+
+describe("channel header", () => {
+  it("renders docs guide links from channel metadata", () => {
+    const container = document.createElement("div");
+    const props = makeProps({
+      snapshot: {
+        ts: Date.now(),
+        channelOrder: ["discord"],
+        channelLabels: { discord: "Discord" },
+        channels: {},
+        channelAccounts: {},
+        channelDefaultAccountId: {},
+        channelMeta: [
+          {
+            id: "discord",
+            label: "Discord",
+            detailLabel: "Discord Bot",
+            description: "Bot status and channel configuration.",
+            docsPath: "/channels/discord",
+          },
+        ],
+      },
+    });
+
+    render(
+      renderChannelHeader({
+        channelId: "discord",
+        props,
+        fallbackTitle: "Discord",
+        fallbackSub: "Fallback summary",
+      }),
+      container,
+    );
+
+    expect(container.textContent).toContain("Bot status and channel configuration.");
+    const guideLink = container.querySelector("a.btn.quiet");
+    expect(guideLink?.getAttribute("href")).toBe("https://docs.openclaw.ai/channels/discord");
+  });
+});
diff --git a/ui/src/ui/views/channels.shared.ts b/ui/src/ui/views/channels.shared.ts
index 343c60b11fd6..8e844523f428 100644
--- a/ui/src/ui/views/channels.shared.ts
+++ b/ui/src/ui/views/channels.shared.ts
@@ -1,5 +1,9 @@
 import { html, nothing } from "lit";
-import type { ChannelAccountSnapshot } from "../types.ts";
+import type {
+  ChannelAccountSnapshot,
+  ChannelUiMetaEntry,
+  ChannelsStatusSnapshot,
+} from "../types.ts";
 import type { ChannelKey, ChannelsProps } from "./channels.types.ts";
 
 export function formatDuration(ms?: number | null) {
@@ -52,3 +56,93 @@ export function renderChannelAccountCount(
   }
   return html`<div class="account-count">Accounts (${count})</div>`;
 }
+
+function resolveChannelMetaMap(
+  snapshot: ChannelsStatusSnapshot | null,
+): Record<string, ChannelUiMetaEntry> {
+  if (!snapshot?.channelMeta?.length) {
+    return {};
+  }
+  return Object.fromEntries(snapshot.channelMeta.map((entry) => [entry.id, entry]));
+}
+
+export function resolveChannelMeta(
+  snapshot: ChannelsStatusSnapshot | null,
+  key: string,
+): ChannelUiMetaEntry | null {
+  return resolveChannelMetaMap(snapshot)[key] ?? null;
+}
+
+export function resolveChannelLabel(snapshot: ChannelsStatusSnapshot | null, key: string): string {
+  const meta = resolveChannelMeta(snapshot, key);
+  return meta?.label ?? snapshot?.channelLabels?.[key] ?? key;
+}
+
+export function resolveChannelDescription(
+  snapshot: ChannelsStatusSnapshot | null,
+  key: string,
+  fallback: string,
+): string {
+  const meta = resolveChannelMeta(snapshot, key);
+  return meta?.description?.trim() || fallback;
+}
+
+function toDocsUrl(path?: string): string | null {
+  const raw = path?.trim();
+  if (!raw) {
+    return null;
+  }
+  if (raw.startsWith("http://") || raw.startsWith("https://")) {
+    return raw;
+  }
+  if (!raw.startsWith("/")) {
+    return `https://docs.openclaw.ai/${raw}`;
+  }
+  return `https://docs.openclaw.ai${raw}`;
+}
+
+export function resolveChannelDocsUrl(
+  snapshot: ChannelsStatusSnapshot | null,
+  key: string,
+): string | null {
+  const meta = resolveChannelMeta(snapshot, key);
+  return toDocsUrl(meta?.docsPath);
+}
+
+export function renderChannelHeader(params: {
+  channelId: string;
+  props: ChannelsProps;
+  fallbackTitle: string;
+  fallbackSub: string;
+  actions?: unknown;
+}) {
+  const title =
+    resolveChannelLabel(params.props.snapshot, params.channelId) ?? params.fallbackTitle;
+  const description = resolveChannelDescription(
+    params.props.snapshot,
+    params.channelId,
+    params.fallbackSub,
+  );
+  const docsUrl = resolveChannelDocsUrl(params.props.snapshot, params.channelId);
+
+  return html`
+    <div class="section-header">
+      <div class="section-header__meta">
+        <div class="card-title">${title}</div>
+        <div class="card-sub">${description}</div>
+      </div>
+      <div class="section-header__actions">
+        ${
+          docsUrl
+            ? html`
+                <a class="btn quiet btn--sm" href=${docsUrl} target="_blank" rel="noreferrer">
+                  Guide
+                </a>
+              `
+            : nothing
+        }
+        ${params.actions ?? nothing}
+      </div>
+    </div>
+  `;
+}
diff --git a/ui/src/ui/views/channels.signal.ts b/ui/src/ui/views/channels.signal.ts
index a2f2327c28c0..cb3df08be24f 100644
--- a/ui/src/ui/views/channels.signal.ts
+++ b/ui/src/ui/views/channels.signal.ts
@@ -3,6 +3,7 @@ import type { SignalStatus } from "../types.ts";
 import type { ChannelsProps } from "./channels.types.ts";
 import { formatAgo } from "../format.ts";
 import { renderChannelConfigSection } from "./channels.config.ts";
+import { renderChannelHeader } from "./channels.shared.ts";
 
 export function renderSignalCard(params: {
   props: ChannelsProps;
@@ -13,8 +14,15 @@ export function renderSignalCard(params: {
 
   return html`
     <div class="card">
-      <div class="card-title">Signal</div>
-      <div class="card-sub">signal-cli status and channel configuration.</div>
+      ${renderChannelHeader({
+        channelId: "signal",
+        props,
+        fallbackTitle: "Signal",
+        fallbackSub: "signal-cli status and channel configuration.",
+        actions: html`<button class="btn quiet btn--sm" @click=${() => props.onRefresh(true)}>
+          Probe
+        </button>`,
+      })}
       ${accountCountLabel}
 
       <div class="status-list" style="margin-top: 16px;">
@@ -58,12 +66,6 @@ export function renderSignalCard(params: {
       }
 
       ${renderChannelConfigSection({ channelId: "signal", props })}
-
-      <div class="row" style="margin-top: 12px;">
-        <button class="btn" @click=${() => props.onRefresh(true)}>
-          Probe
-        </button>
-      </div>
     </div>
   `;
 }
diff --git a/ui/src/ui/views/channels.slack.ts b/ui/src/ui/views/channels.slack.ts
index 91180de313ea..06f4afa4c2be 100644
--- a/ui/src/ui/views/channels.slack.ts
+++ b/ui/src/ui/views/channels.slack.ts
@@ -3,6 +3,7 @@ import type { SlackStatus } from "../types.ts";
 import type { ChannelsProps } from "./channels.types.ts";
 import { formatAgo } from "../format.ts";
 import { renderChannelConfigSection } from "./channels.config.ts";
+import { renderChannelHeader } from "./channels.shared.ts";
 
 export function renderSlackCard(params: {
   props: ChannelsProps;
@@ -13,8 +14,15 @@ export function renderSlackCard(params: {
 
   return html`
     <div class="card">
-      <div class="card-title">Slack</div>
-      <div class="card-sub">Socket mode status and channel configuration.</div>
+      ${renderChannelHeader({
+        channelId: "slack",
+        props,
+        fallbackTitle: "Slack",
+        fallbackSub: "Socket mode status and channel configuration.",
+        actions: html`<button class="btn quiet btn--sm" @click=${() => props.onRefresh(true)}>
+          Probe
+        </button>`,
+      })}
       ${accountCountLabel}
 
       <div class="status-list" style="margin-top: 16px;">
@@ -54,12 +62,6 @@ export function renderSlackCard(params: {
       }
 
       ${renderChannelConfigSection({ channelId: "slack", props })}
-
-      <div class="row" style="margin-top: 12px;">
-        <button class="btn" @click=${() => props.onRefresh(true)}>
-          Probe
-        </button>
-      </div>
     </div>
   `;
 }
diff --git a/ui/src/ui/views/channels.telegram.ts b/ui/src/ui/views/channels.telegram.ts
index 270ae078273c..7634bc790cf8 100644
--- a/ui/src/ui/views/channels.telegram.ts
+++ b/ui/src/ui/views/channels.telegram.ts
@@ -3,6 +3,7 @@ import type { ChannelAccountSnapshot, TelegramStatus } from "../types.ts";
 import type { ChannelsProps } from "./channels.types.ts";
 import { formatAgo } from "../format.ts";
 import { renderChannelConfigSection } from "./channels.config.ts";
+import { renderChannelHeader } from "./channels.shared.ts";
 
 export function renderTelegramCard(params: {
   props: ChannelsProps;
@@ -54,8 +55,15 @@ export function renderTelegramCard(params: {
 
   return html`
     <div class="card">
-      <div class="card-title">Telegram</div>
-      <div class="card-sub">Bot status and channel configuration.</div>
+      ${renderChannelHeader({
+        channelId: "telegram",
+        props,
+        fallbackTitle: "Telegram",
+        fallbackSub: "Bot status and channel configuration.",
+        actions: html`<button class="btn quiet btn--sm" @click=${() => props.onRefresh(true)}>
+          Probe
+        </button>`,
+      })}
       ${accountCountLabel}
 
       ${
@@ -109,12 +117,6 @@ export function renderTelegramCard(params: {
       }
 
       ${renderChannelConfigSection({ channelId: "telegram", props })}
-
-      <div class="row" style="margin-top: 12px;">
-        <button class="btn" @click=${() => props.onRefresh(true)}>
-          Probe
-        </button>
-      </div>
     </div>
   `;
 }
diff --git a/ui/src/ui/views/channels.ts b/ui/src/ui/views/channels.ts
index c1983fef076c..155a8f8eacc9 100644
--- a/ui/src/ui/views/channels.ts
+++ b/ui/src/ui/views/channels.ts
@@ -1,7 +1,6 @@
 import { html, nothing } from "lit";
 import type {
   ChannelAccountSnapshot,
-  ChannelUiMetaEntry,
   ChannelsStatusSnapshot,
   DiscordStatus,
   GoogleChatStatus,
@@ -20,7 +19,12 @@ import { renderDiscordCard } from "./channels.discord.ts";
 import { renderGoogleChatCard } from "./channels.googlechat.ts";
 import { renderIMessageCard } from "./channels.imessage.ts";
 import { renderNostrCard } from "./channels.nostr.ts";
-import { channelEnabled, renderChannelAccountCount } from "./channels.shared.ts";
+import {
+  channelEnabled,
+  renderChannelAccountCount,
+  renderChannelHeader,
+  resolveChannelLabel,
+} from "./channels.shared.ts";
 import { renderSignalCard } from "./channels.signal.ts";
 import { renderSlackCard } from "./channels.slack.ts";
 import { renderTelegramCard } from "./channels.telegram.ts";
@@ -68,13 +72,17 @@ export function renderChannels(props: ChannelsProps) {
     </section>
 
     <section class="card" style="margin-top: 18px;">
-      <div class="row" style="justify-content: space-between;">
-        <div>
+      <div class="section-header">
+        <div class="section-header__meta">
           <div class="card-title">Channel health</div>
           <div class="card-sub">Channel status snapshots from the gateway.</div>
         </div>
         <div class="muted">${props.lastSuccessAt ? formatAgo(props.lastSuccessAt) : "n/a"}</div>
       </div>
+      <div class="callout" style="margin-top: 12px;">
+        If setup is unclear or replies are missing, run <code>openclaw doctor</code> and
+        <code>openclaw channels status --probe</code> to get targeted fixes.
+      </div>
       ${
         props.lastError
           ? html`<div class="callout danger" style="margin-top: 12px;">
@@ -82,9 +90,12 @@ export function renderChannels(props: ChannelsProps) {
           </div>`
           : nothing
       }
-      <pre class="code-block" style="margin-top: 12px;">
+      <details class="cfg-group cfg-group--advanced" style="margin-top: 12px;">
+        <summary>Show raw data</summary>
+        <pre class="code-block" style="margin-top: 8px;">
 ${props.snapshot ? JSON.stringify(props.snapshot, null, 2) : "No snapshot yet."}
-      </pre>
+        </pre>
+      </details>
     </section>
   `;
 }
@@ -193,8 +204,12 @@ function renderGenericChannelCard(
 
   return html`
     <div class="card">
-      <div class="card-title">${label}</div>
-      <div class="card-sub">Channel status and configuration.</div>
+      ${renderChannelHeader({
+        channelId: key,
+        props,
+        fallbackTitle: label,
+        fallbackSub: "Channel status and configuration.",
+      })}
       ${accountCountLabel}
 
       ${
@@ -235,20 +250,6 @@ function renderGenericChannelCard(
   `;
 }
 
-function resolveChannelMetaMap(
-  snapshot: ChannelsStatusSnapshot | null,
-): Record<string, ChannelUiMetaEntry> {
-  if (!snapshot?.channelMeta?.length) {
-    return {};
-  }
-  return Object.fromEntries(snapshot.channelMeta.map((entry) => [entry.id, entry]));
-}
-
-function resolveChannelLabel(snapshot: ChannelsStatusSnapshot | null, key: string): string {
-  const meta = resolveChannelMetaMap(snapshot)[key];
-  return meta?.label ?? snapshot?.channelLabels?.[key] ?? key;
-}
-
 const RECENT_ACTIVITY_THRESHOLD_MS = 10 * 60 * 1000; // 10 minutes
 
 function hasRecentActivity(account: ChannelAccountSnapshot): boolean {
diff --git a/ui/src/ui/views/channels.whatsapp.ts b/ui/src/ui/views/channels.whatsapp.ts
index 149861fca946..100812af0e0e 100644
--- a/ui/src/ui/views/channels.whatsapp.ts
+++ b/ui/src/ui/views/channels.whatsapp.ts
@@ -3,7 +3,7 @@ import type { WhatsAppStatus } from "../types.ts";
 import type { ChannelsProps } from "./channels.types.ts";
 import { formatAgo } from "../format.ts";
 import { renderChannelConfigSection } from "./channels.config.ts";
-import { formatDuration } from "./channels.shared.ts";
+import { formatDuration, renderChannelHeader } from "./channels.shared.ts";
 
 export function renderWhatsAppCard(params: {
   props: ChannelsProps;
@@ -14,8 +14,15 @@ export function renderWhatsAppCard(params: {
 
   return html`
     <div class="card">
-      <div class="card-title">WhatsApp</div>
-      <div class="card-sub">Link WhatsApp Web and monitor connection health.</div>
+      ${renderChannelHeader({
+        channelId: "whatsapp",
+        props,
+        fallbackTitle: "WhatsApp",
+        fallbackSub: "Link WhatsApp Web and monitor connection health.",
+        actions: html`<button class="btn quiet btn--sm" @click=${() => props.onRefresh(true)}>
+          Refresh
+        </button>`,
+      })}
       ${accountCountLabel}
 
       <div class="status-list" style="margin-top: 16px;">
@@ -108,9 +115,6 @@ export function renderWhatsAppCard(params: {
         >
           Logout
         </button>
-        <button class="btn" @click=${() => props.onRefresh(true)}>
-          Refresh
-        </button>
       </div>
 
       ${renderChannelConfigSection({ channelId: "whatsapp", props })}
diff --git a/ui/src/ui/views/config-form.node.ts b/ui/src/ui/views/config-form.node.ts
index c37ae6d1258a..06b507326dc1 100644
--- a/ui/src/ui/views/config-form.node.ts
+++ b/ui/src/ui/views/config-form.node.ts
@@ -6,7 +6,9 @@ import {
   humanize,
   isSensitivePath,
   pathKey,
+  resolveConfigImpacts,
   schemaType,
+  toDocsUrl,
   type JsonSchema,
 } from "./config-form.shared.ts";
 
@@ -95,9 +97,218 @@ const icons = {
   `,
 };
 
+type MapFieldGuidance = {
+  addLabel: string;
+  keyPlaceholder: string;
+  keyHelp?: string;
+};
+
+function singularizeLabel(label: string): string {
+  const trimmed = label.trim();
+  if (!trimmed) {
+    return "item";
+  }
+  if (trimmed.endsWith("ies") && trimmed.length > 3) {
+    return `${trimmed.slice(0, -3)}y`;
+  }
+  if (trimmed.endsWith("s") && trimmed.length > 1) {
+    return trimmed.slice(0, -1);
+  }
+  return trimmed;
+}
+
+function inferArrayItemTypeLabel(schema: JsonSchema): string {
+  const type = schemaType(schema);
+  if (type === "string") {
+    return "text";
+  }
+  if (type === "number" || type === "integer") {
+    return "number";
+  }
+  if (type === "boolean") {
+    return "true/false";
+  }
+  if (type === "object") {
+    return "object";
+  }
+  if (type === "array") {
+    return "list";
+  }
+  if (schema.enum?.length) {
+    return "one of the listed options";
+  }
+  return "value";
+}
+
+function inferMapFieldGuidance(
+  path: Array<string | number>,
+  fallbackLabel: string,
+): MapFieldGuidance {
+  const segments = path.filter((segment): segment is string => typeof segment === "string");
+  const leaf = segments[segments.length - 1]?.toLowerCase() ?? "";
+  const secondLast = segments[segments.length - 2]?.toLowerCase() ?? "";
+  const channelId = segments[1]?.toLowerCase();
+
+  if (leaf === "accounts") {
+    return {
+      addLabel: "Add Account",
+      keyPlaceholder: "main",
+      keyHelp: "Use a stable account ID key (for example: main, work, or backup).",
+    };
+  }
+  if (leaf === "guilds") {
+    return {
+      addLabel: "Add Guild",
+      keyPlaceholder: "123456789012345678",
+      keyHelp: "Use Discord guild IDs (or configured slugs).",
+    };
+  }
+  if (leaf === "channels" && (channelId === "discord" || secondLast === "guilds")) {
+    return {
+      addLabel: "Add Channel",
+      keyPlaceholder: "123456789012345678",
+      keyHelp: "Use Discord channel IDs.",
+    };
+  }
+  if (leaf === "channels" && channelId === "slack") {
+    return {
+      addLabel: "Add Channel",
+      keyPlaceholder: "C1234567890",
+      keyHelp: "Use Slack channel IDs (or canonical channel keys from your config).",
+    };
+  }
+  if (leaf === "groups" && channelId === "googlechat") {
+    return {
+      addLabel: "Add Space",
+      keyPlaceholder: "spaces/AAAA1234",
+      keyHelp: "Use Google Chat space IDs.",
+    };
+  }
+  if (leaf === "groups") {
+    return {
+      addLabel: "Add Group",
+      keyPlaceholder: "group-id",
+      keyHelp: "Use a group/chat ID key recognized by this channel.",
+    };
+  }
+  if (leaf === "dms") {
+    return {
+      addLabel: "Add DM",
+      keyPlaceholder: "user-id",
+      keyHelp: "Use the sender/user ID for per-DM overrides.",
+    };
+  }
+  if (leaf === "entries") {
+    return {
+      addLabel: "Add Entry",
+      keyPlaceholder: "plugin-id",
+      keyHelp: "Use a unique entry key (for example a plugin or provider ID).",
+    };
+  }
+  const singular = singularizeLabel(fallbackLabel);
+  return {
+    addLabel: `Add ${humanize(singular)}`,
+    keyPlaceholder: "custom-key",
+  };
+}
+
+function impactToneClass(relation: "requires" | "conflicts" | "recommends" | "risk"): string {
+  if (relation === "requires" || relation === "conflicts") {
+    return "danger";
+  }
+  if (relation === "risk") {
+    return "warn";
+  }
+  return "info";
+}
+
+function renderFieldAssist(params: {
+  path: Array<string | number>;
+  hints: ConfigUiHints;
+  help?: string;
+  rootValue: unknown;
+  disabled: boolean;
+  onPatch: (path: Array<string | number>, value: unknown) => void;
+}): TemplateResult | typeof nothing {
+  const { path, hints, help, rootValue, disabled, onPatch } = params;
+  const hint = hintForPath(path, hints);
+  const docsUrl = toDocsUrl(hint?.docsPath);
+  const impacts = resolveConfigImpacts({ path, hints, rootValue });
+  if (!help && !docsUrl && impacts.length === 0) {
+    return nothing;
+  }
+  return html`
+    <div class="cfg-field__assist">
+      ${help ? html`<div class="cfg-field__help">${help}</div>` : nothing}
+      ${
+        docsUrl
+          ? html`
+              <a
+                class="cfg-field__docs"
+                href=${docsUrl}
+                target="_blank"
+                rel="noreferrer"
+                title="Open docs in a new tab"
+              >
+                Docs
+              </a>
+            `
+          : nothing
+      }
+      ${
+        impacts.length > 0
+          ? html`
+              <div class="cfg-impact-list">
+                ${impacts.map((impact) => {
+                  const docsHref = toDocsUrl(impact.docsPath);
+                  return html`
+                    <div class="cfg-impact cfg-impact--${impactToneClass(impact.relation)}">
+                      <span>${impact.message}</span>
+                      <div class="cfg-impact__actions">
+                        ${
+                          docsHref
+                            ? html`
+                                <a
+                                  class="cfg-impact__link"
+                                  href=${docsHref}
+                                  target="_blank"
+                                  rel="noreferrer"
+                                >
+                                  Guide
+                                </a>
+                              `
+                            : nothing
+                        }
+                        ${
+                          impact.targetPath && impact.fixValue !== undefined
+                            ? html`
+                                <button
+                                  type="button"
+                                  class="btn quiet btn--sm"
+                                  ?disabled=${disabled}
+                                  @click=${() => onPatch(impact.targetPath!.split("."), impact.fixValue)}
+                                >
+                                  ${impact.fixLabel ?? "Apply fix"}
+                                </button>
+                              `
+                            : nothing
+                        }
+                      </div>
+                    </div>
+                  `;
+                })}
+              </div>
+            `
+          : nothing
+      }
+    </div>
+  `;
+}
+
 export function renderNode(params: {
   schema: JsonSchema;
   value: unknown;
+  rootValue: unknown;
   path: Array<string | number>;
   hints: ConfigUiHints;
   unsupported: Set<string>;
@@ -105,7 +316,7 @@ export function renderNode(params: {
   showLabel?: boolean;
   onPatch: (path: Array<string | number>, value: unknown) => void;
 }): TemplateResult | typeof nothing {
-  const { schema, value, path, hints, unsupported, disabled, onPatch } = params;
+  const { schema, value, rootValue, path, hints, unsupported, disabled, onPatch } = params;
   const showLabel = params.showLabel ?? true;
   const type = schemaType(schema);
   const hint = hintForPath(path, hints);
@@ -147,10 +358,18 @@ export function renderNode(params: {
     if (allLiterals && literals.length > 0 && literals.length <= 5) {
       // Use segmented control for small sets
       const resolvedValue = value ?? schema.default;
+      const assist = renderFieldAssist({
+        path,
+        hints,
+        help,
+        rootValue,
+        disabled,
+        onPatch,
+      });
       return html`
         <div class="cfg-field">
           ${showLabel ? html`<label class="cfg-field__label">${label}</label>` : nothing}
-          ${help ? html`<div class="cfg-field__help">${help}</div>` : nothing}
+          ${assist}
           <div class="cfg-segmented">
             ${literals.map(
               (lit) => html`
@@ -212,10 +431,18 @@ export function renderNode(params: {
     const options = schema.enum;
     if (options.length <= 5) {
       const resolvedValue = value ?? schema.default;
+      const assist = renderFieldAssist({
+        path,
+        hints,
+        help,
+        rootValue,
+        disabled,
+        onPatch,
+      });
       return html`
         <div class="cfg-field">
           ${showLabel ? html`<label class="cfg-field__label">${label}</label>` : nothing}
-          ${help ? html`<div class="cfg-field__help">${help}</div>` : nothing}
+          ${assist}
           <div class="cfg-segmented">
             ${options.map(
               (opt) => html`
@@ -254,22 +481,32 @@ export function renderNode(params: {
         : typeof schema.default === "boolean"
           ? schema.default
           : false;
+    const assist = renderFieldAssist({
+      path,
+      hints,
+      help,
+      rootValue,
+      disabled,
+      onPatch,
+    });
     return html`
-      <label class="cfg-toggle-row ${disabled ? "disabled" : ""}">
-        <div class="cfg-toggle-row__content">
-          <span class="cfg-toggle-row__label">${label}</span>
-          ${help ? html`<span class="cfg-toggle-row__help">${help}</span>` : nothing}
-        </div>
-        <div class="cfg-toggle">
-          <input
-            type="checkbox"
-            .checked=${displayValue}
-            ?disabled=${disabled}
-            @change=${(e: Event) => onPatch(path, (e.target as HTMLInputElement).checked)}
-          />
-          <span class="cfg-toggle__track"></span>
-        </div>
-      </label>
+      <div class="cfg-field">
+        <label class="cfg-toggle-row ${disabled ? "disabled" : ""}">
+          <div class="cfg-toggle-row__content">
+            <span class="cfg-toggle-row__label">${label}</span>
+          </div>
+          <div class="cfg-toggle">
+            <input
+              type="checkbox"
+              .checked=${displayValue}
+              ?disabled=${disabled}
+              @change=${(e: Event) => onPatch(path, (e.target as HTMLInputElement).checked)}
+            />
+            <span class="cfg-toggle__track"></span>
+          </div>
+        </label>
+        ${assist}
+      </div>
     `;
   }
 
@@ -295,6 +532,7 @@ export function renderNode(params: {
 function renderTextInput(params: {
   schema: JsonSchema;
   value: unknown;
+  rootValue: unknown;
   path: Array<string | number>;
   hints: ConfigUiHints;
   disabled: boolean;
@@ -302,11 +540,12 @@ function renderTextInput(params: {
   inputType: "text" | "number";
   onPatch: (path: Array<string | number>, value: unknown) => void;
 }): TemplateResult {
-  const { schema, value, path, hints, disabled, onPatch, inputType } = params;
+  const { schema, value, rootValue, path, hints, disabled, onPatch, inputType } = params;
   const showLabel = params.showLabel ?? true;
   const hint = hintForPath(path, hints);
   const label = hint?.label ?? schema.title ?? humanize(String(path.at(-1)));
   const help = hint?.help ?? schema.description;
+  const assist = renderFieldAssist({ path, hints, help, rootValue, disabled, onPatch });
   const isSensitive = hint?.sensitive ?? isSensitivePath(path);
   const placeholder =
     hint?.placeholder ??
@@ -321,7 +560,7 @@ function renderTextInput(params: {
   return html`
     <div class="cfg-field">
       ${showLabel ? html`<label class="cfg-field__label">${label}</label>` : nothing}
-      ${help ? html`<div class="cfg-field__help">${help}</div>` : nothing}
+      ${assist}
       <div class="cfg-input-wrap">
         <input
           type=${isSensitive ? "password" : inputType}
@@ -371,24 +610,26 @@ function renderTextInput(params: {
 function renderNumberInput(params: {
   schema: JsonSchema;
   value: unknown;
+  rootValue: unknown;
   path: Array<string | number>;
   hints: ConfigUiHints;
   disabled: boolean;
   showLabel?: boolean;
   onPatch: (path: Array<string | number>, value: unknown) => void;
 }): TemplateResult {
-  const { schema, value, path, hints, disabled, onPatch } = params;
+  const { schema, value, rootValue, path, hints, disabled, onPatch } = params;
   const showLabel = params.showLabel ?? true;
   const hint = hintForPath(path, hints);
   const label = hint?.label ?? schema.title ?? humanize(String(path.at(-1)));
   const help = hint?.help ?? schema.description;
+  const assist = renderFieldAssist({ path, hints, help, rootValue, disabled, onPatch });
   const displayValue = value ?? schema.default ?? "";
   const numValue = typeof displayValue === "number" ? displayValue : 0;
 
   return html`
     <div class="cfg-field">
       ${showLabel ? html`<label class="cfg-field__label">${label}</label>` : nothing}
-      ${help ? html`<div class="cfg-field__help">${help}</div>` : nothing}
+      ${assist}
       <div class="cfg-number">
         <button
           type="button"
@@ -421,6 +662,7 @@ function renderNumberInput(params: {
 function renderSelect(params: {
   schema: JsonSchema;
   value: unknown;
+  rootValue: unknown;
   path: Array<string | number>;
   hints: ConfigUiHints;
   disabled: boolean;
@@ -428,11 +670,12 @@ function renderSelect(params: {
   options: unknown[];
   onPatch: (path: Array<string | number>, value: unknown) => void;
 }): TemplateResult {
-  const { schema, value, path, hints, disabled, options, onPatch } = params;
+  const { schema, value, rootValue, path, hints, disabled, options, onPatch } = params;
   const showLabel = params.showLabel ?? true;
   const hint = hintForPath(path, hints);
   const label = hint?.label ?? schema.title ?? humanize(String(path.at(-1)));
   const help = hint?.help ?? schema.description;
+  const assist = renderFieldAssist({ path, hints, help, rootValue, disabled, onPatch });
   const resolvedValue = value ?? schema.default;
   const currentIndex = options.findIndex(
     (opt) => opt === resolvedValue || String(opt) === String(resolvedValue),
@@ -442,7 +685,7 @@ function renderSelect(params: {
   return html`
     <div class="cfg-field">
       ${showLabel ? html`<label class="cfg-field__label">${label}</label>` : nothing}
-      ${help ? html`<div class="cfg-field__help">${help}</div>` : nothing}
+      ${assist}
       <select
         class="cfg-select"
         ?disabled=${disabled}
@@ -463,9 +706,104 @@ function renderSelect(params: {
   `;
 }
 
+type ObjectEntry = [string, JsonSchema];
+
+function renderObjectFields(params: {
+  entries: ObjectEntry[];
+  obj: Record<string, unknown>;
+  rootValue: unknown;
+  path: Array<string | number>;
+  hints: ConfigUiHints;
+  unsupported: Set<string>;
+  disabled: boolean;
+  onPatch: (path: Array<string | number>, value: unknown) => void;
+}): TemplateResult {
+  const { entries, obj, rootValue, path, hints, unsupported, disabled, onPatch } = params;
+  const groups: Array<{ label: string; advanced: boolean; entries: ObjectEntry[] }> = [];
+  const indexByKey = new Map<string, number>();
+
+  for (const entry of entries) {
+    const [propKey] = entry;
+    const propHint = hintForPath([...path, propKey], hints);
+    const rawGroup = propHint?.group?.trim();
+    const groupLabel =
+      rawGroup && rawGroup.length > 0 ? rawGroup : propHint?.advanced ? "Advanced" : "General";
+    const advanced = propHint?.advanced === true || groupLabel.toLowerCase() === "advanced";
+    const groupKey = `${advanced ? "1" : "0"}:${groupLabel.toLowerCase()}`;
+    const existingIndex = indexByKey.get(groupKey);
+    if (existingIndex != null) {
+      groups[existingIndex]?.entries.push(entry);
+      continue;
+    }
+    indexByKey.set(groupKey, groups.length);
+    groups.push({
+      label: groupLabel,
+      advanced,
+      entries: [entry],
+    });
+  }
+
+  const useGroupedPresentation =
+    groups.length > 1 || groups.some((group) => group.advanced || group.label !== "General");
+
+  if (!useGroupedPresentation) {
+    const fallbackEntries = groups[0]?.entries ?? entries;
+    return html`${fallbackEntries.map(([propKey, node]) =>
+      renderNode({
+        schema: node,
+        value: obj[propKey],
+        rootValue,
+        path: [...path, propKey],
+        hints,
+        unsupported,
+        disabled,
+        onPatch,
+      }),
+    )}`;
+  }
+
+  return html`
+    ${groups.map((group) => {
+      const body = html`
+        <div class="cfg-group__body">
+          ${group.entries.map(([propKey, node]) =>
+            renderNode({
+              schema: node,
+              value: obj[propKey],
+              rootValue,
+              path: [...path, propKey],
+              hints,
+              unsupported,
+              disabled,
+              onPatch,
+            }),
+          )}
+        </div>
+      `;
+
+      if (group.advanced) {
+        return html`
+          <details class="cfg-group cfg-group--advanced">
+            <summary>${group.label}</summary>
+            ${body}
+          </details>
+        `;
+      }
+
+      return html`
+        <section class="cfg-group">
+          ${group.label !== "General" ? html`<h4 class="cfg-group__title">${group.label}</h4>` : nothing}
+          ${body}
+        </section>
+      `;
+    })}
+  `;
+}
+
 function renderObject(params: {
   schema: JsonSchema;
   value: unknown;
+  rootValue: unknown;
   path: Array<string | number>;
   hints: ConfigUiHints;
   unsupported: Set<string>;
@@ -473,7 +811,7 @@ function renderObject(params: {
   showLabel?: boolean;
   onPatch: (path: Array<string | number>, value: unknown) => void;
 }): TemplateResult {
-  const { schema, value, path, hints, unsupported, disabled, onPatch } = params;
+  const { schema, value, rootValue, path, hints, unsupported, disabled, onPatch } = params;
   const hint = hintForPath(path, hints);
   const label = hint?.label ?? schema.title ?? humanize(String(path.at(-1)));
   const help = hint?.help ?? schema.description;
@@ -504,22 +842,22 @@ function renderObject(params: {
   if (path.length === 1) {
     return html`
       <div class="cfg-fields">
-        ${sorted.map(([propKey, node]) =>
-          renderNode({
-            schema: node,
-            value: obj[propKey],
-            path: [...path, propKey],
-            hints,
-            unsupported,
-            disabled,
-            onPatch,
-          }),
-        )}
+        ${renderObjectFields({
+          entries: sorted,
+          obj,
+          rootValue,
+          path,
+          hints,
+          unsupported,
+          disabled,
+          onPatch,
+        })}
         ${
           allowExtra
             ? renderMapField({
                 schema: additional,
                 value: obj,
+                rootValue,
                 path,
                 hints,
                 unsupported,
@@ -534,30 +872,31 @@ function renderObject(params: {
   }
 
   // Nested objects get collapsible treatment
+  const defaultOpen = path.length <= 2 && hint?.advanced !== true;
   return html`
-    <details class="cfg-object" open>
+    <details class="cfg-object" ?open=${defaultOpen}>
       <summary class="cfg-object__header">
         <span class="cfg-object__title">${label}</span>
         <span class="cfg-object__chevron">${icons.chevronDown}</span>
       </summary>
       ${help ? html`<div class="cfg-object__help">${help}</div>` : nothing}
       <div class="cfg-object__content">
-        ${sorted.map(([propKey, node]) =>
-          renderNode({
-            schema: node,
-            value: obj[propKey],
-            path: [...path, propKey],
-            hints,
-            unsupported,
-            disabled,
-            onPatch,
-          }),
-        )}
+        ${renderObjectFields({
+          entries: sorted,
+          obj,
+          rootValue,
+          path,
+          hints,
+          unsupported,
+          disabled,
+          onPatch,
+        })}
         ${
           allowExtra
             ? renderMapField({
                 schema: additional,
                 value: obj,
+                rootValue,
                 path,
                 hints,
                 unsupported,
@@ -575,6 +914,7 @@ function renderObject(params: {
 function renderArray(params: {
   schema: JsonSchema;
   value: unknown;
+  rootValue: unknown;
   path: Array<string | number>;
   hints: ConfigUiHints;
   unsupported: Set<string>;
@@ -582,11 +922,12 @@ function renderArray(params: {
   showLabel?: boolean;
   onPatch: (path: Array<string | number>, value: unknown) => void;
 }): TemplateResult {
-  const { schema, value, path, hints, unsupported, disabled, onPatch } = params;
+  const { schema, value, rootValue, path, hints, unsupported, disabled, onPatch } = params;
   const showLabel = params.showLabel ?? true;
   const hint = hintForPath(path, hints);
   const label = hint?.label ?? schema.title ?? humanize(String(path.at(-1)));
   const help = hint?.help ?? schema.description;
+  const assist = renderFieldAssist({ path, hints, help, rootValue, disabled, onPatch });
 
   const itemsSchema = Array.isArray(schema.items) ? schema.items[0] : schema.items;
   if (!itemsSchema) {
@@ -599,6 +940,9 @@ function renderArray(params: {
   }
 
   const arr = Array.isArray(value) ? value : Array.isArray(schema.default) ? schema.default : [];
+  const singularLabel = singularizeLabel(label);
+  const addLabel = `Add ${humanize(singularLabel)}`;
+  const itemTypeLabel = inferArrayItemTypeLabel(itemsSchema);
 
   return html`
     <div class="cfg-array">
@@ -615,15 +959,16 @@ function renderArray(params: {
           }}
         >
           <span class="cfg-array__add-icon">${icons.plus}</span>
-          Add
+          ${addLabel}
         </button>
       </div>
-      ${help ? html`<div class="cfg-array__help">${help}</div>` : nothing}
+      ${assist}
+      <div class="cfg-array__meta">Each ${singularLabel.toLowerCase()} expects ${itemTypeLabel}.</div>
 
       ${
         arr.length === 0
           ? html`
-              <div class="cfg-array__empty">No items yet. Click "Add" to create one.</div>
+              <div class="cfg-array__empty">No ${label.toLowerCase()} configured yet.</div>
             `
           : html`
         <div class="cfg-array__items">
@@ -631,7 +976,7 @@ function renderArray(params: {
             (item, idx) => html`
             <div class="cfg-array__item">
               <div class="cfg-array__item-header">
-                <span class="cfg-array__item-index">#${idx + 1}</span>
+                <span class="cfg-array__item-index">#${idx + 1} ${singularLabel.toLowerCase()}</span>
                 <button
                   type="button"
                   class="cfg-array__item-remove"
@@ -650,6 +995,7 @@ function renderArray(params: {
                 ${renderNode({
                   schema: itemsSchema,
                   value: item,
+                  rootValue,
                   path: [...path, idx],
                   hints,
                   unsupported,
@@ -671,6 +1017,7 @@ function renderArray(params: {
 function renderMapField(params: {
   schema: JsonSchema;
   value: Record<string, unknown>;
+  rootValue: unknown;
   path: Array<string | number>;
   hints: ConfigUiHints;
   unsupported: Set<string>;
@@ -678,14 +1025,21 @@ function renderMapField(params: {
   reservedKeys: Set<string>;
   onPatch: (path: Array<string | number>, value: unknown) => void;
 }): TemplateResult {
-  const { schema, value, path, hints, unsupported, disabled, reservedKeys, onPatch } = params;
+  const { schema, value, rootValue, path, hints, unsupported, disabled, reservedKeys, onPatch } =
+    params;
+  const hint = hintForPath(path, hints);
+  const label = hint?.label ?? "Custom entries";
+  const help = hint?.help;
+  const assist = renderFieldAssist({ path, hints, help, rootValue, disabled, onPatch });
   const anySchema = isAnySchema(schema);
   const entries = Object.entries(value ?? {}).filter(([key]) => !reservedKeys.has(key));
+  const guidance = inferMapFieldGuidance(path, label);
+  const mapValueType = inferArrayItemTypeLabel(schema);
 
   return html`
     <div class="cfg-map">
       <div class="cfg-map__header">
-        <span class="cfg-map__label">Custom entries</span>
+        <span class="cfg-map__label">${label}</span>
         <button
           type="button"
           class="cfg-map__add"
@@ -703,14 +1057,20 @@ function renderMapField(params: {
           }}
         >
           <span class="cfg-map__add-icon">${icons.plus}</span>
-          Add Entry
+          ${guidance.addLabel}
         </button>
       </div>
+      ${assist}
+      ${
+        guidance.keyHelp
+          ? html`<div class="cfg-map__meta">${guidance.keyHelp}</div>`
+          : html`<div class="cfg-map__meta">Value type: ${mapValueType}.</div>`
+      }
 
       ${
         entries.length === 0
           ? html`
-              <div class="cfg-map__empty">No custom entries.</div>
+              <div class="cfg-map__empty">No ${label.toLowerCase()} configured yet.</div>
             `
           : html`
         <div class="cfg-map__items">
@@ -723,7 +1083,7 @@ function renderMapField(params: {
                   <input
                     type="text"
                     class="cfg-input cfg-input--sm"
-                    placeholder="Key"
+                    placeholder=${guidance.keyPlaceholder}
                     .value=${key}
                     ?disabled=${disabled}
                     @change=${(e: Event) => {
@@ -769,6 +1129,7 @@ function renderMapField(params: {
                       : renderNode({
                           schema,
                           value: entryValue,
+                          rootValue,
                           path: valuePath,
                           hints,
                           unsupported,
diff --git a/ui/src/ui/views/config-form.render.ts b/ui/src/ui/views/config-form.render.ts
index 7c541d97f075..f530668bb06a 100644
--- a/ui/src/ui/views/config-form.render.ts
+++ b/ui/src/ui/views/config-form.render.ts
@@ -451,6 +451,7 @@ export function renderConfigForm(props: ConfigFormProps) {
                   ${renderNode({
                     schema: node,
                     value: scopedValue,
+                    rootValue: value,
                     path: [sectionKey, subsectionKey],
                     hints: props.uiHints,
                     unsupported,
@@ -485,6 +486,7 @@ export function renderConfigForm(props: ConfigFormProps) {
                   ${renderNode({
                     schema: node,
                     value: value[key],
+                    rootValue: value,
                     path: [key],
                     hints: props.uiHints,
                     unsupported,
diff --git a/ui/src/ui/views/config-form.shared.ts b/ui/src/ui/views/config-form.shared.ts
index 9a7f9fce50d4..9771e0428afc 100644
--- a/ui/src/ui/views/config-form.shared.ts
+++ b/ui/src/ui/views/config-form.shared.ts
@@ -1,4 +1,4 @@
-import type { ConfigUiHints } from "../types.ts";
+import type { ConfigUiHint, ConfigUiHintImpact, ConfigUiHints } from "../types.ts";
 
 export type JsonSchema = {
   type?: string | string[];
@@ -56,7 +56,122 @@ export function pathKey(path: Array<string | number>): string {
   return path.filter((segment) => typeof segment === "string").join(".");
 }
 
-export function hintForPath(path: Array<string | number>, hints: ConfigUiHints) {
+const FALLBACK_UI_HINTS: ConfigUiHints = {
+  "channels.*.allowBots": {
+    help: "Allow replies to bot-authored messages (default: off). Keep mention/allowlist guardrails to avoid bot loops.",
+    docsPath: "/gateway/configuration",
+    impacts: [
+      {
+        relation: "risk",
+        when: "truthy",
+        message:
+          "Allowing bot-authored messages can create bot-to-bot reply loops. Keep mention/allowlist guardrails in place.",
+        docsPath: "/gateway/security",
+      },
+    ],
+  },
+  "channels.*.accounts.*.allowBots": {
+    help: "Allow replies to bot-authored messages for this account (default: off).",
+    docsPath: "/gateway/configuration",
+    impacts: [
+      {
+        relation: "risk",
+        when: "truthy",
+        message:
+          "Allowing bot-authored messages can create bot-to-bot reply loops. Keep mention/allowlist guardrails in place.",
+        docsPath: "/gateway/security",
+      },
+    ],
+  },
+  "channels.*.blockStreaming": {
+    help: "Emit completed reply chunks while generating, instead of waiting for one final message.",
+    docsPath: "/concepts/streaming",
+  },
+  "channels.*.accounts.*.blockStreaming": {
+    help: "Emit completed reply chunks while generating for this account.",
+    docsPath: "/concepts/streaming",
+  },
+  "channels.*.capabilities": {
+    help: "Optional runtime capability tags. Leave empty unless channel docs explicitly require a tag.",
+    docsPath: "/gateway/configuration",
+  },
+  "channels.*.accounts.*.capabilities": {
+    help: "Optional runtime capability tags for this account. Leave empty unless docs require one.",
+    docsPath: "/gateway/configuration",
+  },
+  "channels.*.dm.policy": {
+    help: 'DM access policy. If set to "open", allowFrom should include "*".',
+    docsPath: "/gateway/security",
+    impacts: [
+      {
+        relation: "requires",
+        when: "equals",
+        whenValue: "open",
+        targetPath: "channels.*.dm.allowFrom",
+        targetWhen: "includes",
+        targetValue: "*",
+        message: 'Open DM policy requires allowFrom to include "*".',
+        fixValue: ["*"],
+        fixLabel: 'Allow all ("*")',
+      },
+    ],
+  },
+  "channels.*.accounts.*.dm.policy": {
+    help: 'DM access policy for this account. If set to "open", allowFrom should include "*".',
+    docsPath: "/gateway/security",
+    impacts: [
+      {
+        relation: "requires",
+        when: "equals",
+        whenValue: "open",
+        targetPath: "channels.*.accounts.*.dm.allowFrom",
+        targetWhen: "includes",
+        targetValue: "*",
+        message: 'Open DM policy requires allowFrom to include "*".',
+        fixValue: ["*"],
+        fixLabel: 'Allow all ("*")',
+      },
+    ],
+  },
+  "channels.*.dmPolicy": {
+    help: 'DM access policy. If set to "open", allowFrom should include "*".',
+    docsPath: "/gateway/security",
+  },
+  "channels.*.accounts.*.dmPolicy": {
+    help: 'DM access policy for this account. If set to "open", allowFrom should include "*".',
+    docsPath: "/gateway/security",
+  },
+  "channels.telegram.streamMode": {
+    docsPath: "/concepts/streaming",
+    impacts: [
+      {
+        relation: "conflicts",
+        when: "notEquals",
+        whenValue: "off",
+        targetPath: "channels.telegram.blockStreaming",
+        targetWhen: "truthy",
+        message:
+          "Telegram draft streaming can suppress block streaming for a reply. Use streamMode=off for block-only behavior.",
+      },
+    ],
+  },
+  "channels.telegram.accounts.*.streamMode": {
+    docsPath: "/concepts/streaming",
+    impacts: [
+      {
+        relation: "conflicts",
+        when: "notEquals",
+        whenValue: "off",
+        targetPath: "channels.telegram.accounts.*.blockStreaming",
+        targetWhen: "truthy",
+        message:
+          "Telegram draft streaming can suppress block streaming for a reply. Use streamMode=off for block-only behavior.",
+      },
+    ],
+  },
+};
+
+function resolveHint(path: Array<string | number>, hints: ConfigUiHints): ConfigUiHint | undefined {
   const key = pathKey(path);
   const direct = hints[key];
   if (direct) {
@@ -85,6 +200,22 @@ export function hintForPath(path: Array<string | number>, hints: ConfigUiHints)
   return undefined;
 }
 
+export function hintForPath(path: Array<string | number>, hints: ConfigUiHints) {
+  const fallback = resolveHint(path, FALLBACK_UI_HINTS);
+  const resolved = resolveHint(path, hints);
+  if (!fallback) {
+    return resolved;
+  }
+  if (!resolved) {
+    return fallback;
+  }
+  return {
+    ...fallback,
+    ...resolved,
+    impacts: [...(fallback.impacts ?? []), ...(resolved.impacts ?? [])],
+  };
+}
+
 export function humanize(raw: string) {
   return raw
     .replace(/_/g, " ")
@@ -103,3 +234,194 @@ export function isSensitivePath(path: Array<string | number>): boolean {
     key.endsWith("key")
   );
 }
+
+type ImpactCheck = NonNullable<ConfigUiHintImpact["when"]>;
+
+export type ResolvedConfigImpact = {
+  relation: NonNullable<ConfigUiHintImpact["relation"]>;
+  message: string;
+  docsPath?: string;
+  targetPath?: string;
+  fixValue?: unknown;
+  fixLabel?: string;
+};
+
+function splitPath(path: string): string[] {
+  return path
+    .split(".")
+    .map((segment) => segment.trim())
+    .filter(Boolean);
+}
+
+function getValueAtPath(value: unknown, path: string[]): unknown {
+  let cursor = value;
+  for (const segment of path) {
+    if (!cursor || typeof cursor !== "object" || Array.isArray(cursor)) {
+      return undefined;
+    }
+    cursor = (cursor as Record<string, unknown>)[segment];
+  }
+  return cursor;
+}
+
+function resolveWildcardPath(path: string, sourcePath: Array<string | number>): string[] {
+  const sourceSegments = sourcePath.filter(
+    (segment): segment is string => typeof segment === "string",
+  );
+  return splitPath(path).map((segment, index) => {
+    if (segment !== "*") {
+      return segment;
+    }
+    return sourceSegments[index] ?? segment;
+  });
+}
+
+function isEqual(lhs: unknown, rhs: unknown): boolean {
+  if (Object.is(lhs, rhs)) {
+    return true;
+  }
+  if (
+    lhs == null ||
+    rhs == null ||
+    typeof lhs === "function" ||
+    typeof rhs === "function" ||
+    typeof lhs === "symbol" ||
+    typeof rhs === "symbol"
+  ) {
+    return false;
+  }
+  try {
+    return JSON.stringify(lhs) === JSON.stringify(rhs);
+  } catch {
+    return false;
+  }
+}
+
+function evaluateCheck(value: unknown, check: ImpactCheck, expected?: unknown): boolean {
+  switch (check) {
+    case "truthy":
+      return Boolean(value);
+    case "falsy":
+      return !value;
+    case "defined":
+      return value !== undefined && value !== null && value !== "";
+    case "notDefined":
+      return value === undefined || value === null || value === "";
+    case "equals":
+      return isEqual(value, expected);
+    case "notEquals":
+      return !isEqual(value, expected);
+    case "includes":
+      if (typeof value === "string") {
+        return typeof expected === "string" && value.includes(expected);
+      }
+      if (Array.isArray(value)) {
+        return value.some((entry) => isEqual(entry, expected));
+      }
+      return false;
+    default:
+      return false;
+  }
+}
+
+function relationForImpact(
+  impact: ConfigUiHintImpact,
+): NonNullable<ConfigUiHintImpact["relation"]> {
+  return impact.relation ?? "requires";
+}
+
+function sourceCheckForImpact(impact: ConfigUiHintImpact): ImpactCheck {
+  if (impact.when) {
+    return impact.when;
+  }
+  if (impact.whenValue !== undefined) {
+    return "equals";
+  }
+  return "truthy";
+}
+
+function targetCheckForImpact(impact: ConfigUiHintImpact): ImpactCheck {
+  if (impact.targetWhen) {
+    return impact.targetWhen;
+  }
+  if (impact.targetValue !== undefined) {
+    return "equals";
+  }
+  return "truthy";
+}
+
+export function resolveConfigImpacts(params: {
+  path: Array<string | number>;
+  hints: ConfigUiHints;
+  rootValue: unknown;
+}): ResolvedConfigImpact[] {
+  const { path, hints, rootValue } = params;
+  const hint = hintForPath(path, hints);
+  const impacts = hint?.impacts ?? [];
+  if (impacts.length === 0) {
+    return [];
+  }
+  const sourceValue = getValueAtPath(
+    rootValue,
+    path.filter((segment): segment is string => typeof segment === "string"),
+  );
+  const resolved: ResolvedConfigImpact[] = [];
+
+  for (const impact of impacts) {
+    const relation = relationForImpact(impact);
+    const sourceCheck = sourceCheckForImpact(impact);
+    if (!evaluateCheck(sourceValue, sourceCheck, impact.whenValue)) {
+      continue;
+    }
+
+    const targetPathSegments = impact.targetPath
+      ? resolveWildcardPath(impact.targetPath, path)
+      : null;
+    if (targetPathSegments?.includes("*")) {
+      continue;
+    }
+    const targetValue = targetPathSegments
+      ? getValueAtPath(rootValue, targetPathSegments)
+      : undefined;
+    const targetCheck = targetCheckForImpact(impact);
+    const targetMatches = targetPathSegments
+      ? evaluateCheck(targetValue, targetCheck, impact.targetValue)
+      : false;
+
+    const active =
+      relation === "risk"
+        ? true
+        : relation === "conflicts"
+          ? Boolean(targetPathSegments) && targetMatches
+          : !targetPathSegments || !targetMatches;
+
+    if (!active) {
+      continue;
+    }
+
+    resolved.push({
+      relation,
+      message: impact.message,
+      ...(impact.docsPath ? { docsPath: impact.docsPath } : {}),
+      ...(targetPathSegments ? { targetPath: targetPathSegments.join(".") } : {}),
+      ...(impact.fixValue !== undefined ? { fixValue: impact.fixValue } : {}),
+      ...(impact.fixLabel ? { fixLabel: impact.fixLabel } : {}),
+    });
+  }
+
+  return resolved;
+}
+
+export function toDocsUrl(path?: string): string | null {
+  const raw = path?.trim();
+  if (!raw) {
+    return null;
+  }
+  if (raw.startsWith("http://") || raw.startsWith("https://")) {
+    return raw;
+  }
+  if (!raw.startsWith("/")) {
+    return `https://docs.openclaw.ai/${raw}`;
+  }
+  return `https://docs.openclaw.ai${raw}`;
+}
diff --git a/ui/src/ui/views/config.ts b/ui/src/ui/views/config.ts
index 221f31e00505..77430bf15bd1 100644
--- a/ui/src/ui/views/config.ts
+++ b/ui/src/ui/views/config.ts
@@ -558,7 +558,7 @@ export function renderConfig(props: ConfigProps) {
           </div>
           <div class="config-actions__right">
             <button
-              class="btn btn--sm"
+              class="btn btn--sm quiet"
               ?disabled=${props.loading}
               @click=${props.onReload}
             >
@@ -572,14 +572,14 @@ export function renderConfig(props: ConfigProps) {
               ${props.saving ? "Saving…" : "Save"}
             </button>
             <button
-              class="btn btn--sm"
+              class="btn btn--sm quiet"
               ?disabled=${!canApply}
               @click=${props.onApply}
             >
               ${props.applying ? "Applying…" : "Apply"}
             </button>
             <button
-              class="btn btn--sm"
+              class="btn btn--sm quiet"
               ?disabled=${!canUpdate}
               @click=${props.onUpdate}
             >
diff --git a/ui/src/ui/views/cron.ts b/ui/src/ui/views/cron.ts
index 7b87826eaadd..9a195afc1822 100644
--- a/ui/src/ui/views/cron.ts
+++ b/ui/src/ui/views/cron.ts
@@ -145,47 +145,62 @@ export function renderCron(props: CronProps) {
         </div>
         ${renderScheduleFields(props)}
         <div class="form-grid" style="margin-top: 12px;">
-          <label class="field">
-            <span>Session</span>
-            <select
-              .value=${props.form.sessionTarget}
-              @change=${(e: Event) =>
-                props.onFormChange({
-                  sessionTarget: (e.target as HTMLSelectElement)
-                    .value as CronFormState["sessionTarget"],
-                })}
-            >
-              <option value="main">Main</option>
-              <option value="isolated">Isolated</option>
-            </select>
-          </label>
-          <label class="field">
-            <span>Wake mode</span>
-            <select
-              .value=${props.form.wakeMode}
-              @change=${(e: Event) =>
-                props.onFormChange({
-                  wakeMode: (e.target as HTMLSelectElement).value as CronFormState["wakeMode"],
-                })}
-            >
-              <option value="now">Now</option>
-              <option value="next-heartbeat">Next heartbeat</option>
-            </select>
-          </label>
-          <label class="field">
-            <span>Payload</span>
-            <select
-              .value=${props.form.payloadKind}
-              @change=${(e: Event) =>
-                props.onFormChange({
-                  payloadKind: (e.target as HTMLSelectElement)
-                    .value as CronFormState["payloadKind"],
-                })}
-            >
-              <option value="systemEvent">System event</option>
-              <option value="agentTurn">Agent turn</option>
-            </select>
-          </label>
+          <div class="field">
+            <label class="field">
+              <span>Session</span>
+              <select
+                .value=${props.form.sessionTarget}
+                @change=${(e: Event) =>
+                  props.onFormChange({
+                    sessionTarget: (e.target as HTMLSelectElement)
+                      .value as CronFormState["sessionTarget"],
+                  })}
+              >
+                <option value="main">Main</option>
+                <option value="isolated">Isolated</option>
+              </select>
+            </label>
+            <div class="muted" style="font-size: 11px; margin-top: 2px;">
+              ${props.form.sessionTarget === "isolated" ? "Each run starts a fresh session — no shared context." : "Runs continue in the agent's main session with full context."}
+            </div>
+          </div>
+          <div class="field">
+            <label class="field">
+              <span>Wake mode</span>
+              <select
+                .value=${props.form.wakeMode}
+                @change=${(e: Event) =>
+                  props.onFormChange({
+                    wakeMode: (e.target as HTMLSelectElement).value as CronFormState["wakeMode"],
+                  })}
+              >
+                <option value="next-heartbeat">Next heartbeat</option>
+                <option value="now">Now</option>
+              </select>
+            </label>
+            <div class="muted" style="font-size: 11px; margin-top: 2px;">
+              ${props.form.wakeMode === "next-heartbeat" ? "Queued until the next heartbeat cycle." : "Runs immediately when the schedule fires."}
+            </div>
+          </div>
+          <div class="field">
+            <label class="field">
+              <span>Payload</span>
+              <select
+                .value=${props.form.payloadKind}
+                @change=${(e: Event) =>
+                  props.onFormChange({
+                    payloadKind: (e.target as HTMLSelectElement)
+                      .value as CronFormState["payloadKind"],
+                  })}
+              >
+                <option value="systemEvent">System event</option>
+                <option value="agentTurn">Agent turn</option>
+              </select>
+            </label>
+            <div class="muted" style="font-size: 11px; margin-top: 2px;">
+              ${props.form.payloadKind === "agentTurn" ? "Sends a message to the agent and waits for a reply." : "Fires a system event the agent can react to via hooks."}
+            </div>
+          </div>
         </div>
         <label class="field" style="margin-top: 12px;">
           <span>${props.form.payloadKind === "systemEvent" ? "System text" : "Agent message"}</span>
@@ -202,20 +217,25 @@ export function renderCron(props: CronProps) {
           props.form.payloadKind === "agentTurn"
             ? html`
                 <div class="form-grid" style="margin-top: 12px;">
-                  <label class="field">
-                    <span>Delivery</span>
-                    <select
-                      .value=${props.form.deliveryMode}
-                      @change=${(e: Event) =>
-                        props.onFormChange({
-                          deliveryMode: (e.target as HTMLSelectElement)
-                            .value as CronFormState["deliveryMode"],
-                        })}
-                    >
-                      <option value="announce">Announce summary (default)</option>
-                      <option value="none">None (internal)</option>
-                    </select>
-                  </label>
+                  <div class="field">
+                    <label class="field">
+                      <span>Delivery</span>
+                      <select
+                        .value=${props.form.deliveryMode}
+                        @change=${(e: Event) =>
+                          props.onFormChange({
+                            deliveryMode: (e.target as HTMLSelectElement)
+                              .value as CronFormState["deliveryMode"],
+                          })}
+                      >
+                        <option value="announce">Announce summary (default)</option>
+                        <option value="none">None (internal)</option>
+                      </select>
+                    </label>
+                    <div class="muted" style="font-size: 11px; margin-top: 2px;">
+                      ${props.form.deliveryMode === "announce" ? "Posts a summary of the run to a channel." : "Run completes silently with no output."}
+                    </div>
+                  </div>
                   <label class="field">
                     <span>Timeout (seconds)</span>
                     <input
@@ -437,7 +457,9 @@ function renderJob(job: CronJob, props: CronProps) {
             ?disabled=${props.busy}
             @click=${(event: Event) => {
               event.stopPropagation();
-              props.onRemove(job);
+              if (window.confirm("Are you sure you want to remove this cron job?")) {
+                props.onRemove(job);
+              }
             }}
           >
             Remove
diff --git a/ui/src/ui/views/debug.ts b/ui/src/ui/views/debug.ts
index 22ee3bce20f5..af576fa82c0a 100644
--- a/ui/src/ui/views/debug.ts
+++ b/ui/src/ui/views/debug.ts
@@ -35,18 +35,19 @@ export function renderDebug(props: DebugProps) {
   return html`
     <section class="grid grid-cols-2">
       <div class="card">
-        <div class="row" style="justify-content: space-between;">
-          <div>
+        <div class="section-header">
+          <div class="section-header__meta">
             <div class="card-title">Snapshots</div>
             <div class="card-sub">Status, health, and heartbeat data.</div>
           </div>
-          <button class="btn" ?disabled=${props.loading} @click=${props.onRefresh}>
+          <button class="btn quiet" ?disabled=${props.loading} @click=${props.onRefresh}>
             ${props.loading ? "Refreshing…" : "Refresh"}
           </button>
         </div>
         <div class="stack" style="margin-top: 12px;">
-          <div>
-            <div class="muted">Status</div>
+          <details class="cfg-group cfg-group--advanced" open>
+            <summary>Status</summary>
+            <div class="cfg-group__body">
             ${
               securitySummary
                 ? html`<div class="callout ${securityTone}" style="margin-top: 8px;">
@@ -56,15 +57,20 @@ export function renderDebug(props: DebugProps) {
                 : nothing
             }
             <pre class="code-block">${JSON.stringify(props.status ?? {}, null, 2)}</pre>
-          </div>
-          <div>
-            <div class="muted">Health</div>
-            <pre class="code-block">${JSON.stringify(props.health ?? {}, null, 2)}</pre>
-          </div>
-          <div>
-            <div class="muted">Last heartbeat</div>
-            <pre class="code-block">${JSON.stringify(props.heartbeat ?? {}, null, 2)}</pre>
-          </div>
+            </div>
+          </details>
+          <details class="cfg-group cfg-group--advanced">
+            <summary>Health</summary>
+            <div class="cfg-group__body">
+              <pre class="code-block">${JSON.stringify(props.health ?? {}, null, 2)}</pre>
+            </div>
+          </details>
+          <details class="cfg-group cfg-group--advanced">
+            <summary>Last heartbeat</summary>
+            <div class="cfg-group__body">
+              <pre class="code-block">${JSON.stringify(props.heartbeat ?? {}, null, 2)}</pre>
+            </div>
+          </details>
         </div>
       </div>
 
@@ -109,41 +115,45 @@ export function renderDebug(props: DebugProps) {
     </section>
 
     <section class="card" style="margin-top: 18px;">
-      <div class="card-title">Models</div>
-      <div class="card-sub">Catalog from models.list.</div>
-      <pre class="code-block" style="margin-top: 12px;">${JSON.stringify(
-        props.models ?? [],
-        null,
-        2,
-      )}</pre>
+      <details class="cfg-group cfg-group--advanced">
+        <summary>Models catalog</summary>
+        <div class="cfg-group__body">
+          <div class="card-sub">Catalog from models.list.</div>
+          <pre class="code-block">${JSON.stringify(props.models ?? [], null, 2)}</pre>
+        </div>
+      </details>
     </section>
 
     <section class="card" style="margin-top: 18px;">
-      <div class="card-title">Event Log</div>
-      <div class="card-sub">Latest gateway events.</div>
-      ${
-        props.eventLog.length === 0
-          ? html`
-              <div class="muted" style="margin-top: 12px">No events yet.</div>
-            `
-          : html`
-            <div class="list" style="margin-top: 12px;">
-              ${props.eventLog.map(
-                (evt) => html`
-                  <div class="list-item">
-                    <div class="list-main">
-                      <div class="list-title">${evt.event}</div>
-                      <div class="list-sub">${new Date(evt.ts).toLocaleTimeString()}</div>
-                    </div>
-                    <div class="list-meta">
-                      <pre class="code-block">${formatEventPayload(evt.payload)}</pre>
-                    </div>
-                  </div>
-                `,
-              )}
-            </div>
-          `
-      }
+      <details class="cfg-group cfg-group--advanced">
+        <summary>Event log</summary>
+        <div class="cfg-group__body">
+          <div class="card-sub">Latest gateway events.</div>
+          ${
+            props.eventLog.length === 0
+              ? html`
+                  <div class="muted">No events yet.</div>
+                `
+              : html`
+                <div class="list">
+                  ${props.eventLog.map(
+                    (evt) => html`
+                      <div class="list-item">
+                        <div class="list-main">
+                          <div class="list-title">${evt.event}</div>
+                          <div class="list-sub">${new Date(evt.ts).toLocaleTimeString()}</div>
+                        </div>
+                        <div class="list-meta">
+                          <pre class="code-block">${formatEventPayload(evt.payload)}</pre>
+                        </div>
+                      </div>
+                    `,
+                  )}
+                </div>
+              `
+          }
+        </div>
+      </details>
     </section>
   `;
 }
diff --git a/ui/src/ui/views/logs.ts b/ui/src/ui/views/logs.ts
index c119c413c785..69c9134dfabe 100644
--- a/ui/src/ui/views/logs.ts
+++ b/ui/src/ui/views/logs.ts
@@ -55,13 +55,13 @@ export function renderLogs(props: LogsProps) {
 
   return html`
     <section class="card">
-      <div class="row" style="justify-content: space-between;">
-        <div>
+      <div class="section-header">
+        <div class="section-header__meta">
           <div class="card-title">Logs</div>
           <div class="card-sub">Gateway file logs (JSONL).</div>
         </div>
-        <div class="row" style="gap: 8px;">
-          <button class="btn" ?disabled=${props.loading} @click=${props.onRefresh}>
+        <div class="section-header__actions">
+          <button class="btn quiet" ?disabled=${props.loading} @click=${props.onRefresh}>
             ${props.loading ? "Loading…" : "Refresh"}
           </button>
           <button
@@ -78,41 +78,46 @@ export function renderLogs(props: LogsProps) {
         </div>
       </div>
 
-      <div class="filters" style="margin-top: 14px;">
-        <label class="field" style="min-width: 220px;">
-          <span>Filter</span>
-          <input
-            .value=${props.filterText}
-            @input=${(e: Event) => props.onFilterTextChange((e.target as HTMLInputElement).value)}
-            placeholder="Search logs"
-          />
-        </label>
-        <label class="field checkbox">
-          <span>Auto-follow</span>
-          <input
-            type="checkbox"
-            .checked=${props.autoFollow}
-            @change=${(e: Event) =>
-              props.onToggleAutoFollow((e.target as HTMLInputElement).checked)}
-          />
-        </label>
-      </div>
-
-      <div class="chip-row" style="margin-top: 12px;">
-        ${LEVELS.map(
-          (level) => html`
-            <label class="chip log-chip ${level}">
+      <details class="cfg-group cfg-group--advanced" style="margin-top: 12px;" ?open=${Boolean(props.filterText.trim())}>
+        <summary>Filters</summary>
+        <div class="cfg-group__body">
+          <div class="filters">
+            <label class="field" style="min-width: 220px;">
+              <span>Filter</span>
+              <input
+                .value=${props.filterText}
+                @input=${(e: Event) => props.onFilterTextChange((e.target as HTMLInputElement).value)}
+                placeholder="Search logs"
+              />
+            </label>
+            <label class="field checkbox">
+              <span>Auto-follow</span>
               <input
                 type="checkbox"
-                .checked=${props.levelFilters[level]}
+                .checked=${props.autoFollow}
                 @change=${(e: Event) =>
-                  props.onLevelToggle(level, (e.target as HTMLInputElement).checked)}
+                  props.onToggleAutoFollow((e.target as HTMLInputElement).checked)}
               />
-              <span>${level}</span>
             </label>
-          `,
-        )}
-      </div>
+          </div>
+
+          <div class="chip-row">
+            ${LEVELS.map(
+              (level) => html`
+                <label class="chip log-chip ${level}">
+                  <input
+                    type="checkbox"
+                    .checked=${props.levelFilters[level]}
+                    @change=${(e: Event) =>
+                      props.onLevelToggle(level, (e.target as HTMLInputElement).checked)}
+                  />
+                  <span>${level}</span>
+                </label>
+              `,
+            )}
+          </div>
+        </div>
+      </details>
 
       ${
         props.file
@@ -140,7 +145,7 @@ export function renderLogs(props: LogsProps) {
               `
             : filtered.map(
                 (entry) => html`
-                <div class="log-row">
+                <div class="log-row ${entry.level === "warn" ? "log-row--warn" : entry.level === "error" || entry.level === "fatal" ? "log-row--error" : ""}">
                   <div class="log-time mono">${formatTime(entry.time)}</div>
                   <div class="log-level ${entry.level ?? ""}">${entry.level ?? ""}</div>
                   <div class="log-subsystem mono">${entry.subsystem ?? ""}</div>
diff --git a/ui/src/ui/views/nodes.ts b/ui/src/ui/views/nodes.ts
index f48c925c9979..06ab57598f1b 100644
--- a/ui/src/ui/views/nodes.ts
+++ b/ui/src/ui/views/nodes.ts
@@ -292,16 +292,16 @@ type ExecApprovalsState = {
 
 const EXEC_APPROVALS_DEFAULT_SCOPE = "__defaults__";
 
-const SECURITY_OPTIONS: Array<{ value: ExecSecurity; label: string }> = [
-  { value: "deny", label: "Deny" },
-  { value: "allowlist", label: "Allowlist" },
-  { value: "full", label: "Full" },
+const SECURITY_OPTIONS: Array<{ value: ExecSecurity; label: string; desc: string }> = [
+  { value: "deny", label: "Deny", desc: "Block all exec commands (safest)" },
+  { value: "allowlist", label: "Allowlist", desc: "Only run commands matching allowlist patterns" },
+  { value: "full", label: "Full", desc: "Allow all exec commands (use with caution)" },
 ];
 
-const ASK_OPTIONS: Array<{ value: ExecAsk; label: string }> = [
-  { value: "off", label: "Off" },
-  { value: "on-miss", label: "On miss" },
-  { value: "always", label: "Always" },
+const ASK_OPTIONS: Array<{ value: ExecAsk; label: string; desc: string }> = [
+  { value: "off", label: "Off", desc: "Never prompt — use security mode directly" },
+  { value: "on-miss", label: "On miss", desc: "Prompt when command is not in allowlist" },
+  { value: "always", label: "Always", desc: "Always prompt before running any command" },
 ];
 
 function resolveBindingsState(props: NodesProps): BindingState {
@@ -674,10 +674,41 @@ function renderExecApprovalsTarget(state: ExecApprovalsState) {
 }
 
 function renderExecApprovalsTabs(state: ExecApprovalsState) {
+  const showSearch = state.agents.length > 10;
   return html`
-    <div class="row" style="margin-top: 12px; gap: 8px; flex-wrap: wrap;">
-      <span class="label">Scope</span>
-      <div class="row" style="gap: 8px; flex-wrap: wrap;">
+    <div style="margin-top: 12px;">
+      <div class="row" style="gap: 8px; align-items: center; margin-bottom: 8px;">
+        <span class="label">Scope</span>
+        ${
+          showSearch
+            ? html`
+          <input
+            type="text"
+            placeholder="Filter agents…"
+            style="padding: 4px 8px; font-size: 12px; border: 1px solid var(--border); border-radius: var(--radius-sm); background: var(--bg-elevated); color: var(--text); max-width: 180px;"
+            @input=${(event: Event) => {
+              const input = event.target as HTMLInputElement;
+              const filter = input.value.toLowerCase().trim();
+              const container = input.closest("div")?.parentElement?.querySelector(".scope-pills");
+              if (!container) {
+                return;
+              }
+              for (const btn of container.querySelectorAll("[data-agent-id]")) {
+                const id = (btn as HTMLElement).dataset.agentId ?? "";
+                const name = (btn as HTMLElement).dataset.agentName ?? "";
+                const visible =
+                  !filter ||
+                  id.toLowerCase().includes(filter) ||
+                  name.toLowerCase().includes(filter);
+                (btn as HTMLElement).style.display = visible ? "" : "none";
+              }
+            }}
+          />
+        `
+            : nothing
+        }
+      </div>
+      <div class="row scope-pills" style="gap: 8px; flex-wrap: wrap;">
         <button
           class="btn btn--sm ${state.selectedScope === EXEC_APPROVALS_DEFAULT_SCOPE ? "active" : ""}"
           @click=${() => state.onSelectScope(EXEC_APPROVALS_DEFAULT_SCOPE)}
@@ -689,6 +720,8 @@ function renderExecApprovalsTabs(state: ExecApprovalsState) {
           return html`
             <button
               class="btn btn--sm ${state.selectedScope === agent.id ? "active" : ""}"
+              data-agent-id=${agent.id}
+              data-agent-name=${agent.name ?? ""}
               @click=${() => state.onSelectScope(agent.id)}
             >
               ${label}
@@ -722,7 +755,10 @@ function renderExecApprovalsPolicy(state: ExecApprovalsState) {
         <div class="list-main">
           <div class="list-title">Security</div>
           <div class="list-sub">
-            ${isDefaults ? "Default security mode." : `Default: ${defaults.security}.`}
+            ${isDefaults ? "Controls which shell commands the agent can execute." : `Default: ${defaults.security}.`}
+          </div>
+          <div class="muted" style="margin-top: 4px; font-size: 11px;">
+            ${SECURITY_OPTIONS.find((o) => o.value === (securityValue === "__default__" ? defaults.security : securityValue))?.desc ?? ""}
           </div>
         </div>
         <div class="list-meta">
@@ -765,7 +801,10 @@ function renderExecApprovalsPolicy(state: ExecApprovalsState) {
         <div class="list-main">
           <div class="list-title">Ask</div>
           <div class="list-sub">
-            ${isDefaults ? "Default prompt policy." : `Default: ${defaults.ask}.`}
+            ${isDefaults ? "Whether to prompt for approval before executing commands." : `Default: ${defaults.ask}.`}
+          </div>
+          <div class="muted" style="margin-top: 4px; font-size: 11px;">
+            ${ASK_OPTIONS.find((o) => o.value === (askValue === "__default__" ? defaults.ask : askValue))?.desc ?? ""}
           </div>
         </div>
         <div class="list-meta">
@@ -810,7 +849,7 @@ function renderExecApprovalsPolicy(state: ExecApprovalsState) {
           <div class="list-sub">
             ${
               isDefaults
-                ? "Applied when the UI prompt is unavailable."
+                ? "Security mode used when no UI is available to prompt (e.g. cron jobs, headless runs)."
                 : `Default: ${defaults.askFallback}.`
             }
           </div>
@@ -857,7 +896,7 @@ function renderExecApprovalsPolicy(state: ExecApprovalsState) {
           <div class="list-sub">
             ${
               isDefaults
-                ? "Allow skill executables listed by the Gateway."
+                ? "Automatically allow CLI tools declared by installed skills (e.g. gh, kubectl, docker)."
                 : autoIsDefault
                   ? `Using default (${defaults.autoAllowSkills ? "on" : "off"}).`
                   : `Override (${autoEffective ? "on" : "off"}).`
@@ -901,7 +940,7 @@ function renderExecApprovalsAllowlist(state: ExecApprovalsState) {
     <div class="row" style="margin-top: 18px; justify-content: space-between;">
       <div>
         <div class="card-title">Allowlist</div>
-        <div class="card-sub">Case-insensitive glob patterns.</div>
+        <div class="card-sub">Case-insensitive glob patterns (e.g. <span class="mono">git*</span>, <span class="mono">/usr/bin/ls</span>, <span class="mono">npm*</span>).</div>
       </div>
       <button
         class="btn btn--sm"
diff --git a/ui/src/ui/views/overview.ts b/ui/src/ui/views/overview.ts
index fbc417d41ef4..0292cd1827cb 100644
--- a/ui/src/ui/views/overview.ts
+++ b/ui/src/ui/views/overview.ts
@@ -1,5 +1,6 @@
 import { html } from "lit";
 import type { GatewayHelloOk } from "../gateway.ts";
+import type { Tab } from "../navigation.ts";
 import type { UiSettings } from "../storage.ts";
 import { formatAgo, formatDurationMs } from "../format.ts";
 import { formatNextRun } from "../presenter.ts";
@@ -20,6 +21,7 @@ export type OverviewProps = {
   onSessionKeyChange: (next: string) => void;
   onConnect: () => void;
   onRefresh: () => void;
+  onNavigate: (tab: Tab) => void;
 };
 
 export function renderOverview(props: OverviewProps) {
@@ -191,10 +193,16 @@ export function renderOverview(props: OverviewProps) {
             <div class="stat-label">Uptime</div>
             <div class="stat-value">${uptime}</div>
           </div>
-          <div class="stat">
-            <div class="stat-label">Tick Interval</div>
-            <div class="stat-value">${tick}</div>
-          </div>
+          ${
+            tick !== "n/a"
+              ? html`
+                  <div class="stat">
+                    <div class="stat-label">Poll Interval</div>
+                    <div class="stat-value">${tick}</div>
+                  </div>
+                `
+              : html``
+          }
           <div class="stat">
             <div class="stat-label">Last Channels Refresh</div>
             <div class="stat-value">
@@ -219,17 +227,32 @@ export function renderOverview(props: OverviewProps) {
     </section>
 
     <section class="grid grid-cols-3" style="margin-top: 18px;">
-      <div class="card stat-card">
+      <div
+        class="card stat-card stat-card-clickable"
+        style="cursor: pointer;"
+        @click=${() => props.onNavigate("instances")}
+        title="Go to Instances"
+      >
         <div class="stat-label">Instances</div>
         <div class="stat-value">${props.presenceCount}</div>
         <div class="muted">Presence beacons in the last 5 minutes.</div>
       </div>
-      <div class="card stat-card">
+      <div
+        class="card stat-card stat-card-clickable"
+        style="cursor: pointer;"
+        @click=${() => props.onNavigate("sessions")}
+        title="Go to Sessions"
+      >
         <div class="stat-label">Sessions</div>
         <div class="stat-value">${props.sessionsCount ?? "n/a"}</div>
         <div class="muted">Recent session keys tracked by the gateway.</div>
       </div>
-      <div class="card stat-card">
+      <div
+        class="card stat-card stat-card-clickable"
+        style="cursor: pointer;"
+        @click=${() => props.onNavigate("cron")}
+        title="Go to Cron"
+      >
         <div class="stat-label">Cron</div>
         <div class="stat-value">
           ${props.cronEnabled == null ? "n/a" : props.cronEnabled ? "Enabled" : "Disabled"}
@@ -250,7 +273,7 @@ export function renderOverview(props: OverviewProps) {
         </div>
         <div>
           <div class="note-title">Session hygiene</div>
-          <div class="muted">Use /new or sessions.patch to reset context.</div>
+          <div class="muted">Use <span class="mono">/new</span> in chat or the Sessions tab to reset context.</div>
         </div>
         <div>
           <div class="note-title">Cron reminders</div>
diff --git a/ui/src/ui/views/sessions.ts b/ui/src/ui/views/sessions.ts
index d17a843e64a7..dc7652801eb7 100644
--- a/ui/src/ui/views/sessions.ts
+++ b/ui/src/ui/views/sessions.ts
@@ -36,7 +36,7 @@ const THINK_LEVELS = ["", "off", "minimal", "low", "medium", "high", "xhigh"] as
 const BINARY_THINK_LEVELS = ["", "off", "on"] as const;
 const VERBOSE_LEVELS = [
   { value: "", label: "inherit" },
-  { value: "off", label: "off (explicit)" },
+  { value: "off", label: "off" },
   { value: "on", label: "on" },
   { value: "full", label: "full" },
 ] as const;
@@ -109,74 +109,81 @@ function resolveThinkLevelPatchValue(value: string, isBinary: boolean): string |
 
 export function renderSessions(props: SessionsProps) {
   const rows = props.result?.sessions ?? [];
+  const showFiltersByDefault =
+    props.includeUnknown || !props.includeGlobal || Boolean(props.activeMinutes.trim());
   return html`
     <section class="card">
-      <div class="row" style="justify-content: space-between;">
-        <div>
+      <div class="section-header">
+        <div class="section-header__meta">
           <div class="card-title">Sessions</div>
           <div class="card-sub">Active session keys and per-session overrides.</div>
         </div>
-        <button class="btn" ?disabled=${props.loading} @click=${props.onRefresh}>
+        <button class="btn quiet" ?disabled=${props.loading} @click=${props.onRefresh}>
           ${props.loading ? "Loading…" : "Refresh"}
         </button>
       </div>
 
-      <div class="filters" style="margin-top: 14px;">
-        <label class="field">
-          <span>Active within (minutes)</span>
-          <input
-            .value=${props.activeMinutes}
-            @input=${(e: Event) =>
-              props.onFiltersChange({
-                activeMinutes: (e.target as HTMLInputElement).value,
-                limit: props.limit,
-                includeGlobal: props.includeGlobal,
-                includeUnknown: props.includeUnknown,
-              })}
-          />
-        </label>
-        <label class="field">
-          <span>Limit</span>
-          <input
-            .value=${props.limit}
-            @input=${(e: Event) =>
-              props.onFiltersChange({
-                activeMinutes: props.activeMinutes,
-                limit: (e.target as HTMLInputElement).value,
-                includeGlobal: props.includeGlobal,
-                includeUnknown: props.includeUnknown,
-              })}
-          />
-        </label>
-        <label class="field checkbox">
-          <span>Include global</span>
-          <input
-            type="checkbox"
-            .checked=${props.includeGlobal}
-            @change=${(e: Event) =>
-              props.onFiltersChange({
-                activeMinutes: props.activeMinutes,
-                limit: props.limit,
-                includeGlobal: (e.target as HTMLInputElement).checked,
-                includeUnknown: props.includeUnknown,
-              })}
-          />
-        </label>
-        <label class="field checkbox">
-          <span>Include unknown</span>
-          <input
-            type="checkbox"
-            .checked=${props.includeUnknown}
-            @change=${(e: Event) =>
-              props.onFiltersChange({
-                activeMinutes: props.activeMinutes,
-                limit: props.limit,
-                includeGlobal: props.includeGlobal,
-                includeUnknown: (e.target as HTMLInputElement).checked,
-              })}
-          />
-        </label>
-      </div>
+      <details class="cfg-group cfg-group--advanced" style="margin-top: 12px;" ?open=${showFiltersByDefault}>
+        <summary>Filters</summary>
+        <div class="cfg-group__body">
+          <div class="filters">
+            <label class="field">
+              <span>Active within (minutes)</span>
+              <input
+                .value=${props.activeMinutes}
+                @input=${(e: Event) =>
+                  props.onFiltersChange({
+                    activeMinutes: (e.target as HTMLInputElement).value,
+                    limit: props.limit,
+                    includeGlobal: props.includeGlobal,
+                    includeUnknown: props.includeUnknown,
+                  })}
+              />
+            </label>
+            <label class="field">
+              <span>Limit</span>
+              <input
+                .value=${props.limit}
+                @input=${(e: Event) =>
+                  props.onFiltersChange({
+                    activeMinutes: props.activeMinutes,
+                    limit: (e.target as HTMLInputElement).value,
+                    includeGlobal: props.includeGlobal,
+                    includeUnknown: props.includeUnknown,
+                  })}
+              />
+            </label>
+            <label class="field checkbox">
+              <span>Include global</span>
+              <input
+                type="checkbox"
+                .checked=${props.includeGlobal}
+                @change=${(e: Event) =>
+                  props.onFiltersChange({
+                    activeMinutes: props.activeMinutes,
+                    limit: props.limit,
+                    includeGlobal: (e.target as HTMLInputElement).checked,
+                    includeUnknown: props.includeUnknown,
+                  })}
+              />
+            </label>
+            <label class="field checkbox">
+              <span>Include unknown</span>
+              <input
+                type="checkbox"
+                .checked=${props.includeUnknown}
+                @change=${(e: Event) =>
+                  props.onFiltersChange({
+                    activeMinutes: props.activeMinutes,
+                    limit: props.limit,
+                    includeGlobal: props.includeGlobal,
+                    includeUnknown: (e.target as HTMLInputElement).checked,
+                  })}
+              />
+            </label>
+          </div>
+        </div>
+      </details>
 
       ${
         props.error
@@ -192,12 +199,12 @@ export function renderSessions(props: SessionsProps) {
         <div class="table-head">
           <div>Key</div>
           <div>Label</div>
-          <div>Kind</div>
+          <div title="Session type: direct (1:1), group (multi-user), global (shared state)">Kind</div>
           <div>Updated</div>
-          <div>Tokens</div>
-          <div>Thinking</div>
-          <div>Verbose</div>
-          <div>Reasoning</div>
+          <div title="Tokens used / context window limit">Tokens</div>
+          <div title="Extended thinking budget — controls how much reasoning the model does">Thinking</div>
+          <div title="Include detailed tool execution output in responses">Verbose</div>
+          <div title="Chain-of-thought reasoning: stream (real-time), on (in output), off (hidden)">Reasoning</div>
           <div>Actions</div>
         </div>
         ${
@@ -264,6 +271,7 @@ function renderRow(
       <div>
         <select
           ?disabled=${disabled}
+          title="Thinking level for this session. 'inherit' uses the agent or global default."
           @change=${(e: Event) => {
             const value = (e.target as HTMLSelectElement).value;
             onPatch(row.key, {
@@ -282,6 +290,7 @@ function renderRow(
       <div>
         <select
           ?disabled=${disabled}
+          title="Verbose output for this session. 'inherit' uses the agent or global default."
           @change=${(e: Event) => {
             const value = (e.target as HTMLSelectElement).value;
             onPatch(row.key, { verboseLevel: value || null });
@@ -298,6 +307,7 @@ function renderRow(
       <div>
         <select
           ?disabled=${disabled}
+          title="Reasoning output for this session. 'stream' shows chain-of-thought in real time; 'on' includes it in final output. 'inherit' uses the agent or global default."
           @change=${(e: Event) => {
             const value = (e.target as HTMLSelectElement).value;
             onPatch(row.key, { reasoningLevel: value || null });