← Back to Skills Marketplace
Rocky Know-How
by
Rocky.Tian
· GitHub ↗
· v3.4.8
· MIT-0
279
Downloads
0
Stars
1
Active Installs
48
Versions
Install in OpenClaw
/install rocky-know-how
Description
Learning knowledge skill v3.4.8 — vector search with bge-large-zh-v1.5, auto-fallback to keyword search, preprocessing for numbers/English/spell-correction....
Usage Guidance
What to consider before installing:
- Review the code first: handler.js and scripts perform reading of session messages and write them to ~/.openclaw/.learnings; inspect these files for any unexpected network endpoints or obfuscated behavior.
- Credential access: the hook attempts to read OpenClaw config and auth stores (openclaw.json, auth-profiles.json) and may use stored API keys / OAuth tokens to call model providers. If you do not want a skill to use agent-managed credentials, do not install it or run it in a sandbox.
- Privacy: conversation content and errors may be persisted to disk (experiences.md, drafts, pending). If conversations include sensitive data, this will be captured locally and accessible to other local users/agents sharing the same directory.
- Prompt injection: the skill injects text into the agent's systemPrompt (documented). That can bias or alter agent behavior across sessions — evaluate whether you want that.
- Inconsistencies: docs and hook metadata differ (events like agent_end vs before_compaction, and code comments show different flows). Treat the published documentation as possibly out-of-date and prefer inspecting handler.js for actual behavior.
Recommended actions:
- If you still want to use it, run it in an isolated environment (container or dedicated user) so persisted learnings and any credential reads are confined.
- Manually inspect handler.js (resolveProviderInfo, callLLMApi) and auto-review.sh/record.sh for any network calls beyond model providers or any code that writes outside ~/.openclaw/.learnings.
- Backup or restrict access to openclaw auth files or remove credentials you do not wish the skill to use.
- When in doubt, decline installation or request a version from a verified source with clearer manifest declarations of required config and credential access.
Capability Analysis
Type: OpenClaw Skill
Name: rocky-know-how
Version: 3.4.8
The skill implements an automated knowledge-retention system with high-risk capabilities, including the modification of the core OpenClaw configuration file (`openclaw.json`) during installation (`install.sh`) and the execution of shell scripts using data processed by LLMs (`handler.js`). While the bundle includes extensive security measures such as shell escaping, path traversal validation (`search.sh`), and atomic file locking (`common.sh`), the complexity of the automated recording loop and the reliance on shell execution for core logic create a significant attack surface. The system also performs network requests to local embedding APIs (`vectors.sh`) and remote LLM providers, which is consistent with its stated purpose but remains a high-privilege behavior.
Capability Tags
Capability Assessment
Purpose & Capability
The skill's name/description (experience learning, vector search, LLM fallback) align with the code and scripts that extract, index, search and promote experiences. However files (handler.js) attempt to read OpenClaw runtime config and auth stores (openclaw.json, auth-profiles.json) to discover model providers/tokens — this access is not declared in metadata and is stronger than the simple 'search & record' description. Some files/headers also describe different event integrations (agent_end vs before_compaction), indicating version drift/inconsistency between docs and runtime behavior.
Instruction Scope
Runtime instructions and code save conversation/session content, inject text into the agent's systemPrompt, scan memory files, and write persistent records to a shared directory (~/.openclaw/.learnings). handler.js extracts messages and may call LLMs to judge drafts; auto-review.sh will run and can append/modify experiences.md. These actions can persist potentially sensitive chat content to disk and modify the agent prompt. The pre-scan flagged 'system-prompt-override' is consistent with the skill's documented injection of reminders into systemPrompt.
Install Mechanism
No remote downloads or package installers are specified (instruction-only with bundled scripts). All code is included in the skill bundle, and there is no external install URL that would fetch arbitrary code.
Credentials
Registry metadata declares no required env vars, but handler.js and scripts read environment variables and platform config files (OPENCLAW_STATE_DIR, OPENCLAW_WORKSPACE, openclaw.json, auth-profiles.json) and may extract provider API keys or OAuth tokens to call LLM APIs. Accessing stored auth tokens is a privileged operation and is not declared in requires.env; the skill may therefore use the agent's configured credentials to make outbound LLM calls without explicit declaration.
Persistence & Privilege
The skill writes persistent files under ~/.openclaw/.learnings and may run automatically on hook events (autonomous invocation allowed). It does not request 'always: true', but because it persists session content to a shared location and can run auto-review/compaction scripts, it has lasting system presence and can affect other agents that share the same learnings directory.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install rocky-know-how - After installation, invoke the skill by name or use
/rocky-know-how - Provide required inputs per the skill's parameter spec and get structured output
Version History
v3.4.8
版本号全面统一到3.4.8
v3.4.7
全面统一版本号到3.4.6:ARCHITECTURE, README, README_EN, SKILL, _meta, setup
v3.4.6
版本号全面统一为3.4.6
v3.4.5
修复SKILL.md底部版本号仍显示3.3.0的问题
v3.4.4
修复SKILL.md正文标题仍显示v3.3.0的问题
v3.4.3
修复SKILL.md description版本号仍显示3.3.0的问题,更新为v3.4.2
v3.4.2
版本号统一修复: README_EN.md badge更新到3.4.1, 全部文件统一到3.4.2
v3.4.1
新增向量搜索降级机制:当LM Studio不可用时自动切换到关键词搜索
v3.4.0
新增 vector_preprocess() 预处理补丁: 支持纯数字/英文/拼写纠错搜索, 默认模型改为 bge-large-zh-v1.5 (1024维)
v3.3.0
安全修复:路径穿越/选项注入/并发锁/输入校验
v3.0.1
v3.0.1 - 三模型验证、全自动闭环、中英双语文档
v3.0.0
v3.0.0 - 三大模型验证(deepseek-v4/glm-5.1/minimax-m2.7)、4事件全自动闭环、LLM双判断、三层存储、中英双语文档、4632行代码
v2.9.3
Version 2.9.3 summary: Major architecture update with new LLM judgment flow and broader provider support.
- Introduced a two-stage compaction workflow: before_compaction now extracts context to pending, after_compaction uses LLM to review for worth and writes to experiences.md automatically.
- Full cross-provider LLM support, including zai, stepfun, and minimax with OAuth.
- Improved extractAssistantMessage compatibility for multi-format responses.
- Added new storage layers: drafts/ for drafts and pending/ for unreviewed context.
- Refined documentation to explain the updated workflow and new directories.
- Removed legacy files and refactored hook handler location for better modularity.
v2.8.17
压缩前生成草稿/压缩后写入正式经验: before_compaction 从对话内容生成草稿,after_compaction 处理草稿写入正式经验
v2.8.16
after_compaction 全自动草稿审核集成 v2.8.16: 压缩后自动生成草稿+AI优化+去重+写入正式经验
v2.8.15
v2.8.15: 🤖 **全部自动化** -老公说"都是自动",现已实现:1) before_compaction自动搜索相关经验并注入上下文 2) auto-review.sh后自动调用promote.sh进行Tag晋升 3) 所有手动脚本全部消除。真正零人工干预!
v2.8.14
v2.8.14: 🔄 Hook全自动集成 - before_reset 触发后自动生成草稿 → 调用 auto-review.sh → 审核 → 写入 experiences.md → 归档草稿。端到端全自动,无需人工干预。老公选择方案2,现已实现。
v2.8.13
v2.8.13: 根目录文档更新 - README.md & README_EN.md 全面更新到 v2.8.12。强调全自动工作流(auto-review.sh),新增脚本优先级标注(auto-review.sh ⭐⭐⭐),精简文档结构,更新版本历史到 2.8.12。老公问"根目录,文档更新了吗?",现已全部更新。
v2.8.12
v2.8.12: ✅ 完整体测试验证通过。全自动草稿→审核→写入→归档→搜索流程确认正常。测试草稿 draft-test-1776966700 成功写入 EXP-20260424-002,搜索 'git conflict' 匹配度 2/2 第一位。新增 SKILL-GUIDE.md (20KB) 完整使用指南,12章节覆盖安装→使用→架构→运维。老公要求'完完整整、认认真真测试',现已验证通过。
v2.8.11
v2.8.11: 新增 SKILL-GUIDE.md (20KB) - 完整技能使用指南。12个章节:1)技能概述 2)完整架构设计 3)数据存储结构 4)脚本命令详解 5)Hook事件机制 6)标签与晋升系统 7)存储分层策略 8)安全机制 9)使用流程图 10)常见场景示例 11)故障排查 12)最佳实践。附录:文件清单、环境变量、依赖项。老公要求'构建完整的技能说明文档,越详细越好',现已完整覆盖。
Metadata
Frequently Asked Questions
What is Rocky Know-How?
Learning knowledge skill v3.4.8 — vector search with bge-large-zh-v1.5, auto-fallback to keyword search, preprocessing for numbers/English/spell-correction.... It is an AI Agent Skill for Claude Code / OpenClaw, with 279 downloads so far.
How do I install Rocky Know-How?
Run "/install rocky-know-how" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Rocky Know-How free?
Yes, Rocky Know-How is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Rocky Know-How support?
Rocky Know-How is cross-platform and runs anywhere OpenClaw / Claude Code is available (darwin, linux).
Who created Rocky Know-How?
It is built and maintained by Rocky.Tian (@rockytian-top); the current version is v3.4.8.
More Skills