Paperclip Gateway Adapter
Paperclip AI adapter for OpenClaw Gateway protocol. Bridge between Paperclip and OpenClaw.
Tags: integration, adapter, tool
Use Cases
- Orchestrating multiple OpenClaw agents as a team with defined roles (CEO, CTO, researcher, marketer)
- Budget-controlled AI operations with per-agent monthly spend limits
- Autonomous business operations running 24/7 with human oversight via dashboard
- Multi-agent coding workflows where Paperclip coordinates and OpenClaw executes
- Cost monitoring and audit trails across a fleet of AI agents
Tips
- Start with a single OpenClaw gateway before scaling to multiple agents in Paperclip
- Use Paperclip's budget enforcement to prevent runaway costs across your agent fleet
- Check the Paperclip releases page for adapter-specific changelogs — they're bundled with main releases
- For development, run both Paperclip and OpenClaw locally before deploying to separate servers
- Use Paperclip's audit log to trace which OpenClaw agent performed which actions
- Set up heartbeat schedules in Paperclip for recurring agent tasks rather than OpenClaw's built-in cron
- Join the Paperclip Discord for community support — it's more active than GitHub issues for troubleshooting
Known Issues & Gotchas
- The adapter is part of the Paperclip monorepo — you install it through Paperclip, not directly into OpenClaw
- Earlier versions used a 'legacy adapter' pattern that has been replaced by the gateway-only flow
- Device-key pairing must be completed before the adapter can communicate with OpenClaw
- Budget enforcement is a Paperclip feature — the adapter itself doesn't track costs
- If Paperclip and OpenClaw are on different machines, ensure WebSocket ports are accessible
- Model selection happens in Paperclip's agent config, not in OpenClaw — this can cause confusion
- The adapter streams responses via SSE — ensure your reverse proxy supports long-lived connections
Alternatives
- OpenClaw built-in multi-agent (sub-agents)
- CrewAI
- AutoGen
Community Feedback
Have been using Paperclip for the past few days and I'm really impressed. It still has a long way to go, but definitely recommend trying it.
— Twitter (@Flynnjamm)
This project is about a week old and has 14k stars on GitHub already. They call it an 'Open-source orchestration for zero-human companies'. What do you think?
— Reddit r/openclaw
I wanted to use Paperclip with OpenClaw but you have to choose a specific model — the gateway integration isn't available yet.
— Facebook OpenClaw Users
OpenClaw gateway adapter — A new gateway-only OpenClaw flow replaces the legacy adapter. It uses strict SSE streaming, supports device-key pairing.
— OpenClaw Discord
Frequently Asked Questions
What is Paperclip and how does it relate to OpenClaw?
Paperclip is an open-source platform for running 'zero-human companies' — it orchestrates teams of AI agents with org charts, budgets, and governance. OpenClaw serves as the agent runtime, while Paperclip is the management layer that coordinates multiple agents toward business goals.
Do I need Paperclip to use this adapter?
Yes. The adapter is specifically designed to bridge Paperclip's orchestration layer with OpenClaw gateways. Without Paperclip, there's nothing for the adapter to connect. If you just want OpenClaw, you don't need this plugin.
Why is the version number a date (2026.318.0)?
Paperclip uses calendar-based versioning (CalVer) where the version reflects the release date. 2026.318.0 means it was released around March 18, 2026. This is common in rapidly-iterating projects where semver minor/patch numbers would climb very fast.
Can Paperclip work with agents other than OpenClaw?
Yes. Paperclip's tagline is 'if it can receive a heartbeat, it's hired.' It supports OpenClaw, Codex, Claude Code, Cursor, and potentially any agent that can receive task instructions. The OpenClaw adapter is just one of several runtime bridges.
Is the gateway integration fully working?
The latest adapter (2026.318.0) uses a new gateway-only flow with strict SSE streaming and device-key pairing. Earlier community reports noted it wasn't available yet, but the current release appears functional. Check the Paperclip Discord for real-time status.
How does budget enforcement work across OpenClaw agents?
Budget enforcement is handled by Paperclip, not OpenClaw. Paperclip tracks token usage per agent and pauses agents when they hit their monthly budget limit. The adapter reports usage back to Paperclip for tracking, but OpenClaw itself has no budget awareness.
Configuration Examples
Basic Paperclip + OpenClaw setup
# In Paperclip's docker-compose.yml:
services:
paperclip:
image: paperclipai/paperclip:latest
ports:
- "3000:3000"
environment:
- OPENCLAW_GATEWAY_URL=ws://openclaw:18789
- OPENCLAW_GATEWAY_TOKEN=your-token
openclaw:
image: openclaw/openclaw:latest
ports:
- "18789:18789"Multi-agent company setup
# Paperclip agent configuration:
agents:
ceo:
runtime: openclaw
gateway: ws://localhost:18789
role: CEO
budget: { monthly: 100 }
engineer:
runtime: openclaw
gateway: ws://localhost:18789
role: Engineer
budget: { monthly: 200 }
agentId: coderInstallation
openclaw plugins install @paperclipai/adapter-openclaw-gateway