← Back to Skills Marketplace
nandujia

starmemo

by nandujia · GitHub ↗ · v2.0.0 · MIT-0
cross-platform ⚠ suspicious
483
Downloads
1
Stars
2
Active Installs
15
Versions
Install in OpenClaw
/install starmemo
Description
智能记忆系统 v2.0 - 结构化记忆 + 知识库 + 启发式召回 + AI优化
Usage Guidance
Key things to consider before installing: - Autosave behavior: by default the skill's on_user_input will save every user message to disk (memory_data/daily). This may differ from the README/SKILL.md's description of selective/heuristic saving. If you expect selective saving, review/modify the on_user_input logic or configuration before enabling it in production. - Network calls and API keys: the skill will call LLM endpoints if you enable AI optimization and provide an API key. API keys can be persisted to a local .skill_config file; do not enable persist_key if you don't want keys written to disk. Also confirm that setting 'web' or 'allow_web_fetch' actually prevents network access in your deployment — the code does not consistently check this flag. - Runtime pip install: the modules auto-install the 'requests' package via pip at import time (subprocess). If you run in constrained or audited environments, prefer pre-installing dependencies or inspect that behavior. - Storage inconsistency: the repository contains two different storage paths (memory_data/ used by top-level starmemo.py and memory/ used by v2/storage). That can lead to scattered data across directories — search your filesystem after testing to find where data is stored. - Recommended mitigations: run the skill in an isolated or dev environment first; set enable_ai=false and persist_key=false before hooking into production; inspect and (if needed) edit on_user_input to enforce selective saving triggers; review .skill_config after first run; and avoid sending sensitive secrets to the skill until you confirm its behavior. - If you want more assurance: ask the author for clarification about the autosave policy, the intended use of allow_web_fetch, and why two storage paths are used; or request a small patch that respects a single 'save' policy and that makes network access explicit and gated.
Capability Analysis
Type: OpenClaw Skill Name: starmemo Version: 2.0.0 The starmemo skill bundle is a structured memory and knowledge management system for OpenClaw agents. It uses local Markdown files for storage and integrates with several legitimate Chinese LLM providers (e.g., Volcengine, Alibaba, DeepSeek) for text summarization and knowledge extraction. While it includes an auto-installation routine for the 'requests' library using subprocess and performs web searches via 'r.jina.ai', these behaviors are transparently documented and align with the stated purpose of the skill. No evidence of data exfiltration, malicious prompt injection, or unauthorized persistence was found.
Capability Assessment
Purpose & Capability
Name/description (智能记忆/知识库) align with the code's features (local memory, knowledge extraction, LLM calls). However there are inconsistencies: top-level starmemo.py saves raw inputs into memory_data/daily unconditionally (global autosave), while v2/storage.py uses a different memory/ directory structure. The README and SKILL.md describe selective/heuristic saving, but the top-level on_user_input implements unconditional saving for all platforms by default — this deviates from the stated behavior and is disproportionate to a 'selective memory' expectation.
Instruction Scope
SKILL.md and README describe selective triggers and a '可控联网' option to disable network fetches. In practice: the skill registers an on_user_input hook that will save every user input by default (ctx.get('config', {}) falls back to save=True). Network LLM calls are gated by API key and enable_ai flags, but config flags like allow_web_fetch exist yet are not consistently checked before making LLM requests (LLMClient checks enable_ai and api_key, not allow_web_fetch). That means disabling 'web' in config may not reliably prevent network calls if enable_ai and api_key are present. The instructions and the runtime behavior therefore disagree on when/what gets saved and when network access occurs.
Install Mechanism
No install spec in the registry but several modules (starmemo.py and v2/ai_processor.py) call an auto_install() that uses subprocess to pip install requests at import time. That performs network install and runs pip via subprocess during skill load — not ideal but limited to a single well-known package (requests). This is a moderate surprise for users expecting 'instruction-only' or no runtime installs.
Credentials
The skill does not request platform environment variables or external credentials at install time. LLM API keys are stored in a local .skill_config file (optionally persisted) rather than via declared env vars. That is proportionate for an LLM-backed memory tool, but note that API keys will be written to disk if 'persist_key' is enabled.
Persistence & Privilege
The skill is not marked always:true, but _meta.json registers a hook on_user_input and the code's on_user_input will automatically save all user inputs by default. That gives the skill broad write access to local storage (it writes memory files and a .skill_config). Because it's invoked on every user message, its effective persistence and data collection surface are larger than the SKILL.md's selective-trigger description — this increases privacy risk.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install starmemo
  3. After installation, invoke the skill by name or use /starmemo
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.0
starmemo 1.1.4 → 2.0.0: 全面升级为结构化智能记忆系统 - 引入 v2 目录,重构核心模块:core.py、cli.py、ai_processor.py、recall.py、storage.py - 支持结构化记忆(因→改→待)、自动知识点提取、启发式召回和 AI 优化 - 全新 CLI:save/search/show/knowledge/config 多命令交互 - 文档重写:版本描述、特性、用法、配置展示更清晰 - 移除旧 skill.md,采用新版 SKILL.md - 兼容主流国内 LLM 并支持联网知识补全
v1.1.3
starmemo 1.1.3 - 默认依赖策略修改:首次运行自动安装 requests≥2.31.0,无需用户手动操作。 - 安全声明与文档同步:安全与隐私声明部分明确与实际代码一致,删除了“需手动安装依赖”的表述。 - 其他文档微调和表述优化,使用更友好的描述且与实际实现保持一致。 - 功能和用法未变,无功能代码变更,仅SKILL.md文档内容调整。
v1.1.2
- 新增官方 LLM API 地址总览表,支持各主流厂商及一键模型切换 - 安全声明升级:明确依赖不自动安装、API 密钥默认不持久化、本地文件操作范围受限 - 支持 API 密钥持久化显式配置,默认只临时内存存储 - 优化敏感操作说明及网络访问开关(ai=false下全本地运行) - 配置指令与安全提示文档结构优化
v1.1.1
starmemo 1.1.1 增强说明: - 新增多渠道消息兼容,自动适配飞书、QQ、企微等结构化消息格式 - 增加消息清洗功能,自动移除@人、表情、CQ码等非文本内容 - 支持分场景记忆开关与场景识别,可按不同平台独立控制记忆保存 - 提供外部接口,允许其它技能写入/调用公共记忆 - 密钥安全能力增强,支持 API Key 不持久化及联网权限独立开关 - 支持纯本地离线运行,灵活兼容更多实际应用场景
v1.1.0
No file changes detected for version 1.1.0. - No changes were made in this version.
v1.0.9
Version 1.0.9 of starmemo - No code or documentation changes detected in this release. - No new features, bug fixes, or other modifications introduced.
v1.0.8
starmemo 1.0.8 - No code or file changes in this version. - Documentation updated; no impact on features or behavior. - All functionality remains the same as the previous release.
v1.0.7
starmemo 1.0.7 - 修正 README 文件命名不一致问题:移除小写 readme.md,新增大写 README.md,提升兼容性和规范性。 - 优化飞书无法实现on_user_input 钩子未被激活。
v1.0.6
starmemo 1.0.6 - 请求自动依赖安装由 `requests≥2.28.0` 升级为 `requests≥2.31.0`,首次运行时触发,支持更高版本兼容性建议。 - 新增 `记忆配置 show` 指令,可本地查看当前配置,避免手动核查配置文件。 - 增补“数据传输说明”章节,明确仅在 AI 优化启用时才会外发文本/密钥,所有网络请求均为按需触发。 - 优化安全隐私描述,强调 API 密钥仅本地保存,不上传;支持完全本地截断操作。 - 技能说明文档整体细化,特别提醒如需规避自动依赖安装,可提前手动安装依赖。
v1.0.5
starmemo 1.0.5 - 自动安装 requests(版本 ≥2.28.0),无须手动依赖,提升易用性 - 其余功能文档与用法保持不变
v1.0.4
- 增强记忆流程,优先使用本地短记忆检索(无需消耗 Token),并自动融合极简上下文提升效率 - 新增自迭代优化:在记忆不足时自动澄清、联网补全并压缩为短记忆,持续提升记忆质量 - 优化分层存储结构,明确每日、每周与归档三层及清理规则 - 提供详细 Token 控制与存储权限说明,提升数据安全与隐私保护 - 补充交互与验证方法,方便用户确认记忆效果
v1.0.3
- 增强记忆流程,优先使用本地短记忆检索(无需消耗 Token),并自动融合极简上下文提升效率 - 新增自迭代优化:在记忆不足时自动澄清、联网补全并压缩为短记忆,持续提升记忆质量 - 优化分层存储结构,明确每日、每周与归档三层及清理规则 - 提供详细 Token 控制与存储权限说明,提升数据安全与隐私保护 - 补充交互与验证方法,方便用户确认记忆效果
v1.0.2
- 新增“安全与隐私”说明,进一步明确本地数据保护和操作建议 - 更新“技术细节”,强调本地文件权限和 API Key 的安全传递建议 - 明确 memory_data 目录为本地用户只读写,提升隐私管理规范 - 补充建议定期清理冷层数据,防止隐私隐患
v1.0.1
- Migrated to a more concise, modular codebase: removed 8 files, added 3 core files. - Rewrote and expanded documentation in SKILL.md with clearer setup, extended features, and security guidance. - Unified all configuration and usage instructions in the new, detailed readme. - Simplified deployment: all memory and logic now located in starmemo.py; supporting docs reorganized. - Enhanced privacy: configuration and saved data are managed more securely.
v1.0.0
starmemo 1.0.0 Changelog 🚀 Initial Release First official launch of starmemo 1.0.0 — an AI-powered memory optimization engine designed for intelligent memory management and cross-platform AI integration. ✨ Core Features AI Memory Optimization Engine: Core functionality for intelligent memory processing and optimization Multi-Platform AI Support (full compatibility): 火山方舟 DeepSeek 阿里百炼 智谱 GLM 讯飞星火 百度千帆 Simplified Configuration: Quick setup via main.py Secure chat command-based configuration Dual Operation Modes (switchable via ENABLE_AI): AI-optimized mode (intelligent memory enhancement) Pure local mode (offline, standalone operation) Flexible Configuration System: Temporary settings (session-only) Permanent settings (persistent storage) Intuitive command syntax for all configuration operations
Metadata
Slug starmemo
Version 2.0.0
License MIT-0
All-time Installs 2
Active Installs 2
Total Versions 15
Frequently Asked Questions

What is starmemo?

智能记忆系统 v2.0 - 结构化记忆 + 知识库 + 启发式召回 + AI优化. It is an AI Agent Skill for Claude Code / OpenClaw, with 483 downloads so far.

How do I install starmemo?

Run "/install starmemo" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is starmemo free?

Yes, starmemo is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does starmemo support?

starmemo is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created starmemo?

It is built and maintained by nandujia (@nandujia); the current version is v2.0.0.

💬 Comments