From a172ff9ed27a7549e57df551080b86462e58835c Mon Sep 17 00:00:00 2001
From: quotentiroler <max.nussbaumer@maxhealth.tech>
Date: Mon, 9 Feb 2026 14:20:56 -0800
Subject: [PATCH] docs: SEO and AI discoverability improvements

- Add description to docs.json for llms.txt blockquote summary
- Add title frontmatter to 10 docs files for llms.txt link text
- ci(docker): skip builds for docs-only changes
---
 .github/workflows/docker-release.yml  | 3 +++
 docs/concepts/memory.md               | 1 +
 docs/concepts/session-pruning.md      | 1 +
 docs/docs.json                        | 1 +
 docs/reference/AGENTS.default.md      | 1 +
 docs/reference/RELEASING.md           | 1 +
 docs/reference/templates/AGENTS.md    | 1 +
 docs/reference/templates/BOOT.md      | 1 +
 docs/reference/templates/BOOTSTRAP.md | 1 +
 docs/reference/templates/HEARTBEAT.md | 1 +
 docs/reference/templates/SOUL.md      | 1 +
 docs/reference/templates/TOOLS.md     | 1 +
 12 files changed, 14 insertions(+)

diff --git a/.github/workflows/docker-release.yml b/.github/workflows/docker-release.yml
index aa175961d..924a7ca1a 100644
--- a/.github/workflows/docker-release.yml
+++ b/.github/workflows/docker-release.yml
@@ -6,6 +6,9 @@ on:
       - main
     tags:
       - "v*"
+    paths-ignore:
+      - "docs/**"
+      - "*.md"
 
 env:
   REGISTRY: ghcr.io
diff --git a/docs/concepts/memory.md b/docs/concepts/memory.md
index f9b3dc9b8..039f51c61 100644
--- a/docs/concepts/memory.md
+++ b/docs/concepts/memory.md
@@ -1,4 +1,5 @@
 ---
+title: "Memory"
 summary: "How OpenClaw memory works (workspace files + automatic memory flush)"
 read_when:
   - You want the memory file layout and workflow
diff --git a/docs/concepts/session-pruning.md b/docs/concepts/session-pruning.md
index e9e55b388..0fcb2b78d 100644
--- a/docs/concepts/session-pruning.md
+++ b/docs/concepts/session-pruning.md
@@ -1,4 +1,5 @@
 ---
+title: "Session Pruning"
 summary: "Session pruning: tool-result trimming to reduce context bloat"
 read_when:
   - You want to reduce LLM context growth from tool outputs
diff --git a/docs/docs.json b/docs/docs.json
index 4a50c5d74..ecd16552c 100644
--- a/docs/docs.json
+++ b/docs/docs.json
@@ -1,6 +1,7 @@
 {
   "$schema": "https://mintlify.com/docs.json",
   "name": "OpenClaw",
+  "description": "Self-hosted gateway that connects WhatsApp, Telegram, Discord, iMessage, and more to AI coding agents. Run a single Gateway process on your own machine and message your AI assistant from anywhere.",
   "theme": "mint",
   "icons": {
     "library": "lucide"
diff --git a/docs/reference/AGENTS.default.md b/docs/reference/AGENTS.default.md
index 404a0506a..6e2869403 100644
--- a/docs/reference/AGENTS.default.md
+++ b/docs/reference/AGENTS.default.md
@@ -1,4 +1,5 @@
 ---
+title: "Default AGENTS.md"
 summary: "Default OpenClaw agent instructions and skills roster for the personal assistant setup"
 read_when:
   - Starting a new OpenClaw agent session
diff --git a/docs/reference/RELEASING.md b/docs/reference/RELEASING.md
index 23670a133..0f9f37acb 100644
--- a/docs/reference/RELEASING.md
+++ b/docs/reference/RELEASING.md
@@ -1,4 +1,5 @@
 ---
+title: "Release Checklist"
 summary: "Step-by-step release checklist for npm + macOS app"
 read_when:
   - Cutting a new npm release
diff --git a/docs/reference/templates/AGENTS.md b/docs/reference/templates/AGENTS.md
index 956b1195a..619ce4c56 100644
--- a/docs/reference/templates/AGENTS.md
+++ b/docs/reference/templates/AGENTS.md
@@ -1,4 +1,5 @@
 ---
+title: "AGENTS.md Template"
 summary: "Workspace template for AGENTS.md"
 read_when:
   - Bootstrapping a workspace manually
diff --git a/docs/reference/templates/BOOT.md b/docs/reference/templates/BOOT.md
index a60500484..a5edf43ef 100644
--- a/docs/reference/templates/BOOT.md
+++ b/docs/reference/templates/BOOT.md
@@ -1,4 +1,5 @@
 ---
+title: "BOOT.md Template"
 summary: "Workspace template for BOOT.md"
 read_when:
   - Adding a BOOT.md checklist
diff --git a/docs/reference/templates/BOOTSTRAP.md b/docs/reference/templates/BOOTSTRAP.md
index 210dc9455..de92e9a9e 100644
--- a/docs/reference/templates/BOOTSTRAP.md
+++ b/docs/reference/templates/BOOTSTRAP.md
@@ -1,4 +1,5 @@
 ---
+title: "BOOTSTRAP.md Template"
 summary: "First-run ritual for new agents"
 read_when:
   - Bootstrapping a workspace manually
diff --git a/docs/reference/templates/HEARTBEAT.md b/docs/reference/templates/HEARTBEAT.md
index 5ee0d711f..58b844f91 100644
--- a/docs/reference/templates/HEARTBEAT.md
+++ b/docs/reference/templates/HEARTBEAT.md
@@ -1,4 +1,5 @@
 ---
+title: "HEARTBEAT.md Template"
 summary: "Workspace template for HEARTBEAT.md"
 read_when:
   - Bootstrapping a workspace manually
diff --git a/docs/reference/templates/SOUL.md b/docs/reference/templates/SOUL.md
index d444ec234..a9d8edfd2 100644
--- a/docs/reference/templates/SOUL.md
+++ b/docs/reference/templates/SOUL.md
@@ -1,4 +1,5 @@
 ---
+title: "SOUL.md Template"
 summary: "Workspace template for SOUL.md"
 read_when:
   - Bootstrapping a workspace manually
diff --git a/docs/reference/templates/TOOLS.md b/docs/reference/templates/TOOLS.md
index 60511ffb6..326b69728 100644
--- a/docs/reference/templates/TOOLS.md
+++ b/docs/reference/templates/TOOLS.md
@@ -1,4 +1,5 @@
 ---
+title: "TOOLS.md Template"
 summary: "Workspace template for TOOLS.md"
 read_when:
   - Bootstrapping a workspace manually