openclaw - 💡(How to fix) Fix memory-wiki lint: sources/ directory requires frontmatter on raw imported files [1 participants]

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…
GitHub stats
openclaw/openclaw#69700Fetched 2026-04-22 07:49:15
View on GitHub
Comments
0
Participants
1
Timeline
0
Reactions
0
Author
Participants
RAW_BUFFERClick to expand / collapse

Bug Description

The wiki_lint command reports errors for files in the sources/ directory, requiring frontmatter fields (id, pageType, updatedAt) even when these files are imported raw materials that should be preserved in their original state.

Expected Behavior

According to the official documentation:

sources/ — for imported raw material and bridge-backed pages

This suggests sources/ is intended for raw, unmodified content (e.g., web scrapes, imported articles). The lint rule requiring frontmatter on these files conflicts with the "raw material" intent.

Actual Behavior

``` $ openclaw wiki lint Issues: 3 total (2 errors, 1 warnings)

  • sources/paths.md: Missing id frontmatter.
  • sources/paths.md: Missing pageType frontmatter.
  • sources/paths.md: Page freshness needs review (missing updatedAt). ```

Conflict Analysis

DocumentationLint Rule
sources/ = "imported raw material"Requires id, pageType, updatedAt
Should preserve original stateFrontmatter modification = tampering

This creates a design contradiction:

  1. If sources/ truly contains "raw material", adding frontmatter modifies the original content
  2. If frontmatter is required, then sources/ is not actually storing "raw material"

Suggested Fixes

Option A: Exclude sources/ directory from frontmatter lint checks

  • The lint rule should only apply to generated wiki pages, not imported raw materials

Option B: Clarify that sources/ is NOT for raw original files

  • Update documentation to clarify that all wiki files require frontmatter, including imported content

Option C: Add a "raw mode" for sources/ files

  • Allow some files in sources/ to be marked as "preserve-as-is" without frontmatter requirements

Environment

  • OpenClaw version: 2026.4.x (latest)
  • Memory-wiki vault mode: isolated
  • Config: bridge enabled, Obsidian enabled

Related Issues

This is similar in spirit to issue #64696 (bridge import/lint mishandling), though different in scope.

extent analysis

TL;DR

Exclude the sources/ directory from frontmatter lint checks to resolve the conflict between the lint rule and the intended use of sources/ for raw, unmodified content.

Guidance

  • Review the OpenClaw documentation to understand the intended use of the sources/ directory and how it relates to the lint rule.
  • Consider implementing Option A: Exclude sources/ from frontmatter lint checks to preserve the original state of imported raw materials.
  • Evaluate the trade-offs between Option B (updating documentation to clarify that all wiki files require frontmatter) and Option C (adding a "raw mode" for sources/ files) to determine the best approach for your specific use case.
  • Verify that excluding sources/ from lint checks does not introduce any unintended consequences, such as inconsistent data or security vulnerabilities.

Example

No code snippet is provided as the issue is more related to configuration and documentation rather than code.

Notes

The solution may depend on the specific requirements of your wiki and the trade-offs between preserving original content and enforcing frontmatter rules. It is essential to evaluate the options carefully and consider the potential impact on your wiki's data consistency and security.

Recommendation

Apply workaround: Exclude the sources/ directory from frontmatter lint checks. This approach aligns with the intended use of sources/ for raw, unmodified content and avoids modifying the original state of imported materials.

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…

Still need to ship something?

×6

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

Back to top recommendations

TRENDING

openclaw - 💡(How to fix) Fix memory-wiki lint: sources/ directory requires frontmatter on raw imported files [1 participants]