← 返回 Skills 市场
208
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install heycube
功能描述
引导安装 HeyCube 黑方体个人档案管理服务到 OpenClaw。分步配置:设置环境变量、安装 SQLite 工具、安装口令触发 Skill。 用户主动说"安装黑方体"、"配置 HeyCube"、"heycube setup"时触发。
使用说明 (SKILL.md)
HeyCube 黑方体 — 引导安装
交互式引导用户完成配置,每一步需用户确认后才执行。
安装流程
Step 1:设置 API Key
提示用户设置环境变量 HEYCUBE_API_KEY(从 https://heifangti.com 获取)。
Windows PowerShell 永久生效:
[System.Environment]::SetEnvironmentVariable('HEYCUBE_API_KEY', 'hey_xxx', 'User')
Mac/Linux:
echo 'export HEYCUBE_API_KEY=hey_xxx' >> ~/.zshrc
source ~/.zshrc
验证:$env:HEYCUBE_API_KEY(PowerShell)或 echo $HEYCUBE_API_KEY(bash)
Step 2:安装 SQLite 管理工具
- 复制本 skill 的
scripts/personal-db.js→{workspace}/scripts/personal-db.js - 复制本 skill 的
scripts/package.json→{workspace}/scripts/package.json - 运行:
cd "{workspace}/scripts"; npm install; node personal-db.js init
预期输出:{"status":"ok","db":"..."}
Step 3:安装档案 Skill
将以下两个 Skill 复制到 ~/.agents/skills/:
assets/hook-skills/get-config.md→~/.agents/skills/heycube-get-config-0.1.0/SKILL.mdassets/hook-skills/update-data.md→~/.agents/skills/heycube-update-data-0.1.0/SKILL.md
Step 4:修改 TOOLS.md
在 {workspace}/TOOLS.md 追加:
## HeyCube Server
- BASE_URL: https://heifangti.com/api/api/v1/heifangti
- API_KEY: 通过环境变量 HEYCUBE_API_KEY 配置
- DB_PATH: {workspace}/personal-db.sqlite
⚠️ 如果 TOOLS.md 已有 HeyCube 段,只更新缺失部分。
完成输出
✅ HeyCube 黑方体配置完成
- API Key: 已设置环境变量
- SQLite 工具: 已安装并初始化
- 档案 Skill: 已就位
📋 使用方式:
- 说"提取黑方体档案" — 从 API 获取维度配置,查询本地已有档案,注入上下文辅助对话
- 说"存入黑方体档案" — 脱敏总结当前对话,调用黑方体 API ,提取个人数据写入本地档案
- 说"查看黑方体档案" — 查看所有已采集数据
- 说"关闭黑方体" — 临时关闭(创建 .heycube-off)
- 说"开启黑方体" — 重新启用
安全使用建议
What to check before installing:
- Credential provenance: Verify the legitimacy of the HeyCube service and the origin of any API key you will use. Do not reuse sensitive or long-lived credentials from other services.
- Metadata mismatch: The registry metadata did not declare HEYCUBE_API_KEY even though SKILL.md requires it; ask the publisher to fix metadata or refuse until corrected.
- Env/name mismatches: personal-db.js expects SOUL_DB_PATH as an optional env var, but SKILL.md instructs adding DB_PATH in TOOLS.md — ensure the DB path is set correctly to avoid accidental DB creation in an unexpected location.
- Review files before copying: The installation requires copying the two hook SKILL.md files into ~/.agents/skills/ — these will become persistent agent skills. You already have their contents included; review them (they appear to only call the HeyCube API and local SQLite) and only install if you accept that behavior.
- Network traffic & privacy: The skill sends de-identified conversation summaries to https://heifangti.com. Confirm you are comfortable with that and with the service's privacy/security practices. Consider running the setup in an isolated project/workspace if you're unsure.
- Local install safety: npm install pulls better-sqlite3 (native build). Ensure your system can compile it or consider running in a controlled environment (container/VM) first.
- Safer alternatives: If you prefer not to add persistent skills, you can run personal-db.js locally and interact with the API manually, or request the publisher provide clearer metadata and a signed release/homepage.
What would change this assessment:
- If the publisher updated the registry metadata to declare HEYCUBE_API_KEY (and documented DB env var names) and provided a verifiable homepage/repo or signature, confidence would increase to benign.
- Evidence of hidden network calls or obfuscated code would increase severity toward malicious.
功能分析
Type: OpenClaw Skill
Name: heycube
Version: 1.0.0
The skill bundle implements a personal profile management system that interacts with an external API (heifangti.com). It performs high-risk setup actions including modifying shell configuration files (~/.zshrc), setting environment variables, and executing local Node.js scripts (personal-db.js) to manage a SQLite database. While the instructions (SKILL.md, update-data.md) explicitly mandate data desensitization before sending conversation summaries to the external endpoint, the broad permissions required for shell modification and the transmission of user context to a third-party domain represent a significant attack surface.
能力评估
Purpose & Capability
Skill name/description (install HeyCube personal-archive integration) matches the actions in SKILL.md (set API key, install a local SQLite helper, copy two hook-skill files). However the registry metadata declares no required environment variables or config paths while the runtime instructions clearly require an external API key (HEYCUBE_API_KEY) and a DB path in TOOLS.md. This metadata/instruction mismatch is unexpected and incoherent.
Instruction Scope
SKILL.md instructs the agent/user to: set a persistent environment variable (HEYCUBE_API_KEY), run npm install/node scripts in the user's workspace, copy two skill files into the agent's ~/.agents/skills directory, and update TOOLS.md. These steps modify local agent skill state and create persistent files that change agent behavior. The instructions also direct sending de-identified conversation summaries to https://heifangti.com via curl — the data flow is explicit and limited to de-identified summaries, but enforcement of de-identification is procedural (relies on the agent to follow rules), which could be error-prone. Overall the scope is broader than a pure helper (it persists new skills into the agent runtime).
Install Mechanism
There is no formal install spec; the skill is instruction-only but includes a small Node.js script and package.json. The install step is 'npm install' in the workspace, pulling better-sqlite3 from npm (a normal, traceable registry dependency). No external archive downloads or URL shorteners are used. Note: better-sqlite3 may require build tools on the host (native compilation).
Credentials
SKILL.md requires storing HEYCUBE_API_KEY in a persistent environment variable and uses that key in curl X-API-Key header. The registry metadata lists no required env vars — inconsistency. The personal-db.js script reads process.env.SOUL_DB_PATH if set (different name than DB_PATH referenced in TOOLS.md), which is another mismatch that may cause confusion. Aside from the single API key, no other secrets are requested; but the undocumented env var expectation and differing DB env var name are proportionality/clarity issues that should be resolved before use.
Persistence & Privilege
The setup asks the user to copy two new skill files into ~/.agents/skills/, which grants persistent agent capabilities (new triggerable skills). 'always' is false, but installing persistent skill files is a powerful change to agent behavior. The included skill files are present in the package and appear to do what the SKILL.md describes, but adding skills to the agent should be done cautiously and only after reviewing those files (they are included here and appear consistent).
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install heycube - 安装完成后,直接呼叫该 Skill 的名称或使用
/heycube触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
HeyCube 黑方体,你的 AI 记忆管家 —— 为 AI Agent 提供无限的结构化记忆。
• 无限记忆
• 结构化存储
• 本地数据掌控
• 隐私隔离
• 按需加载
让 AI 结构化地理解一个完整的你。
HeyCube 黑方体安装引导功能上线。
- 新 skill heycube-setup 实现分步引导 HeyCube 黑方体个人档案管理服务安装流程
- 包含 API Key 环境变量设置、SQLite 工具部署与初始化、相关 skill 文件复制、TOOLS.md 配置补全
- 每步需用户确认后执行,保证按需配置,无自动跳步
- 增加常用语音/口令触发安装支持
- 配置完成后输出详细指引与常用操作方法
元数据
常见问题
HeyCube AI Memory Butler 是什么?
引导安装 HeyCube 黑方体个人档案管理服务到 OpenClaw。分步配置:设置环境变量、安装 SQLite 工具、安装口令触发 Skill。 用户主动说"安装黑方体"、"配置 HeyCube"、"heycube setup"时触发。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 208 次。
如何安装 HeyCube AI Memory Butler?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install heycube」即可一键安装,无需额外配置。
HeyCube AI Memory Butler 是免费的吗?
是的,HeyCube AI Memory Butler 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
HeyCube AI Memory Butler 支持哪些平台?
HeyCube AI Memory Butler 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 HeyCube AI Memory Butler?
由 MMMMMMTL(@mmmmmmtl)开发并维护,当前版本 v1.0.0。
推荐 Skills