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)#

1. Never tell the user that live meeting / catch-up is “not in your skill list” or unavailable. That is wrong.
2. When the user says catch me up, live meeting, current meeting, what did I miss, or recap the call → call clipper_catch_me_up immediately. Do not answer from clipper_search_notes (that is old saved notes, not the live call).
3. If unsure which Clipper action fits → call clipper_list_chat_presets and offer 2–4 suggestion chips from the response, then run the preset’s recommended_tool.
4. If clipper_catch_me_up returns no_active_meeting, then say: start or resume recording in Offlyn Clipper (Quick Note / meeting banner), keep Clipper open, and ask again.
5. Clipper must be running; MCP uses clipper.sock on 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):

1. Call clipper_ping — if it works, the bridge is fine; the chat session is stale.
2. Tell the user: openclaw gateway restart, then /new (new chat). SIGUSR1 alone does not refresh tools in the current thread.
3. There is no openclaw mcp reload on all versions — do not suggest it.
4. After /new, retry clipper_catch_me_up for live meeting questions.

Verify from Terminal:

bash

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

MCP tools (via server clipper)#

ToolWhen to callclipper_catch_me_upLive call recap — catch me up, current meeting, what did I missclipper_pingHealth check + live_meeting_active; use after gateway restart or disposed errorsclipper_list_chat_presetsOffer chat chips (same as Clipper in-app); good at start of Clipper-related chatclipper_search_notesSearch saved notes / prior thinking / project contextclipper_get_note_contextOne 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#

text

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#

1. Launch Offlyn Clipper and leave it running.
2. Run:

bash

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

1. Approve Allow when Clipper asks to connect OpenClaw.
2. Verify:

bash

openclaw mcp show clipper
openclaw skills info offlyn-clipper

1. Test live recap (while Clipper is recording a meeting):

bash

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

If tools are missing after an upgrade, re-run:

bash

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

Install / refresh this skill#

bash

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#

IssueActionAgent says live meeting not availableSkill description stale — run update-installed-skill.sh, /new sessionno_active_meetingStart recording in Clipper, then retry clipper_catch_me_up``tool_disabledEnable tool in Clipper → Integrations → Shared with OpenClawSocket refusedClipper not running — open app, re-run setup.shPairing deniednode "{baseDir}/mcp-bridge/pair.mjs" and Allow in Clipper

Architecture#

text

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

Credentials: ~/.config/offlyn-clipper/openclaw-credentials.json