diff --git a/web/app/[locale]/page.tsx b/web/app/[locale]/page.tsx
index f1f6049..d382d05 100644
--- a/web/app/[locale]/page.tsx
+++ b/web/app/[locale]/page.tsx
@@ -154,6 +154,20 @@ export default async function HomePage({
             </div>
           </article>
 
+          <article className="integration-step-card">
+            <div className="integration-step-head">
+              <span className="integration-step-dot" aria-hidden="true" />
+              <span className="integration-step-label">OPENCLAW</span>
+              <h3>{dictionary.home.agentSkillTitle}</h3>
+            </div>
+            <div className="integration-step-body">
+              <p>{dictionary.home.agentSkillDescription}</p>
+              <pre>
+                <code>{dictionary.home.agentSkillCommand}</code>
+              </pre>
+            </div>
+          </article>
+
           <article className="integration-step-card">
             <div className="integration-step-head">
               <span className="integration-step-dot" aria-hidden="true" />
diff --git a/web/lib/site-content.ts b/web/lib/site-content.ts
index 235995e..051c1df 100644
--- a/web/lib/site-content.ts
+++ b/web/lib/site-content.ts
@@ -131,6 +131,9 @@ export type AppDictionary = {
     bootstrapTitle: string;
     bootstrapDescription: string;
     bootstrapCommand: string;
+    agentSkillTitle: string;
+    agentSkillDescription: string;
+    agentSkillCommand: string;
     trustTag: string;
     trustTitle: string;
     trustStats: Stat[];
@@ -311,6 +314,11 @@ const zh: AppDictionary = {
     bootstrapDescription: "生成 shell completion、默认 skill discovery profile，并把 PopiArt 直接暴露给 agent。",
     bootstrapCommand:
       "popiart bootstrap --agent codex --completion zsh\npopiart bootstrap --agent codex --discoverable\npopiart skills list",
+    agentSkillTitle: "OpenClaw 手动安装 agent skill",
+    agentSkillDescription:
+      "如果通过 GitHub 目录安装，请指向 popiartcli 仓库的 skill/ 目录；不要使用仓库根目录或 blob/main/skill/SKILL.md，避免安装器扫描到 runtime PopiSkills。",
+    agentSkillCommand:
+      "https://github.com/wtgoku-create/popiartcli/tree/main/skill\n\nmkdir -p ~/.openclaw/skills/popiart-cli\ncurl -fsSL https://raw.githubusercontent.com/wtgoku-create/popiartcli/main/skill/SKILL.md \\\n  -o ~/.openclaw/skills/popiart-cli/SKILL.md",
     trustTag: "CLI DESIGN",
     trustTitle: "围绕 agent 工作流设计，而不是零散脚本拼装",
     trustStats: [
@@ -638,6 +646,11 @@ const en: AppDictionary = {
     bootstrapDescription: "Generate shell completion, a default discovery profile, and make PopiArt directly available to your coding agent.",
     bootstrapCommand:
       "popiart bootstrap --agent codex --completion zsh\npopiart bootstrap --agent codex --discoverable\npopiart skills list",
+    agentSkillTitle: "Manual OpenClaw agent skill install",
+    agentSkillDescription:
+      "If installing from GitHub, point installers at the popiartcli skill/ directory. Do not use the repository root or blob/main/skill/SKILL.md, because some installers scan runtime PopiSkills as agent skills.",
+    agentSkillCommand:
+      "https://github.com/wtgoku-create/popiartcli/tree/main/skill\n\nmkdir -p ~/.openclaw/skills/popiart-cli\ncurl -fsSL https://raw.githubusercontent.com/wtgoku-create/popiartcli/main/skill/SKILL.md \\\n  -o ~/.openclaw/skills/popiart-cli/SKILL.md",
     trustTag: "CLI DESIGN",
     trustTitle: "Designed around agent workflows instead of scattered scripts",
     trustStats: [