Knowledge Management Skill (Local Storage)

Organize your OpenClaw memory files into a structured local knowledge base. Automatically parses MEMORY.md and daily memory files, classifies entries by content type, and stores each as a timestamped markdown file in the appropriate folder.

Available Tools

Core Commands

• - km sync [options] - Sync memory entries to local files
• INLINECODE2 - Parse and classify without storing (JSON output)
• INLINECODE3 - Generate index files for each content type
• INLINECODE4 - Remove orphaned files
• INLINECODE5 - List all available content types

Setup

No API keys needed! The skill uses two locations:

• - Input Workspace: Where MEMORY.md and memory/ daily files are read from.
• Output Directory: Where organized folders (Research/, Decision/, etc.) are written.

Both are detected automatically:

Input Workspace (source files)

1. 1. OPENCLAWORKSPACE environment variable
2. INLINECODE11 CLI argument
3. Current working directory (if it contains MEMORY.md)
4. Default: INLINECODE13

Output Directory (organized files)

1. 1. --output-dir <path> CLI argument (relative to workspace or absolute)
2. Default: INLINECODE15

The skill will create the output directory and all content-type folders automatically.

If you want to pre-create:
CODEBLOCK0

Usage Examples

Default locations (input at workspace root, output in memory/KM)

Custom input workspace and output directory

Using environment variables

Dry run (preview only)

Classify entries and export JSON

Generate index files (default: output directory)

Preview orphan cleanup

List content types

Storage Structure

Assuming default configuration:

• - Input workspace: INLINECODE16
• Output directory: INLINECODE17

CODEBLOCK9

File Naming

Format: INLINECODE18

The 8-character content hash suffix prevents filename collisions when titles are identical but content differs.

File Content (YAML Frontmatter)

CODEBLOCK10

How It Works

1. 1. Parses MEMORY.md and recent daily memory/*.md files
2. Classifies each entry (content type, domain, certainty, impact, tags, confidence)
3. Computes content hash for deduplication
4. Checks sync state (memory/local-sync-state.json) to skip already synced entries
5. Writes to appropriate folder with timestamp + hash filename
6. Updates state mapping (hash → filepath)
7. Optional cleanup removes files not in state

Classification Logic

• - Content Type: Keyword matching (Research, Lesson, Decision, Pattern, Tutorial, Reference, Insight)
• Domain: Contextual inference (AI Models, OpenClaw, Cost, Trading, etc.)
• Certainty: Based on language (Verified, Likely, Speculative, Opinion)
• Impact: Importance indicators (High, Medium, Low, Negligible)
• Tags: Auto-extracted from predefined keyword map
• Confidence Score: 1–10 heuristic (source credibility, length, data mentions)

Customize by editing the EntryClassifier class in index-local.js.

State Management

INLINECODE24 maps content hashes to file paths:

CODEBLOCK11

This enables idempotent syncs and fast duplicate detection.

Do not edit manually unless recovering from corruption.

Cron Integration

Automate daily syncs:

CODEBLOCK12

Note: By default, the skill reads MEMORY.md from ~/.openclaw/workspace and writes organized files to ~/.openclaw/workspace/memory/KM. Use --workspace or --output-dir to customize these locations.

Troubleshooting

"km: command not found"

• - Run npm link in the skill directory, or add ~/workspace/bin to PATH.

No entries found

• - Ensure MEMORY.md uses ## section headers and ### entry titles within recognized sections.

Files not created

• - Check write permissions; run with --verbose.

Old entries not syncing

• - They may already be in state. Clear memory/KM/local-sync-state.json to force re-sync (caution: may duplicate files).

Duplicate files

• - Run km cleanup to remove orphans, then km sync to create missing files.