Offlyn Clipper
/install offlyn-clipper
Offlyn Clipper
Connect OpenClaw to Offlyn Clipper on this Mac (local MCP, no cloud). You can search saved notes and recap the live meeting Clipper is recording right now.
Critical rules (read first)
- Never tell the user that live meeting / catch-up is “not in your skill list” or unavailable. That is wrong.
- When the user says catch me up, live meeting, current meeting, what did I miss, or recap the call → call
clipper_catch_me_upimmediately. Do not answer fromclipper_search_notes(that is old saved notes, not the live call). - If unsure which Clipper action fits → call
clipper_list_chat_presetsand offer 2–4 suggestion chips from the response, then run the preset’srecommended_tool. - If
clipper_catch_me_upreturnsno_active_meeting, then say: start or resume recording in Offlyn Clipper (Quick Note / meeting banner), keep Clipper open, and ask again. - Clipper must be running; MCP uses
clipper.sockon this Mac.
bundle-mcp runtime disposed (OpenClaw session stale)
This is an OpenClaw session issue, not Clipper. The MCP tool list was frozen before the clipper bridge was ready.
Recovery (in order):
- Call
clipper_ping— if it works, the bridge is fine; the chat session is stale. - Tell the user:
openclaw gateway restart, then/new(new chat). SIGUSR1 alone does not refresh tools in the current thread. - There is no
openclaw mcp reloadon all versions — do not suggest it. - After
/new, retryclipper_catch_me_upfor live meeting questions.
Verify from Terminal:
node "{baseDir}/mcp-bridge/verify.mjs"
MCP tools (via server clipper)
| Tool | When to call |
|---|---|
clipper_catch_me_up |
Live call recap — catch me up, current meeting, what did I miss |
clipper_ping |
Health check + live_meeting_active; use after gateway restart or disposed errors |
clipper_list_chat_presets |
Offer chat chips (same as Clipper in-app); good at start of Clipper-related chat |
clipper_search_notes |
Search saved notes / prior thinking / project context |
clipper_get_note_context |
One note by UUID; use include_raw_body only if user granted raw access |
User can disable any tool in Clipper → Settings → Integrations → Shared with OpenClaw.
Live meeting catch-up flow
User: "catch me up with the live meeting"
→ clipper_catch_me_up
→ summarize recap_context for the user (decisions, topics, action items, open questions)
Optional first step: clipper_list_chat_presets when session_context is live_meeting — presets include Catch me up, What did I miss, etc.
One-time setup
- Launch Offlyn Clipper and leave it running.
- Run:
bash "{baseDir}/scripts/setup.sh"
- Approve Allow when Clipper asks to connect OpenClaw.
- Verify:
openclaw mcp show clipper
openclaw skills info offlyn-clipper
- Test live recap (while Clipper is recording a meeting):
openclaw agent --message "Catch me up on my current Clipper meeting"
If tools are missing after an upgrade, re-run:
bash "{baseDir}/scripts/update-installed-skill.sh"
openclaw gateway restart
Install / refresh this skill
openclaw skills install ./OpenClawPlugin/skills/offlyn-clipper --global
bash OpenClawPlugin/skills/offlyn-clipper/scripts/update-installed-skill.sh
Then start a new OpenClaw session (/new) or openclaw gateway restart.
Troubleshooting
| Issue | Action |
|---|---|
| Agent says live meeting not available | Skill description stale — run update-installed-skill.sh, /new session |
no_active_meeting |
Start recording in Clipper, then retry clipper_catch_me_up |
tool_disabled |
Enable tool in Clipper → Integrations → Shared with OpenClaw |
| Socket refused | Clipper not running — open app, re-run setup.sh |
| Pairing denied | node "{baseDir}/mcp-bridge/pair.mjs" and Allow in Clipper |
Architecture
OpenClaw → MCP stdio ({baseDir}/mcp-bridge/index.mjs) → clipper.sock → Clipper
Credentials: ~/.config/offlyn-clipper/openclaw-credentials.json
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install offlyn-clipper - 安装完成后,直接呼叫该 Skill 的名称或使用
/offlyn-clipper触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
Offlyn Clipper 是什么?
Use when the user mentions Offlyn Clipper, Clipper notes, meetings, voice notes, live meeting, current meeting, catch me up, catch-up, what did I miss, recap... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 52 次。
如何安装 Offlyn Clipper?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install offlyn-clipper」即可一键安装,无需额外配置。
Offlyn Clipper 是免费的吗?
是的,Offlyn Clipper 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Offlyn Clipper 支持哪些平台?
Offlyn Clipper 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(darwin)。
谁开发了 Offlyn Clipper?
由 joelnishanth(@joelnishanth)开发并维护,当前版本 v1.0.0。