1. 基本信息
| 项目 | 内容 | 数据来源 |
|---|---|---|
| 名称 | supermemory（子目录名；项目自述名称：README 标题为 “Supermemory Claude Skill”，与正式名称不一致，特此记录） | GitHub API / 官方 README |
| 作者/维护者 | supermemoryai（Supermemory 团队） | GitHub API |
| 来源链接 | https://github.com/supermemoryai/supermemory/tree/main/skills/supermemory | — |
| 许可证 | MIT License（skill 子目录内含独立 LICENSE 文件） | GitHub API |
| GitHub Stars | 28,388（注：该数字属 supermemory 主项目整体，不代表本 skill 子目录自身的独立热度） | GitHub API |
| Forks | 2,472 | GitHub API |
| 最新版本 | 仓库 Release：server-v0.0.5（2026-07-10 发布）；配套 SDK：npm supermemory@4.24.12 |
GitHub Release API / npm Registry |
| 安装方式 | 复制 skill 目录 + 安装对应 SDK（npm install supermemory 或 pip install supermemory），见第 10 章 |
官方 SKILL.md |
2. 功能介绍与亮点
Supermemory 是一套为 AI Agent 提供长期/短期记忆与上下文管理的基础设施，本 skill 教 Claude 如何在项目中接入它：
- Memory API：从对话中自动抽取事实、处理知识更新与时效变化，维护记忆间的关联关系。
- User Profiles：静态信息（姓名、偏好）与动态信息（近期活动）合并成用户画像，用于个性化响应。
- RAG 语义检索：支持文本、PDF、图片、视频、URL 等多模态内容的元数据过滤与图谱化关联检索。
- 提供 TypeScript/Python 双 SDK，并原生集成 Vercel AI SDK、LangChain、CrewAI、OpenAI SDK 等主流框架。
- 参考文档结构完整：quickstart、SDK 指南、API 参考、架构说明、用例集五份独立文档。
亮点：主仓库 2.8 万+ star、2,472 fork，MIT 开源可审计；查询当日（2026-07-15）主分支仍有提交，5 天前刚发布新版本，维护节奏非常活跃。
3. 适用场景
所属分类：元技能与 Agent 增强
适合需要让 Claude Code 等 Agent 跨会话记住用户偏好、历史交互内容的开发者；适合构建个性化聊天机器人/助手的团队；适合知识密集型应用（需要对 PDF、图片、视频等多模态资料做语义检索）的场景；也适合多 Agent 协作系统中需要共享记忆层的团队。
4. 跨 Agent 兼容性
- Claude Code：原生支持——skill 采用标准 SKILL.md（frontmatter + Markdown）格式，是 Claude Skills 机制的原生产物；已验证的社区讨论中，作者方也将其描述为“可作为 Claude Code Skill 直接接入的共享记忆层”。
- Codex：未验证——已抓取材料未提及 Codex 专门适配。
- OpenClaw：未验证——同上，未见相关材料。
- Hermes Agent：未验证——同上，未见相关材料。
5. 推荐理由
当前多数 Agent 缺少跨会话的长期记忆能力，每次新会话都要重新建立上下文。Supermemory 以标准 Skill 形式提供了可即插即用的记忆基础设施——涵盖事实抽取、用户画像、多模态语义检索三块能力，且文档体系完整、多 SDK 支持、主流 Agent 框架均可直接集成。项目开源可审计，维护节奏在同类记忆层方案中居前列，也是该方向上社区公认度最高的开源项目之一。
6. 评分
| 维度 | 分数 | 说明 |
|---|---|---|
| 受欢迎程度 | 9 | 28,388 stars；Hacker News Show HN 帖与独立评测博客均有实际讨论，市场关注度高 |
| 可用性 | 8 | SDK 一行安装，文档体系完整（quickstart/SDK/API/架构/用例五份），近日仍在维护；需注册获取 API Key，存在免费额度（约 $5/月）与付费 Pro 计划（$19/月起），非完全零成本 |
| 安全性 | 8 | 见下方安全检查清单 |
| 综合 | 8.3 | 三项均值 |
安全检查清单：
- shell 执行权限：skill 本身不涉及任何 shell 命令，仅通过 SDK 调用 API，风险面小。
- 联网外发：会将对话内容/待记忆信息发送至 Supermemory 云端 API，这是产品核心功能，SKILL.md 与官方文档均清楚披露，非隐蔽外发。
- API Key/凭据：需在 console.supermemory.ai 注册获取，通过环境变量
SUPERMEMORY_API_KEY注入，存储方式明确、未见硬编码。 - 可疑指令排查：已逐行审阅 SKILL.md 与 README 原文，“何时使用本 skill”一节措辞（建议 Claude 在用户需要记忆/个性化场景时推荐本产品）与其他厂商自维护 skill（如官方 SDK 类技能）的“触发说明”写法一致，未发现越权指令或提示注入迹象。
- 作者信誉：supermemoryai 为有一定知名度的 AI 基础设施团队，主仓库 2.8 万+ star、MIT 协议、版本发布记录公开可查。
- License：MIT，明确。
- 维护时间：查询当日主分支仍有提交，5 天前发布新版本，非弃置项目。
代码执行面极小、外发目的透明、凭据处理规范，故评 8 分；未给更高分是因为记忆内容需发送至云端，存在固有的数据外发面。
7. 跟同类 Skills 相比的优势
| 项目 | 核心定位 | 架构 | Star 数 | 付费依赖 |
|---|---|---|---|---|
| supermemory | 云端托管的记忆/上下文基础设施，多模态语义检索 | 云端 API + 知识图谱 | 28,388（主仓库） | 有免费额度，重度/团队使用需 Pro 起（$19/月） |
| claude-memory-skill（hanfang） | 轻量本地记忆方案，不依赖外部服务 | 本地文件系统 | 38 | 无 |
差异化核心：supermemory 面向需要跨设备、跨团队共享记忆，且能接受云端托管数据的场景，换来更强的语义检索与多模态能力；本地文件类方案更适合个人使用、离线优先、不接受向第三方发送数据的场景。选择时应优先考虑数据隐私边界与是否需要团队共享。
8. 用户评价
- Adventures in Claude 博客作者（adventuresinclaude.ai，2026-02-17 评测文章，已验证抓取）：认可其语义搜索与团队记忆能力解决了真实问题，但因供应商依赖与订阅费用（$19/月）最终选择不采用，原话：“I’m not going to use Supermemory. The current system works.”
- HN 用户 saberience（news.ycombinator.com/item?id=46426624，已验证抓取）：对该类记忆层创业公司持怀疑态度：“Do we really need another vibe-coded LLM context/memory startup?”
- HN 用户 ramoz（同一讨论串，已验证抓取）：对基于上下文窗口的抽象方案持保留态度：“I struggle with these abstractions over context windows, esp when anthropic is actively focused on improving things like compaction.”
以上三条来自公开可查的具名来源，正反两方观点均已呈现。
9. 其他补充
集成生态覆盖 Vercel AI SDK、LangChain、CrewAI、OpenAI SDK 等主流框架；提供 TypeScript/Python 双语言 SDK；官方在 npm 与 PyPI 均有独立发布的客户端包，版本迭代与主仓库同步。
10. 安装使用方式
方式一：直接复制 skill 目录到项目
git clone https://github.com/supermemoryai/supermemory.git
cp -r supermemory/skills/supermemory ~/.claude/skills/方式二：安装配套 SDK（skill 内代码示例依赖）
npm install supermemory # TypeScript/JavaScript
pip install supermemory # Python配置 API Key（需先在 console.supermemory.ai 注册）：
export SUPERMEMORY_API_KEY="your_key"安装后注意：需重新加载/重启 Claude Code 会话使新 skill 生效（Claude Skills 通用约定，本 skill 文档未专门说明）；免费额度约 $5/月，超出后需升级付费计划。
11. 注意事项
- 需要向 Supermemory 云端发送对话/记忆内容，对数据隐私或合规要求较高的场景（如企业私有代码库）需自行评估是否可接受；Hacker News 讨论中已有开发者明确表示此类工具“必须本地化”。
- 免费额度有限（约 $5/月），团队或重度使用需升级 Pro 及以上付费计划（$19/月起）。
- 目前仅验证与 Claude Code 的原生兼容性，Codex、OpenClaw、Hermes Agent 暂未验证，如需在这些平台使用建议先小范围测试。
- 记忆/上下文管理赛道竞品较多，选型前建议结合自身数据隐私与预算需求横向比较。