← Back to Skills Marketplace
mmmmmmtl

HeyCube AI Memory Butler

by MMMMMMTL · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
208
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install heycube
Description
引导安装 HeyCube 黑方体个人档案管理服务到 OpenClaw。分步配置:设置环境变量、安装 SQLite 工具、安装口令触发 Skill。 用户主动说"安装黑方体"、"配置 HeyCube"、"heycube setup"时触发。
README (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 管理工具

  1. 复制本 skill 的 scripts/personal-db.js{workspace}/scripts/personal-db.js
  2. 复制本 skill 的 scripts/package.json{workspace}/scripts/package.json
  3. 运行:
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.md
  • assets/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)
- 说"开启黑方体" — 重新启用
Usage Guidance
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.
Capability Analysis
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.
Capability Assessment
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).
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install heycube
  3. After installation, invoke the skill by name or use /heycube
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
HeyCube 黑方体,你的 AI 记忆管家 —— 为 AI Agent 提供无限的结构化记忆。 • 无限记忆 • 结构化存储 • 本地数据掌控 • 隐私隔离 • 按需加载 让 AI 结构化地理解一个完整的你。 HeyCube 黑方体安装引导功能上线。 - 新 skill heycube-setup 实现分步引导 HeyCube 黑方体个人档案管理服务安装流程 - 包含 API Key 环境变量设置、SQLite 工具部署与初始化、相关 skill 文件复制、TOOLS.md 配置补全 - 每步需用户确认后执行,保证按需配置,无自动跳步 - 增加常用语音/口令触发安装支持 - 配置完成后输出详细指引与常用操作方法
Metadata
Slug heycube
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is HeyCube AI Memory Butler?

引导安装 HeyCube 黑方体个人档案管理服务到 OpenClaw。分步配置:设置环境变量、安装 SQLite 工具、安装口令触发 Skill。 用户主动说"安装黑方体"、"配置 HeyCube"、"heycube setup"时触发。 It is an AI Agent Skill for Claude Code / OpenClaw, with 208 downloads so far.

How do I install HeyCube AI Memory Butler?

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

Is HeyCube AI Memory Butler free?

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

Which platforms does HeyCube AI Memory Butler support?

HeyCube AI Memory Butler is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created HeyCube AI Memory Butler?

It is built and maintained by MMMMMMTL (@mmmmmmtl); the current version is v1.0.0.

💬 Comments