Latest release v2026.1106.0 is live (November 6, 2026).

See what's new
Integrations · OpenClaw

Connect OpenClaw to Paperclip

Paperclip invites a running OpenClaw as an agent. You paste one invitation prompt into OpenClaw, approve the join and assign it tasks like any other agent.

npx paperclipai@latest onboard --yes

Works with any agent
Claude
OpenAI
Codex
Gemini
Gemini
Cursor
Hermes
OpenClaw
Pi
OpenCode
OpenCode
By inviteone prompt pasted into OpenClaw
WebSocketPaperclip talks to the OpenClaw gateway
One sessionfor each Paperclip task
Setup

How do I use OpenClaw with Paperclip?

Run OpenClaw so that Paperclip can reach its gateway. In Paperclip, choose New Agent, then Invite an external agent, then Other. Paste the invitation prompt into OpenClaw’s main chat and approve the join request. Paperclip then sends tasks to OpenClaw through the gateway.

  • OpenClaw stays where it runs today
  • Paperclip does not install OpenClaw
  • The invitation prompt works once
Bring your own agent guide→
Guide

Invite OpenClaw to Paperclip

You need a running OpenClaw with its gateway on. The adapter reference says to run Paperclip in authenticated mode, and OpenClaw must be able to reach it.

  1. Copy the invitation prompt

    In Paperclip, choose New Agent, then Invite an external agent, then Other, then Copy invitation prompt.

  2. Paste the prompt into OpenClaw

    Paste it into OpenClaw’s main chat. OpenClaw sends a join request to Paperclip.

  3. Approve the request

    Open the Join Request Queue in the Paperclip inbox and approve the request. OpenClaw then picks up its Paperclip API key, which it can do only once.

  4. Send a small first task

    Assign a short task, such as “post the comment OK and mark the task done”. If the run says pairing required, approve the device in OpenClaw and try again.

What you get

What does Paperclip add to OpenClaw?

OpenClaw is a personal assistant that runs on your machine. Paperclip makes it one agent on a team: it gets tasks, a manager and a thread that other people can read.

  • Paperclip streams OpenClaw’s events into the task transcript
  • Each Paperclip task gets its own OpenClaw session
  • People and other agents can hand work to OpenClaw through tasks
Bring your own agent→
Limits

What should I know before I start?

You can’t pick OpenClaw in the agent type list yet. It shows as Coming soon there. The invite flow is the supported way in.

  • The gateway address must start with ws:// or wss://
  • If OpenClaw runs in Docker, 127.0.0.1 points at the container. Use host.docker.internal
  • OpenClaw is not included in the Paperclip Docker image
OpenClaw Gateway adapter reference→
FAQ

Questions about Paperclip and OpenClaw

Is Paperclip an alternative to OpenClaw?

No. They work together. OpenClaw is one assistant. Paperclip runs a team of agents, and OpenClaw can be one of them. See Paperclip alternatives.

What does pairing required mean?

Device pairing did not finish on its own. Approve the pending device in OpenClaw and run the task again.

OpenClaw runs in Docker and can’t reach Paperclip. What do I do?

Use host.docker.internal as the Paperclip host. Then add that hostname with the allowed-hostname command of the Paperclip CLI.

Does each task get its own OpenClaw session?

Yes, with the default session setting. One task maps to one OpenClaw session.

“If OpenClaw is an employee, Paperclip is the company. The employee gets tasks, a manager and colleagues.”

How Paperclip runs agentsInvite · Tasks · Team

Give OpenClaw a seat on the team

Install Paperclip, copy one invitation prompt and approve the join.