openclaw - 💡(How to fix) Fix docs-search skill broken after 2026.4.15: local docs bundle reduced from 375 files to 13 templates

Official PRs (…)
ON THIS PAGE

Recommended Tools

×6

Utilities matched from this issue’s tags and category — try them while you read without losing context.

GitHub issue graph ai analysis

Paste a GitHub issue URL. We fetch that issue, discover linked issues from bodies/comments/timeline, collect linked pull requests, and produce a structured English report.

The report is written in English Markdown for sharing and archival.

Helpful · Quick feedback

Loading…

Starting with 2026.4.15, the local docs bundle at /opt/homebrew/lib/node_modules/openclaw/docs/ was restructured from a full documentation set (~375 markdown files, ~3425 chunks) down to 13 template files under docs/reference/templates/.

This breaks the openclaw-docs CLI and any skill/workflow that relies on local doc search:

$ openclaw-docs sync
OpenClaw version: 2026.4.15
Source: /opt/homebrew/lib/node_modules/openclaw/docs
Found 13 docs
Generated 50 chunks
Sync complete: 13 docs, 50 chunks (v2026.4.15)

Previously (2026.4.9):

Sync complete: 375 docs, 3425 chunks

Root Cause

Starting with 2026.4.15, the local docs bundle at /opt/homebrew/lib/node_modules/openclaw/docs/ was restructured from a full documentation set (~375 markdown files, ~3425 chunks) down to 13 template files under docs/reference/templates/.

This breaks the openclaw-docs CLI and any skill/workflow that relies on local doc search:

$ openclaw-docs sync
OpenClaw version: 2026.4.15
Source: /opt/homebrew/lib/node_modules/openclaw/docs
Found 13 docs
Generated 50 chunks
Sync complete: 13 docs, 50 chunks (v2026.4.15)

Previously (2026.4.9):

Sync complete: 375 docs, 3425 chunks

Code Example

$ openclaw-docs sync
OpenClaw version: 2026.4.15
Source: /opt/homebrew/lib/node_modules/openclaw/docs
Found 13 docs
Generated 50 chunks
Sync complete: 13 docs, 50 chunks (v2026.4.15)

---

Sync complete: 375 docs, 3425 chunks

---

docs/reference/templates/SOUL.dev.md
docs/reference/templates/USER.dev.md
docs/reference/templates/TOOLS.dev.md
docs/reference/templates/IDENTITY.md
docs/reference/templates/HEARTBEAT.md
docs/reference/templates/IDENTITY.dev.md
docs/reference/templates/BOOTSTRAP.md
docs/reference/templates/USER.md
docs/reference/templates/SOUL.md
docs/reference/templates/AGENTS.dev.md
docs/reference/templates/AGENTS.md
docs/reference/templates/BOOT.md
docs/reference/templates/TOOLS.md
RAW_BUFFERClick to expand / collapse

Summary

Starting with 2026.4.15, the local docs bundle at /opt/homebrew/lib/node_modules/openclaw/docs/ was restructured from a full documentation set (~375 markdown files, ~3425 chunks) down to 13 template files under docs/reference/templates/.

This breaks the openclaw-docs CLI and any skill/workflow that relies on local doc search:

$ openclaw-docs sync
OpenClaw version: 2026.4.15
Source: /opt/homebrew/lib/node_modules/openclaw/docs
Found 13 docs
Generated 50 chunks
Sync complete: 13 docs, 50 chunks (v2026.4.15)

Previously (2026.4.9):

Sync complete: 375 docs, 3425 chunks

What's in the bundle now

Only these 13 files exist:

docs/reference/templates/SOUL.dev.md
docs/reference/templates/USER.dev.md
docs/reference/templates/TOOLS.dev.md
docs/reference/templates/IDENTITY.md
docs/reference/templates/HEARTBEAT.md
docs/reference/templates/IDENTITY.dev.md
docs/reference/templates/BOOTSTRAP.md
docs/reference/templates/USER.md
docs/reference/templates/SOUL.md
docs/reference/templates/AGENTS.dev.md
docs/reference/templates/AGENTS.md
docs/reference/templates/BOOT.md
docs/reference/templates/TOOLS.md

These are workspace bootstrap templates, not actual documentation.

Impact

  • openclaw-docs search now only searches template content, making it essentially useless for looking up features, config options, channel setup, etc.
  • Any agent skill relying on local doc search is effectively broken.

Expected behavior

Either:

  1. Ship the full documentation in the npm package as before, or
  2. Have openclaw-docs fall back to / sync from https://docs.openclaw.ai when the local bundle is minimal

Environment

  • OpenClaw: 2026.4.15 (npm, macOS arm64)
  • openclaw-docs: synced against bundled docs path

extent analysis

TL;DR

The issue can be mitigated by modifying the openclaw-docs CLI to fall back to syncing from https://docs.openclaw.ai when the local documentation bundle is minimal.

Guidance

  • Verify the current behavior of openclaw-docs sync to confirm it only searches the local template files.
  • Check the openclaw-docs documentation to see if there are any configuration options to specify an alternative documentation source.
  • Consider modifying the openclaw-docs CLI to check the number of local documentation files and fall back to syncing from https://docs.openclaw.ai if the number of files is below a certain threshold (e.g., 13).
  • Test the modified openclaw-docs CLI to ensure it correctly syncs from the remote documentation source when the local bundle is minimal.

Example

No code example is provided as the issue does not contain sufficient information about the implementation details of openclaw-docs.

Notes

The provided information suggests that the issue is caused by the change in the local documentation bundle structure. However, without more information about the openclaw-docs implementation, it is difficult to provide a definitive solution.

Recommendation

Apply workaround: Modify the openclaw-docs CLI to fall back to syncing from https://docs.openclaw.ai when the local documentation bundle is minimal, as this approach allows for a temporary solution until the full documentation set is restored to the npm package.

Vote matrix · Quick signals

Works
Did the solution work? Tap to confirm.
Easy Fix
Was it a quick fix?
Time Saver
Did it save you time?
Blocking
Was it severely blocking?
Common Issue
Are others likely hitting this too?
Flaky / Intermittent
Is it intermittent?
Verified / Reproducible
Can you reproduce it reliably?
Loading…

FAQ

Expected behavior

Either:

  1. Ship the full documentation in the npm package as before, or
  2. Have openclaw-docs fall back to / sync from https://docs.openclaw.ai when the local bundle is minimal

Still need to ship something?

×6

Another batch ranked right after the header list — different links, same matching logic.

Back to top recommendations

TRENDING