Offlyn Clipper

将 OpenClaw 连接到本机 Mac 上的 Offlyn Clipper（本地 MCP，不涉及云端）。您可搜索已保存的笔记，同时回顾 Clipper 当前正在录制的实时会议。

关键规则（请先阅读）

1. 切勿告知用户“实时会议 / 补充信息”不在您的能力范围内或不可用——该说法错误。
2. 当用户说 catch me up、live meeting、current meeting、what did I miss 或 recap the call 时 → 立即调用 clipper_catch_me_up。不得使用 clipper_search_notes 的结果作答（该工具仅返回历史保存的笔记，而非当前实时会议）。
3. 若不确定应调用哪个 Clipper 动作 → 先调用 clipper_list_chat_presets，从返回结果中选取 2–4 个建议卡片（suggestion chips）提供给用户，然后执行该预设对应的 recommended_tool。
4. 若 clipper_catch_me_up 返回 no_active_meeting，则提示用户：在 Offlyn Clipper 中启动或恢复录制（通过快速笔记 / 会议横幅），保持 Clipper 应用处于打开状态，再重新提问。
5. Clipper 必须处于运行中状态；MCP 通过本机的 clipper.sock 与之通信。

bundle-mcp runtime disposed（OpenClaw 会话已过期）

这是OpenClaw 会话问题，而非 Clipper 本身的问题。MCP 工具列表在 clipper 桥接器就绪前已被冻结。

恢复步骤（请严格按顺序执行）：

1. 调用 clipper_ping —— 若调用成功，说明桥接器正常，当前聊天会话已过期。
2. 告知用户执行：openclaw gateway restart，随后输入 /new（开启新聊天）。仅发送 SIGUSR1 信号无法刷新当前线程中的工具列表。
3. 所有版本均不支持openclaw mcp reload 命令——请勿建议该操作。
4. 执行 /new 后，对涉及实时会议的问题重试 clipper_catch_me_up。

可通过终端验证：

node "{baseDir}/mcp-bridge/verify.mjs"

MCP 工具（通过 server clipper 提供）

用户可在 Clipper → Settings → Integrations → Shared with OpenClaw 中禁用任意工具。

实时会议补全流程

User: "catch me up with the live meeting"
  → clipper_catch_me_up
  → 为用户摘要 recap_context（含决策项、讨论主题、待办事项、待解问题）

可选前置步骤：当 session_context 为 live_meeting 时，先调用 clipper_list_chat_presets —— 预设中包含 Catch me up、What did I miss 等选项。

一次性初始化设置

1. 启动 Offlyn Clipper 并保持其持续运行。
2. 执行：

bash "{baseDir}/scripts/setup.sh"

3. 当 Clipper 弹出提示请求连接 OpenClaw 时，点击 Allow 授权。
4. 验证配置：

openclaw mcp show clipper
openclaw skills info offlyn-clipper

5. 测试实时回顾功能（需确保 Clipper 正在录制一场会议）：

openclaw agent --message "Catch me up on my current Clipper meeting"

若升级后出现工具缺失，请重新执行：

bash "{baseDir}/scripts/update-installed-skill.sh"
openclaw gateway restart

安装 / 刷新本技能

openclaw skills install ./OpenClawPlugin/skills/offlyn-clipper --global
bash OpenClawPlugin/skills/offlyn-clipper/scripts/update-installed-skill.sh

随后开启一个全新的 OpenClaw 会话（输入 /new），或执行 openclaw gateway restart。

故障排查

架构

OpenClaw → MCP stdio ({baseDir}/mcp-bridge/index.mjs) → clipper.sock → Clipper

凭证文件路径：~/.config/offlyn-clipper/openclaw-credentials.json