{
  "schemaVersion": "1.0",
  "item": {
    "slug": "search-openclaw-docs",
    "name": "OpenClaw Docs Search + Config Patterns",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/karmanverma/search-openclaw-docs",
    "canonicalUrl": "https://clawhub.ai/karmanverma/search-openclaw-docs",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/search-openclaw-docs",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=search-openclaw-docs",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "AGENTS.md",
      "POST_INSTALL.md",
      "README.md",
      "SKILL.md",
      "lib/indexer.js",
      "lib/metadata.js"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "Download the package from Yavira.",
        "Extract it into a folder your agent can access.",
        "Paste one of the prompts below and point your agent at the extracted folder."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
        },
        {
          "label": "Upgrade existing",
          "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/search-openclaw-docs"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/search-openclaw-docs",
    "agentPageUrl": "https://openagent3.xyz/skills/search-openclaw-docs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/search-openclaw-docs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/search-openclaw-docs/agent.md"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "Download the package from Yavira.",
      "Extract it into a folder your agent can access.",
      "Paste one of the prompts below and point your agent at the extracted folder."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete."
      },
      {
        "label": "Upgrade existing",
        "body": "I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "OpenClaw Documentation Search + Config Patterns",
        "body": "MANDATORY before changing openclaw.json - Embedded patterns prevent silent config breakage.\n\nTwo modes:\n\nEmbedded references (instant) - Common config patterns with anti-patterns\nDoc search (fallback) - Full OpenClaw documentation index"
      },
      {
        "title": "🚨 CRITICAL: Read AGENTS.md First",
        "body": "Before using this skill:\n\ncat ~/.openclaw/skills/search-openclaw-docs/AGENTS.md\n\nContains:\n\nMandatory workflow for config changes\nDecision tree (which reference to read)\nCritical anti-patterns overview\nWhen NOT to use this skill"
      },
      {
        "title": "Decision Tree",
        "body": "TaskActionAdding/removing agent bindingsRead references/config-bindings.mdEnabling/disabling channelsRead references/config-channel-management.mdSession reset tuningRead references/config-session-reset.mdHeartbeat configurationRead references/config-heartbeat.mdCron job setupRead references/config-cron.mdConfig broke after patchRead references/troubleshooting-config-breaks.mdBest practices overviewRead references/best-practices-config.mdMigration (2026.2.9)Read references/migration-2026-2-9.mdOther config questionsSearch docs (see below)"
      },
      {
        "title": "Embedded References (8 files)",
        "body": "Config Patterns:\n\nconfig-bindings.md - Agent routing (CRITICAL)\nconfig-channel-management.md - Enable/disable channels (CRITICAL)\nconfig-session-reset.md - Session lifetime policies (HIGH)\nconfig-heartbeat.md - Proactive monitoring (MEDIUM)\nconfig-cron.md - Scheduled tasks (MEDIUM)\n\nSupport:\n\ntroubleshooting-config-breaks.md - Fix broken configs (CRITICAL)\nbest-practices-config.md - Safe patterns (HIGH)\nmigration-2026-2-9.md - Version updates (MEDIUM)\n\nEach reference contains:\n\n✅ Correct pattern\n❌ Common anti-patterns\nWhy it breaks\nExamples"
      },
      {
        "title": "When to Use",
        "body": "ScenarioActionBefore editing openclaw.json✅ Read relevant reference firstConfig changes not working✅ Read troubleshooting referenceLearning OpenClaw config✅ Read best practices referencePersonal memory/context❌ Use memory_search insteadSupabase/database work❌ Use supabase-postgres-best-practicesNext.js code patterns❌ Use next-best-practices"
      },
      {
        "title": "Doc Search (Fallback)",
        "body": "For topics not in references, search full docs:\n\n# Search\nnode ~/.openclaw/skills/search-openclaw-docs/scripts/docs-search.js \"discord requireMention\"\n\n# Check index health\nnode ~/.openclaw/skills/search-openclaw-docs/scripts/docs-status.js\n\n# Rebuild (after OpenClaw update)\nnode ~/.openclaw/skills/search-openclaw-docs/scripts/docs-index.js rebuild"
      },
      {
        "title": "Usage Examples",
        "body": "# Config question\nnode scripts/docs-search.js \"discord requireMention\"\n\n# Troubleshooting  \nnode scripts/docs-search.js \"webhook not working\"\n\n# More results\nnode scripts/docs-search.js \"providers\" --top=5\n\n# JSON output\nnode scripts/docs-search.js \"heartbeat\" --json"
      },
      {
        "title": "Output Format",
        "body": "🔍 Query: discord only respond when mentioned\n\n🎯 Best match:\n   channels/discord.md\n   \"Discord (Bot API)\"\n   Keywords: discord, requiremention\n   Score: 0.70\n\n📄 Also relevant:\n   concepts/groups.md (0.66)\n\n💡 Read with:\n   cat /usr/lib/node_modules/openclaw/docs/channels/discord.md"
      },
      {
        "title": "How It Works",
        "body": "FTS5 keyword matching on titles, headers, config keys\nHandles camelCase terms like requireMention\nPorter stemming for flexible matching\nNo network calls - fully offline"
      },
      {
        "title": "Index Location",
        "body": "Index: ~/.openclaw/docs-index/openclaw-docs.sqlite\nDocs: /usr/lib/node_modules/openclaw/docs/\n\nIndex is built locally from your OpenClaw version."
      },
      {
        "title": "No results / wrong results",
        "body": "# 1. Check index exists\nnode scripts/docs-status.js\n\n# 2. Rebuild if stale\nnode scripts/docs-index.js rebuild\n\n# 3. Try exact config terms (camelCase matters)\nnode scripts/docs-search.js \"requireMention\"\n\n# 4. Try broader terms\nnode scripts/docs-search.js \"discord\""
      },
      {
        "title": "Integration",
        "body": "const { search } = require('./lib/search');\nconst INDEX = process.env.HOME + '/.openclaw/docs-index/openclaw-docs.sqlite';\n\nconst results = await search(INDEX, \"discord webhook\");\n// results[0].path → full path to read"
      }
    ],
    "body": "OpenClaw Documentation Search + Config Patterns\n\nMANDATORY before changing openclaw.json - Embedded patterns prevent silent config breakage.\n\nTwo modes:\n\nEmbedded references (instant) - Common config patterns with anti-patterns\nDoc search (fallback) - Full OpenClaw documentation index\n🚨 CRITICAL: Read AGENTS.md First\n\nBefore using this skill:\n\ncat ~/.openclaw/skills/search-openclaw-docs/AGENTS.md\n\n\nContains:\n\nMandatory workflow for config changes\nDecision tree (which reference to read)\nCritical anti-patterns overview\nWhen NOT to use this skill\nDecision Tree\nTask\tAction\nAdding/removing agent bindings\tRead references/config-bindings.md\nEnabling/disabling channels\tRead references/config-channel-management.md\nSession reset tuning\tRead references/config-session-reset.md\nHeartbeat configuration\tRead references/config-heartbeat.md\nCron job setup\tRead references/config-cron.md\nConfig broke after patch\tRead references/troubleshooting-config-breaks.md\nBest practices overview\tRead references/best-practices-config.md\nMigration (2026.2.9)\tRead references/migration-2026-2-9.md\nOther config questions\tSearch docs (see below)\nEmbedded References (8 files)\n\nConfig Patterns:\n\nconfig-bindings.md - Agent routing (CRITICAL)\nconfig-channel-management.md - Enable/disable channels (CRITICAL)\nconfig-session-reset.md - Session lifetime policies (HIGH)\nconfig-heartbeat.md - Proactive monitoring (MEDIUM)\nconfig-cron.md - Scheduled tasks (MEDIUM)\n\nSupport:\n\ntroubleshooting-config-breaks.md - Fix broken configs (CRITICAL)\nbest-practices-config.md - Safe patterns (HIGH)\nmigration-2026-2-9.md - Version updates (MEDIUM)\n\nEach reference contains:\n\n✅ Correct pattern\n❌ Common anti-patterns\nWhy it breaks\nExamples\nWhen to Use\nScenario\tAction\nBefore editing openclaw.json\t✅ Read relevant reference first\nConfig changes not working\t✅ Read troubleshooting reference\nLearning OpenClaw config\t✅ Read best practices reference\nPersonal memory/context\t❌ Use memory_search instead\nSupabase/database work\t❌ Use supabase-postgres-best-practices\nNext.js code patterns\t❌ Use next-best-practices\nDoc Search (Fallback)\n\nFor topics not in references, search full docs:\n\n# Search\nnode ~/.openclaw/skills/search-openclaw-docs/scripts/docs-search.js \"discord requireMention\"\n\n# Check index health\nnode ~/.openclaw/skills/search-openclaw-docs/scripts/docs-status.js\n\n# Rebuild (after OpenClaw update)\nnode ~/.openclaw/skills/search-openclaw-docs/scripts/docs-index.js rebuild\n\nUsage Examples\n# Config question\nnode scripts/docs-search.js \"discord requireMention\"\n\n# Troubleshooting  \nnode scripts/docs-search.js \"webhook not working\"\n\n# More results\nnode scripts/docs-search.js \"providers\" --top=5\n\n# JSON output\nnode scripts/docs-search.js \"heartbeat\" --json\n\nOutput Format\n🔍 Query: discord only respond when mentioned\n\n🎯 Best match:\n   channels/discord.md\n   \"Discord (Bot API)\"\n   Keywords: discord, requiremention\n   Score: 0.70\n\n📄 Also relevant:\n   concepts/groups.md (0.66)\n\n💡 Read with:\n   cat /usr/lib/node_modules/openclaw/docs/channels/discord.md\n\nHow It Works\nFTS5 keyword matching on titles, headers, config keys\nHandles camelCase terms like requireMention\nPorter stemming for flexible matching\nNo network calls - fully offline\nIndex Location\nIndex: ~/.openclaw/docs-index/openclaw-docs.sqlite\nDocs: /usr/lib/node_modules/openclaw/docs/\n\nIndex is built locally from your OpenClaw version.\n\nTroubleshooting\nNo results / wrong results\n# 1. Check index exists\nnode scripts/docs-status.js\n\n# 2. Rebuild if stale\nnode scripts/docs-index.js rebuild\n\n# 3. Try exact config terms (camelCase matters)\nnode scripts/docs-search.js \"requireMention\"\n\n# 4. Try broader terms\nnode scripts/docs-search.js \"discord\"\n\nIntegration\nconst { search } = require('./lib/search');\nconst INDEX = process.env.HOME + '/.openclaw/docs-index/openclaw-docs.sqlite';\n\nconst results = await search(INDEX, \"discord webhook\");\n// results[0].path → full path to read"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/karmanverma/search-openclaw-docs",
    "publisherUrl": "https://clawhub.ai/karmanverma/search-openclaw-docs",
    "owner": "karmanverma",
    "version": "1.1.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/search-openclaw-docs",
    "downloadUrl": "https://openagent3.xyz/downloads/search-openclaw-docs",
    "agentUrl": "https://openagent3.xyz/skills/search-openclaw-docs/agent",
    "manifestUrl": "https://openagent3.xyz/skills/search-openclaw-docs/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/search-openclaw-docs/agent.md"
  }
}