diff --git a/scripts/docs-site/assets.mjs b/scripts/docs-site/assets.mjs
index 9fff5ad41..6de0c7b83 100644
--- a/scripts/docs-site/assets.mjs
+++ b/scripts/docs-site/assets.mjs
@@ -48,7 +48,9 @@ async function initMermaid(force=false){const blocks=[...document.querySelectorA
 function showCopyFeedback(control,ok){if(!control)return;if(control.matches("[data-code-copy]")||control.matches("[data-chat-copy]")||control.matches("[data-heading-anchor]")){control.dataset.copyState=ok?"copied":"failed";const label=control.dataset.copyLabel||control.getAttribute("aria-label")||"Copy";control.dataset.copyLabel=label;control.setAttribute("aria-label",ok?"Copied":"Copy failed");clearTimeout(control._copyStateTimer);control._copyStateTimer=setTimeout(()=>{delete control.dataset.copyState;control.setAttribute("aria-label",label)},1300);return}const old=control.textContent;control.textContent=ok?"Copied":"Copy failed";setTimeout(()=>control.textContent=old||"Copy",1300)}
 async function copyText(text,control){try{if(!String(text||"").trim())throw new Error("Nothing to copy");if(navigator.clipboard?.writeText)await navigator.clipboard.writeText(text);else{const area=document.createElement("textarea");area.value=text;area.setAttribute("readonly","");area.style.position="fixed";area.style.opacity="0";document.body.appendChild(area);area.select();document.execCommand("copy");area.remove()}showCopyFeedback(control,true);return true}catch{showCopyFeedback(control,false);return false}}
 function codeTextForCopy(block){const lines=[...block?.querySelectorAll(".code-line")||[]];if(lines.length)return lines.map(line=>line.textContent).join("\\n");return block?.querySelector("code")?.textContent||""}
-function handleDocsControlClick(e){const copyCode=e.target.closest("[data-code-copy]");if(copyCode){copyText(codeTextForCopy(copyCode.closest(".oc-code")),copyCode);return true}const copyPrompt=e.target.closest("[data-prompt-copy]");if(copyPrompt){const prompt=copyPrompt.closest(".oc-prompt")?.textContent?.replace(/Copy\\s*$/,"").trim()||"";copyText(prompt,copyPrompt);return true}const copyPage=e.target.closest("[data-copy-page]");if(copyPage){const url=copyPage.closest("[data-page-tools]")?.dataset.pageUrl||location.href;copyText(url,copyPage);return true}const headingAnchor=e.target.closest("[data-heading-anchor]");if(headingAnchor){const url=new URL(location.href);url.hash=headingAnchor.dataset.headingAnchor||"";copyText(url.href,headingAnchor);return true}const feedback=e.target.closest("[data-feedback-value]");if(feedback){const result=feedback.closest(".page-feedback")?.querySelector("[data-feedback-result]");if(result)result.value=feedback.dataset.feedbackValue==="yes"?"Thanks.":"Noted.";return true}return false}
+function pageMarkdownForCopy(control){const source=control.closest(".article")?.querySelector("[data-page-markdown]");if(!source)return"";try{return JSON.parse(source.textContent||"\"\"")}catch{return source.textContent||""}}
+function copyPageMarkdown(control){return copyText(pageMarkdownForCopy(control),control)}
+function handleDocsControlClick(e){const copyCode=e.target.closest("[data-code-copy]");if(copyCode){copyText(codeTextForCopy(copyCode.closest(".oc-code")),copyCode);return true}const copyPrompt=e.target.closest("[data-prompt-copy]");if(copyPrompt){const prompt=copyPrompt.closest(".oc-prompt")?.textContent?.replace(/Copy\\s*$/,"").trim()||"";copyText(prompt,copyPrompt);return true}const copyPage=e.target.closest("[data-copy-page]");if(copyPage){copyPageMarkdown(copyPage);return true}const headingAnchor=e.target.closest("[data-heading-anchor]");if(headingAnchor){const url=new URL(location.href);url.hash=headingAnchor.dataset.headingAnchor||"";copyText(url.href,headingAnchor);return true}const feedback=e.target.closest("[data-feedback-value]");if(feedback){const result=feedback.closest(".page-feedback")?.querySelector("[data-feedback-result]");if(result)result.value=feedback.dataset.feedbackValue==="yes"?"Thanks.":"Noted.";return true}return false}
 function scrollTarget(hash){if(hash){document.getElementById(decodeURIComponent(hash.slice(1)))?.scrollIntoView()}else{scrollTo(0,0)}}
 async function navigateTo(url,replace=false){if(navigating)return false;navigating=true;closeLanguage();try{const res=await fetch(url.href,{credentials:"same-origin"});if(!res.ok||!res.headers.get("content-type")?.includes("text/html"))return false;const nextDoc=new DOMParser().parseFromString(await res.text(),"text/html");if(!nextDoc.querySelector(".main"))return false;syncSidebar(nextDoc);swap(".header-left",nextDoc);swapTabs(nextDoc);swap(".main",nextDoc);initCodeGroups();initMermaid();document.title=nextDoc.title;history[replace?"replaceState":"pushState"]({docs:true},"",url.href);setNavOpen(false);scrollTarget(url.hash);return true}catch{return false}finally{navigating=false}}
 function openSearch(){modal?.classList.add("open");setTimeout(()=>input?.focus(),0);pagefindReady ||= import(withBase("/pagefind/pagefind.js")).then(m=>m.init?.().then?.(()=>m)??m)}
diff --git a/scripts/docs-site/build.mjs b/scripts/docs-site/build.mjs
index 077eff1e5..f5d989861 100644
--- a/scripts/docs-site/build.mjs
+++ b/scripts/docs-site/build.mjs
@@ -323,7 +323,7 @@ ${breadcrumbs(page, nav)}
 <p class="article-kicker">${escapeHtml(groupForPage(nav, page.slug) ?? activeTab)}</p>
 <h1>${escapeHtml(page.title)}</h1>
 ${pageStatus(page)}
-${page.hidden ? "" : pageTools(page)}
+${page.hidden ? "" : `${pageTools(page)}${pageMarkdownScript(page)}`}
 </header>
 <div class="doc"${page.hidden ? ' data-pagefind-ignore' : ' data-pagefind-body'}>${html}</div>
 ${page.hidden ? "" : pageFeedback()}
@@ -419,9 +419,21 @@ function breadcrumbs(page, nav) {
 
 function pageTools(page) {
   const canonicalUrl = `${docsOrigin()}${pageRoute(page)}`;
+  const markdownUrl = publicPath(pageMarkdownRoute(page));
   const editUrl = editSourceUrlForPage(page, sourceMetadata);
   const editLink = editUrl ? `<a href="${escapeAttr(editUrl)}">Edit source</a>` : "";
-  return `<div class="page-tools" data-page-tools data-page-url="${escapeAttr(canonicalUrl)}"><button type="button" data-copy-page>Copy page</button>${editLink}</div>`;
+  return `<div class="page-tools" data-page-tools data-page-url="${escapeAttr(canonicalUrl)}" data-page-markdown-url="${escapeAttr(markdownUrl)}"><button type="button" data-copy-page>Copy page</button>${editLink}</div>`;
+}
+
+function pageMarkdownScript(page) {
+  return `<script type="application/json" data-page-markdown>${jsonScript(markdownBodyForCopy(page.raw))}</script>`;
+}
+
+function markdownBodyForCopy(markdown) {
+  const text = String(markdown || "");
+  const frontmatter = /^\uFEFF?---\r?\n([\s\S]*?)\r?\n---\r?\n?/.exec(text);
+  if (!frontmatter || !/(^|\n)[A-Za-z0-9_-]+:\s*/.test(frontmatter[1])) return text;
+  return text.slice(frontmatter[0].length).replace(/^\s*\n/, "");
 }
 
 function pageStatus(page) {
@@ -597,12 +609,23 @@ function docsOrigin() {
   return (canonicalOrigin || "https://docs.openclaw.ai").replace(/\/$/, "");
 }
 
+function chatAvatarAssets() {
+  const staticPath = fs.existsSync(path.join(docsDir, "assets", "molty-avatar.png"))
+    ? "/assets/molty-avatar.png"
+    : "/assets/pixel-lobster.svg";
+  const hoverPath = fs.existsSync(path.join(docsDir, "assets", "molty-avatar-hover.gif"))
+    ? "/assets/molty-avatar-hover.gif"
+    : staticPath;
+  return { staticPath: publicPath(staticPath), hoverPath: publicPath(hoverPath) };
+}
+
 function chatWidget() {
   if (!chatApiUrl) return "";
+  const avatar = chatAvatarAssets();
   return `<section class="docs-chat" data-docs-chat aria-label="OpenClaw docs assistant">
-<button class="docs-chat-launcher" type="button" data-chat-toggle aria-expanded="false" aria-controls="docs-chat-panel"><img class="docs-chat-avatar" src="${publicPath("/assets/molty-avatar.png")}" data-static-src="${publicPath("/assets/molty-avatar.png")}" data-hover-src="${publicPath("/assets/molty-avatar-hover.gif")}" alt=""><span>Ask Molty</span></button>
+<button class="docs-chat-launcher" type="button" data-chat-toggle aria-expanded="false" aria-controls="docs-chat-panel"><img class="docs-chat-avatar" src="${avatar.staticPath}" data-static-src="${avatar.staticPath}" data-hover-src="${avatar.hoverPath}" alt=""><span>Ask Molty</span></button>
 <div class="docs-chat-panel" id="docs-chat-panel" data-chat-panel role="dialog" aria-modal="false" aria-labelledby="docs-chat-title" aria-hidden="true" inert>
-<header class="docs-chat-head"><div class="docs-chat-title"><img class="docs-chat-avatar" src="${publicPath("/assets/molty-avatar.png")}" data-static-src="${publicPath("/assets/molty-avatar.png")}" data-hover-src="${publicPath("/assets/molty-avatar-hover.gif")}" alt=""><h2 id="docs-chat-title">Molty</h2></div><div class="docs-chat-actions"><button class="docs-chat-icon docs-chat-maximize" type="button" data-chat-maximize aria-label="Maximize docs assistant" aria-pressed="false">${icon("maximize-2")}</button><button class="docs-chat-icon docs-chat-copy" type="button" data-chat-copy aria-label="Copy conversation" hidden>${icon("copy")}</button><button class="docs-chat-icon docs-chat-retry" type="button" data-chat-retry aria-label="Reload last answer" hidden disabled>${icon("refresh-cw")}</button><button class="docs-chat-icon docs-chat-clear" type="button" data-chat-clear aria-label="Clear conversation" hidden>${icon("trash")}</button><button class="docs-chat-icon docs-chat-minimize" type="button" data-chat-minimize aria-label="Minimize docs assistant">${icon("minus")}</button></div></header>
+<header class="docs-chat-head"><div class="docs-chat-title"><img class="docs-chat-avatar" src="${avatar.staticPath}" data-static-src="${avatar.staticPath}" data-hover-src="${avatar.hoverPath}" alt=""><h2 id="docs-chat-title">Molty</h2></div><div class="docs-chat-actions"><button class="docs-chat-icon docs-chat-maximize" type="button" data-chat-maximize aria-label="Maximize docs assistant" aria-pressed="false">${icon("maximize-2")}</button><button class="docs-chat-icon docs-chat-copy" type="button" data-chat-copy aria-label="Copy conversation" hidden>${icon("copy")}</button><button class="docs-chat-icon docs-chat-retry" type="button" data-chat-retry aria-label="Reload last answer" hidden disabled>${icon("refresh-cw")}</button><button class="docs-chat-icon docs-chat-clear" type="button" data-chat-clear aria-label="Clear conversation" hidden>${icon("trash")}</button><button class="docs-chat-icon docs-chat-minimize" type="button" data-chat-minimize aria-label="Minimize docs assistant">${icon("minus")}</button></div></header>
 <div class="docs-chat-auth" data-chat-auth hidden></div>
 <div class="docs-chat-log" data-chat-log aria-live="polite">
 <div class="docs-chat-empty">Responses are generated using AI and may contain mistakes.</div>
@@ -935,3 +958,10 @@ function escapeAttr(value) {
 function escapeXml(value) {
   return String(value).replaceAll("&", "&amp;").replaceAll("<", "&lt;").replaceAll(">", "&gt;").replaceAll('"', "&quot;").replaceAll("'", "&apos;");
 }
+
+function jsonScript(value) {
+  return JSON.stringify(value)
+    .replaceAll("<", "\\u003c")
+    .replaceAll(">", "\\u003e")
+    .replaceAll("&", "\\u0026");
+}
diff --git a/scripts/docs-site/smoke.mjs b/scripts/docs-site/smoke.mjs
index c90d0423c..10895a1ce 100644
--- a/scripts/docs-site/smoke.mjs
+++ b/scripts/docs-site/smoke.mjs
@@ -30,8 +30,7 @@ const required = [
   "de/gateway/heartbeat/index.html",
   "assets/docs-site.css",
   "assets/docs-site.js",
-  "assets/molty-avatar.png",
-  "assets/molty-avatar-hover.gif"
+  "assets/pixel-lobster.svg"
 ];
 if (!shellOnly) {
   required.push(
@@ -161,8 +160,8 @@ if (!/Português \(BR\)/.test(index)) {
 if (
   !/data-docs-chat/.test(index) ||
   !/OPENCLAW_DOCS_CHAT_API/.test(index) ||
-  !/molty-avatar\.png/.test(index) ||
-  !/molty-avatar-hover\.gif/.test(index) ||
+  !/data-static-src="\/assets\/(?:molty-avatar\.png|pixel-lobster\.svg)"/.test(index) ||
+  !/data-hover-src="\/assets\/(?:molty-avatar-hover\.gif|pixel-lobster\.svg)"/.test(index) ||
   !/<h2 id="docs-chat-title">Molty<\/h2>/.test(index)
 ) {
   throw new Error("index: docs chat widget was not rendered");
@@ -414,6 +413,14 @@ if ((elementsIndex.match(/class="oc-card-grid oc-card-cols-4"/g) ?? []).length <
 if (!/class="breadcrumbs"/.test(index) || !/data-copy-page/.test(index) || !/class="page-feedback"/.test(index)) {
   throw new Error("index: page reader affordances are missing");
 }
+if (!/data-page-markdown-url="\/index\.md"/.test(index)
+  || !/data-page-markdown-url="\/start\/getting-started\.md"/.test(gettingStarted)) {
+  throw new Error("page tools: Copy page should target generated Markdown routes");
+}
+if (!/<script type="application\/json" data-page-markdown>/.test(index)
+  || />"---\\n/.test(index)) {
+  throw new Error("page tools: Copy page should embed frontmatter-free Markdown for synchronous clipboard writes");
+}
 assertEditSourceLinks();
 if (!/function initCodeGroups/.test(siteJs) || !/className="oc-code-tab"/.test(siteJs) || !/preferredCodeTab/.test(siteJs)) {
   throw new Error("assets: code group tabs are missing");
@@ -421,6 +428,12 @@ if (!/function initCodeGroups/.test(siteJs) || !/className="oc-code-tab"/.test(s
 if (!/function handleDocsControlClick/.test(siteJs) || !/async function copyText/.test(siteJs)) {
   throw new Error("assets: copy and feedback controls are missing");
 }
+if (!/function copyPageMarkdown/.test(siteJs)
+  || !/function pageMarkdownForCopy/.test(siteJs)
+  || /fetch\(markdownUrl/.test(siteJs)
+  || /dataset\.pageUrl\|\|location\.href/.test(siteJs)) {
+  throw new Error("assets: Copy page should copy embedded Markdown content instead of copying the URL");
+}
 if (!/Nothing to copy/.test(siteJs) || !/data-chat-copy/.test(siteJs) || !/data-heading-anchor/.test(siteJs)) {
   throw new Error("assets: chat copy feedback is missing");
 }