feat(openclaw): add agent behavioral skill + directive guidance (0.6.12)

[wey-gu]

Register skills/memory-guide/SKILL.md via manifest skills[] array so OpenClaw auto-discovers it. The skill teaches the agent when and how to search, save, explore connections, and fetch threads — the single biggest change for memory recall quality.

Rewrite behavioral.js to use directive "Before answering questions about prior work, decisions, dates, people, preferences, or plans: search" instead of passive "When prior context would improve your response." Explicitly notes "natural language queries, not file paths" to counter OpenClaw's built-in file-based memory section.

Summary by CodeRabbit

• New Features

  • Added memory-guide skill with capabilities for search, save, timeline exploration, connection browsing, and working memory access.

• Improvements

  • Memory search is now active before answering questions about prior work, decisions, people, preferences, and plans.
  • Two-layer deduplication system for improved memory management.
  • Enhanced session context behavior for more efficient recall.

• Documentation

  • Updated behavioral guidance with new memory search semantics.

[coderabbitai]

Caution

Review failed

The pull request is closed.

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: defaults

Review profile: CHILL

Plan: Pro

Run ID: bb245886-62cb-43c9-9063-cb457836441c

📥 Commits

Reviewing files that changed from the base of the PR and between 69b63d3 and 146f053.

📒 Files selected for processing (7)

• nowledge-mem-openclaw-plugin/CHANGELOG.md
• nowledge-mem-openclaw-plugin/CLAUDE.md
• nowledge-mem-openclaw-plugin/README.md
• nowledge-mem-openclaw-plugin/openclaw.plugin.json
• nowledge-mem-openclaw-plugin/package.json
• nowledge-mem-openclaw-plugin/skills/memory-guide/SKILL.md
• nowledge-mem-openclaw-plugin/src/hooks/behavioral.js

---

📝 Walkthrough

Walkthrough

This release introduces version 0.6.12 of the nowledge-mem-openclaw-plugin, adding a new memory-guide behavioral skill registered via the OpenClaw manifest. The skill provides comprehensive memory operations (search, save, connections, timelines, threads, working memory). Behavioral guidance updated to direct proactive memory search before answering questions about prior work, decisions, dates, people, preferences, or plans.

Changes

Cohort / File(s)	Summary
Release & Manifest Configuration CHANGELOG.md, openclaw.plugin.json, package.json	Version bump from 0.6.11 to 0.6.12; added skills field to plugin manifest and updated package distribution files list to include skills directory.
Documentation Updates CLAUDE.md, README.md	Updated terminology from "behavioral hook" to "behavioral skill"; expanded descriptions of memory guidance, deduplication logic, session context interactions, and two-layer recall approach; clarified memory search semantics and thread access patterns.
Memory-Guide Skill Definition skills/memory-guide/SKILL.md	New documentation defining the memory-guide skill with sections for semantic search, structured memory saving, connection exploration, timeline browsing, thread retrieval, and working memory operations; includes usage examples and behavioral constraints.
Behavioral Guidance Logic src/hooks/behavioral.js	Rewrote guidance text in BASE_GUIDANCE and SESSION_CONTEXT_GUIDANCE to direct proactive memory searches using natural language queries before answering about prior work, decisions, people, preferences, or plans; specified that searches return memories with scores, labels, and thread snippets; updated save triggers to decisions, preferences, plans, and learning outcomes.

Estimated code review effort

🎯 2 (Simple) | ⏱️ ~12 minutes

Possibly related PRs

• batch v0.6.3 changes #79 — Both PRs modify the OpenClaw plugin's behavioral guidance in src/hooks/behavioral.js and related manifest/tooling for memory and thread direction.
• feat(Droid): Add native Droid plugin for Nowledge Mem #120 — Both PRs modify the behavioral hook in src/hooks/behavioral.js and update the plugin manifest with skill registration.

Poem

🐰 A memory burrows deep and wide,
Search with purpose, let none hide,
Skills now guide the agent's way,
Through time's warren, come what may! 🌿✨

✨ Finishing Touches

• 📝 Generate docstrings (stacked PR)
• 📝 Generate docstrings (commit on current branch)

🧪 Generate unit tests (beta)

• Create PR with unit tests
• Post copyable unit tests in a comment
• Commit unit tests in branch dev_0611

📝 Coding Plan

• Generate coding plan for human review comments

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands and usage tips.}