← 返回 Skills 市场
1017
总下载
2
收藏
0
当前安装
2
版本数
在 OpenClaw 中安装
/install sq-memory
功能描述
Enables OpenClaw agents to store, recall, update, list, and forget persistent hierarchical memories across sessions via the SQ protocol.
安全使用建议
What to consider before installing:
- Verify configuration keys: the code and skill.json expect 'api_key' (secret) and 'endpoint' and 'namespace'. SKILL.md sometimes shows 'username'/'password' — confirm which credential your deployment requires before pasting secrets.
- Do NOT store sensitive personal data in memory until you confirm transport security: the implementation encodes stored text into GET query parameters (index.js uses query string &s=...). Query-string writes can be logged by reverse proxies, web servers, or intermediaries. Prefer using an HTTPS endpoint and, if possible, modify the skill to POST data in the request body (or ask the maintainer to fix it) before storing sensitive info.
- Prefer self-hosting for sensitive data: the project advertises a hosted service (mirrorborn.us). If you must store private user data, run your own SQ instance and point the skill at a localhost/HTTPS-protected endpoint.
- Review and test on non-sensitive data: run the included test.js against a local SQ instance first to observe network traffic and behavior.
- Inspect and/or patch the code: trivial changes would improve safety (use POST for updates, avoid including large text in URLs, normalize config key names). If you are not comfortable editing, ask the maintainer to address the GET/query-string issue and the documentation inconsistencies.
- Be cautious about paste-into-system-prompt guidance: examples that suggest altering an agent's system prompt can increase the privilege of user-provided content — don't paste untrusted docs into privileged system prompts.
If you want, I can point out the exact lines to change to stop sending text in URLs and to normalize config keys.
功能分析
Type: OpenClaw Skill
Name: sq-memory
Version: 1.0.1
The OpenClaw SQ Memory skill provides persistent storage for agents by interacting with an external SQ service. The core logic in `index.js` correctly uses `encodeURIComponent` for all user-controlled inputs (coordinates, text, namespace) before constructing API requests, effectively preventing URL injection and other command injection vulnerabilities. The skill uses only built-in Node.js `http` and `https` modules, minimizing supply chain risk. Documentation and example files are clear, align with the stated purpose, and contain no evidence of prompt injection attempts against the agent or other malicious instructions. The network access and data storage capabilities are inherent to the skill's function and are implemented securely.
能力评估
Purpose & Capability
The skill implements persistent memory (remember/recall/forget/list) and the included code matches that purpose. However, the package metadata, SKILL.md, and examples contain inconsistent configuration keys (SKILL.md sometimes shows username/password; skill.json and code expect api_key/api_key or config.api_key) and the top-level registry metadata listed no required env vars while skill.json declares an api_key config. These mismatches are sloppy and could confuse users when configuring credentials.
Instruction Scope
Runtime instructions stay within the memory feature (store/recall/delete/list), but the implementation sends stored text as URL query parameters on GET requests (see index.js: update/select endpoints include the stored text encoded into the URL). That risks leakage to logs, proxies, or browser history. SKILL.md does not warn about this. Also the SKILL.md contains phrasing about adding items to an agent's system prompt and the pre-scan flagged a 'system-prompt-override' pattern — while the file's examples are normal, treat any instructions that encourage modifying system prompts with special caution.
Install Mechanism
No package install spec is present (instruction-only install via git or npx clawhub), and all code is bundled in the skill. There are no external arbitrary downloads in an install step. Manual install instructions are standard (git clone, npm install).
Credentials
The skill legitimately needs an SQ endpoint and (optionally) an API key. That is proportionate. However, documentation inconsistently references 'username'/'password' vs 'api_key', and the registry metadata at the top claimed 'Required env vars: none' despite the manifest declaring an api_key config (secret). These inconsistencies increase the risk users will misconfigure credentials or accidentally expose secrets.
Persistence & Privilege
The skill does not request always:true or system-wide privileges. It registers normal tools (remember/recall/etc.) and does not modify other skills or agent configs. Autonomous invocation is allowed (default) but not combined with problematic privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install sq-memory - 安装完成后,直接呼叫该 Skill 的名称或使用
/sq-memory触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.1
- Replaced LICENSE.md with LICENSE for standard naming.
- Updated installation instructions in documentation to use the new `npx clawhub install sq-memory` method.
- Configuration examples now recommend using `http://localhost:1337` as the default endpoint.
- Adjusted self-hosted and hosted setup steps in the documentation for clarity.
- Minor edits for documentation consistency and updated tool/feature naming.
v1.0.0
- Initial release introducing persistent memory for OpenClaw agents via SQ integration.
- Enables agents to remember user preferences, conversation history, and shared data across sessions.
- Includes functions: remember, recall, forget, and list_memories for flexible memory management.
- Supports hierarchical 11D coordinate storage, namespace isolation, and multi-agent collaboration.
- Provides both free self-hosting and paid hosted service options.
- Comprehensive installation, configuration, and usage documentation included.
元数据
常见问题
SQ Memory 是什么?
Enables OpenClaw agents to store, recall, update, list, and forget persistent hierarchical memories across sessions via the SQ protocol. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 1017 次。
如何安装 SQ Memory?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install sq-memory」即可一键安装,无需额外配置。
SQ Memory 是免费的吗?
是的,SQ Memory 完全免费(开源免费),可自由下载、安装和使用。
SQ Memory 支持哪些平台?
SQ Memory 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 SQ Memory?
由 wbic16(@wbic16)开发并维护,当前版本 v1.0.1。
推荐 Skills