Screenpipe 集成

Screenpipe 记录你计算机上的屏幕文本和音频。 捆绑的 screenpipe 技能可让你从 Claude Code 中回顾该上下文，并将选定的事实保存到 claude-mem，以供未来的会话使用。

设置¶

1. 安装 Screenpipe，授予其录制权限，并让它与 Claude Code 在同一台计算机上运行。
2. 安装 claude-mem 并重启 Claude Code。该技能随插件一起提供；无需额外的 MCP 服务器或软件包。
3. 调用该技能：

/claude-mem:screenpipe Find the release discussion from my meetings this morning.

要保存有用的上下文，请在请求中包含该内容：

/claude-mem:screenpipe Find yesterday's API design discussion and remember the decisions in this project.

该技能会搜索一个有限的时间窗口，汇总匹配的屏幕文本或音频转录（附有来源 ID 和时间戳），并且仅在要求时才保存选定的笔记。保存的笔记使用现有的本地 worker 观察 API，可通过 claude-mem 的记忆搜索工具检索。

Before: claude-mem recalls your agent sessions.
After:  Screenpipe screen/audio search -> selected context -> claude-mem observation

配置与隐私¶

该辅助工具要求 Node.js 20+（claude-mem 已要求）。它默认使用位于 http://127.0.0.1:3030 的 Screenpipe。如需使用其他本地端口，可在智能体的环境中设置 SCREENPIPE_URL；如果 Screenpipe 需要 Bearer 认证，则设置 SCREENPIPE_API_KEY。请勿将 API 密钥放入提示词或命令参数中。

搜索默认针对屏幕文本，每页 20 条结果，并带有明确的时间窗口。会议类查询会请求音频。该辅助工具返回文本和来源元数据，而非截图或音频文件。较长的文本会被标记为已截断。

HTTP 请求会发送到本地服务，但 检索到的文本会进入智能体的对话，并被发送到其配置的 AI 提供商。搜索结果会被包裹在 <private> 中，因此 claude-mem 的自动捕获不会存储它们；只有你要求保存的笔记才会被存储。保存的笔记与 claude-mem 的其他记忆一样存储：保存在本地数据库中；如果开启了云同步，还会保存在你的云账户中。请选择范围较小的主题、应用和时间窗口。

保存操作使用 claude-mem 正在运行的本地 worker，可从 CLAUDE_MEM_WORKER_PORT 或 ~/.claude-mem/settings.json 中找到。这个基础集成不支持托管服务器模式和远程 Screenpipe 实例。它不会启用录制功能，不会定期轮询，也不会批量同步历史记录。

故障排除¶

• 连接失败或超时： 检查 Screenpipe 或 claude-mem worker 是否在配置的地址上运行。该辅助工具会以错误退出；它不会报告空搜索或成功导入。
• HTTP 401/403： 检查 Screenpipe 的 API 密钥设置和 SCREENPIPE_API_KEY。
• 无匹配结果： 确认 Screenpipe 录制了请求的时间区间，并检查时区、内容类型和应用筛选器。
• 未确认的保存： 在重试前保留选定的笔记并检查记忆，因为连接失败可能发生在 worker 已存储该笔记之后。

如需提交支持报告，请包含操作步骤和辅助工具错误；除非你打算共享，否则请省略录制的文本和凭据。