paperclip-plugin-slack-socket — Slack over Socket Mode, no public URL required

[0xCVH]

I built a Paperclip plugin that connects Slack over Socket Mode: Paperclip opens an outbound WebSocket to Slack, so there's no public URL, reverse proxy, or inbound webhook endpoint to set up. Handy if you're running Paperclip somewhere that isn't internet-reachable.

What it does

• Agent chat — DM the bot, or @mention it in a channel it's been invited to, to talk to your default agent. Replying in the thread continues the same session without mentioning it again.
• Notifications — issue created, issue done, agent run failed, approval requested. Each is independently toggleable, with optional per-category channel overrides.
• Approvals with buttons — an approval request posts with Approve/Reject buttons; clicking one decides the approval through the REST API and updates the Slack message in place.
• ask_human — agents can pause mid-run and ask a person a question in Slack, either by emoji reaction or a threaded reply. The answer is recorded as a comment on the issue and wakes it back up.
• slack_post_message — agents can post to a channel or DM someone, restricted to allowlists the operator configures. Ships off by default: a master switch, per-mode switches, and the allowlists all start empty, and an empty allowlist authorizes nothing.
• /paperclip issue <title> — create an issue from Slack, with an ephemeral confirmation link.

Install

paperclipai plugin install paperclip-plugin-slack-socket

or enter paperclip-plugin-slack-socket under Settings → Plugins → Install, or POST /api/plugins/install with {"packageName": "paperclip-plugin-slack-socket"}.

Then create two secrets in Settings → Secrets — the bot token (xoxb-…) and an app-level token (xapp-…) with the connections:write scope — and fill in your company ID, default agent ID, and default channel ID in the plugin's settings. The repo includes a Slack app manifest you can paste into "Create New App → From an app manifest" to get the right scopes, events, interactivity, and slash command in one step.

One gotcha worth flagging: press Save before Test Connection the first time. Secret access is authorized from saved config rows, so Test Connection can't resolve your tokens until you've saved once.

Links

• Source: https://github.com/0xCVH/paperclip-plugin-slack-socket
• npm: https://www.npmjs.com/package/paperclip-plugin-slack-socket

Built against the published plugin SDK. Bug reports welcome on the repo — happy to hear how it goes for anyone who tries it.