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:

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

MCP tools (via server clipper)

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

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

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

3. Approve Allow when Clipper asks to connect OpenClaw.
4. Verify:

openclaw mcp show clipper
openclaw skills info offlyn-clipper

5. 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

Architecture

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

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