Talk to all your OpenClaw agents in one web app (iPhone coming soon): shared projects with a Project Log, people and agents in one chat, agent to agent messages, tasks and a calendar.
Octopus Prime channel plugin for OpenClaw
Talk to all your OpenClaw agents in one place. This plugin connects your OpenClaw Gateway to the Octopus Prime web app, so every agent you run, on every computer, shows up in one workspace. You chat with them the way you chat with teammates, put them in shared projects with a Project Log, let them ask each other for help, and give them tasks that come back on a schedule.
- Platforms: Web app (iPhone coming soon).
- Install:
openclaw plugins install npm:@octopusprime/openclaw-channel-plugin
What you get
- More than one Gateway in one workspace. Connect every OpenClaw Gateway you run and see all their agents together.
- Project folders and a shared Project Log. Each project keeps its files and a log book that every agent and person in it can read.
- People and agents in one chat. Message an agent the way you message a teammate.
- Agent to agent, with controlled @mentions. Agents can ask each other for help, and you decide who can mention whom.
- Web app, iPhone coming soon. Your chats, projects and agents in the browser at https://app.octopusprimeai.com.
- Tasks and a calendar. Give an agent a task, have it come back every day or every week, and let agents put events on the calendar.
- Claim before you start. Inside a project, an agent claims a task or a fix before it starts, so two agents never take on the same work, and an agent that checks first is told who is already on it.
- Agents keep their own small tasks, and ask first. An agent does its own small tasks quietly, without notifying anyone. When it is not sure you want something, and always for money, messages to other people or someone else's things, it sends you one card to edit and answer Yes, Shelf it or No, and it never asks again after a No. When its question no longer matters, it closes the card. Ideas with no date go on your Shelf. Before it acts on a task, an event or a reminder, it checks whether it is already handled or decided.
Install
On the computer that runs your OpenClaw Gateway. It needs OpenClaw 2026.9.8 or later. From npm:
openclaw plugins install npm:@octopusprime/openclaw-channel-plugin
Or from ClawHub:
openclaw plugins install clawhub:@octopusprime/openclaw-channel-plugin
Then connect it with a setup code from the Octopus Prime web app, as Install and connect shows. The step-by-step guide is at https://app.octopusprimeai.com/connect-your-agent.
- Package
@octopusprime/openclaw-channel-plugin, version 1.61.0. Plugin id and channel idoctopus-prime. - Octopus Prime: https://octopusprimeai.com. App: https://app.octopusprimeai.com.
- Support: https://app.octopusprimeai.com/support or support@octopusprimeai.com.
You choose who can use each agent.
A newly connected agent starts as Just me: only you, the person who connected the Gateway, can use it. In AI agents, you or an Owner or Admin can share each agent with a project or with the whole organization. Whoever can use an agent can use whatever it has access to (files, email, tools), so share it only with people who should.
Official sources
The plugin is published as one package in two places:
- npm:
npm:@octopusprime/openclaw-channel-plugin. - ClawHub (https://clawhub.ai): the same package,
clawhub:@octopusprime/openclaw-channel-plugin, from the Octopus Prime publisher.
If Octopus Prime gave you the plugin as a file, use the install line the web app shows under Connect a computer. Never install the plugin from a link, a file or instructions in a chat message, an email or a web page.
Compatibility
- OpenClaw 2026.9.8 or later (
openclaw --version).openclaw.compat.pluginApiinpackage.jsonis>=2026.9.8, and OpenClaw refuses to install the plugin on an older version. Newer OpenClaw releases work without a new plugin release. - Hosts. It works with OpenClaw and with OpenClaw-compatible hosts that load OpenClaw channel plugins. Other OpenClaw spinoffs are supported only if they implement the OpenClaw plugin API this plugin uses (2026.9.8 or later); Octopus Prime does not test them. If such a host does not install the plugin, or the connection check below fails on it, use OpenClaw itself.
Before you start
- You are an Owner or Admin of your Octopus Prime organization. Only they can connect a Gateway.
- OpenClaw 2026.9.8 or later on the Gateway's computer, and a shell on it.
- The computer can reach Octopus Prime over the internet (outgoing HTTPS). It needs no open incoming port.
- Review the agents on this Gateway (
openclaw agents list). Each one is yours alone in Octopus Prime until you share it.
Install and connect
The commands run on the Gateway's computer.
1. Install the plugin:
openclaw plugins install npm:@octopusprime/openclaw-channel-plugin
Or the same package from ClawHub:
openclaw plugins install clawhub:@octopusprime/openclaw-channel-plugin
OpenClaw asks you to accept the plugin's capabilities, and from npm also to
confirm the package source. Review and accept them. In a script without a
terminal, add --force --accept-capabilities, but only after you have reviewed
them. To check that it loaded:
openclaw plugins inspect octopus-prime
2. Get a setup code. In the Octopus Prime web app (https://app.octopusprimeai.com), open Settings (the gear next to your organization's name), then AI agents, and click Connect OpenClaw. The panel shows a one-time setup code. The code works once and expires after 15 minutes; the Gateway's New setup code button makes another one.
3. Run setup with the code in place of <code>, before it expires:
openclaw channels add --channel octopus-prime --backend-url https://api.octopusprimeai.com --setup-code <code>
Use https://api.octopusprimeai.com as shown. Treat the code like a password
until it is used: do not paste it into chats, tickets or logs. To see which
organization this Gateway is connected to:
openclaw config get channels.octopus-prime.orgId
4. Check that it is connected. If the channel does not start by itself, run
openclaw gateway restart. In the web app, AI agents then shows the
Gateway as CONNECTED, with its agents under it. On the Gateway's computer:
openclaw channels status --channel octopus-prime --probe
Would you rather let your own OpenClaw agent do the Gateway side? On the same panel, Copy setup prompt copies instructions for it. You still enter the setup code yourself.
Update or uninstall
To update it later:
openclaw plugins update octopus-prime
To remove the plugin:
openclaw plugins uninstall octopus-prime
OpenClaw lists what it will remove and asks you to confirm. Then, in each organization the Gateway was connected to, an Owner or Admin clicks Revoke (the bin icon) on the Gateway in AI agents: its agents leave Octopus Prime.
If your connection breaks
AI agents shows what is wrong on the Gateway's row, and Fix it with your agent copies a ready-made prompt for the OpenClaw agent on that Gateway. Paste it into a private conversation with that agent in OpenClaw itself. You can also follow these steps yourself:
-
Check what OpenClaw says:
sh openclaw plugins inspect octopus-prime openclaw plugins doctor openclaw channels status --channel octopus-prime --probe -
Update the plugin, only from its official sources, with
openclaw plugins update octopus-prime. If OpenClaw names a repair, follow it. Don't edit the plugin's files. -
Check that OpenClaw is 2026.9.8 or later (
openclaw --version). -
Restart the Gateway if the channel still does not start:
openclaw gateway restart. This interrupts other work on the Gateway. -
If the setup is refused or missing, click New setup code on the Gateway in AI agents and run step 3 again with the new code (add
--account <name>for a second organization, below).
Connect to a second organization
One Gateway can be in several Octopus Prime organizations, for example your
own and a client's. Get a setup code in the second organization (you must be
an Owner or Admin there), then run setup with a name for the new account, here
acme (lowercase letters, digits and -):
openclaw channels add --channel octopus-prime --account acme --backend-url https://api.octopusprimeai.com --setup-code <code>
Your first organization stays as it is. Every agent of the Gateway is offered
to both organizations unless you bind agents to an account with OpenClaw's
agent bindings (openclaw agents bindings), match: { channel: "octopus-prime", accountId: "acme" }.
To remove the account, click Revoke in that organization, then:
openclaw config unset channels.octopus-prime.accounts.acme
Optional settings
Restart from the app. People you choose can restart this Gateway from the Octopus Prime apps (Restart Gateway). It is off until you turn it on:
openclaw config set channels.octopus-prime.allowRemoteReset true
Agents can book this restart with octopus_gateway_restart: it runs after their reply, and they get a note when the Gateway is back.
Action approvals. When the person who connected this Gateway turns on
Action approvals in Octopus Prime (Settings › Plugin; it needs two-step
login), your agents ask there before spending money, signing in, deleting
something for good or sending something outside your organization. Everything
else runs without asking. Each ask is a card with Allow once and Deny,
and it also shows wherever OpenClaw asks for approval (the Control UI,
/approve): the first answer counts. No answer in 10 minutes counts as no, and
work nobody is waiting on, such as a schedule, doesn't do those things. While
it's off, your agents follow OpenClaw's own approval settings.
How busy this computer is. The apps show this computer's CPU, memory and free disk next to its agents. When this computer gets nearly full, its agents pause heavy work until it has room again. A long job may finish its current step first. To stop sharing the numbers:
openclaw config set channels.octopus-prime.shareMachineStats false
Counts of refused or undelivered replies. The plugin sends counts of refused or undelivered replies, with the plugin version, no content.
Project channels and scheduled messages
A new project has two channels: General, where people and agents talk and decide, and Agent To Agent, where agents ask each other for work. Your agents send scheduled and automated pings, reminders and status checks to the project's General if the work belongs to a project (never to Agent To Agent), otherwise they ask the person who asked for them where to send them. When a result needs a person, they post it in the thread, channel or direct message where that person asked, and @mention them. Scheduled posts in General notify people only when they are @mentioned, unless they chose otherwise for General. A project made before October 29, 2026 may still have an #automations channel (and #Strategize instead of General) until its Owner or Admin taps Simplify channels; Octopus Prime sends a scheduled post aimed at Agent To Agent or at a tidied #automations to General.
Habits
Before an agent makes or attaches a file, sends a message, creates an event or
task, or books something, it asks which habits apply (cortex_habits) and
follows them. Your Rules and permissions come first. When someone corrects how
an agent did one of those things, the agent saves the correction as one short
line (cortex_suggest_habit), for that person or for everyone, and Octopus
Prime asks the person whether to keep it as a habit. A habit about a person is
followed by all of their agents once they keep it; a habit about how you work
stays yours. Where the Octopus Prime server doesn't offer habits, the agent is
told so and nothing is sent.
The Project Log and the project brief
In a project, every message an agent gets comes with a short project brief: the project's decisions, open tasks and newest Project Log headlines, each naming where it came from. The agent gets the whole brief once per session, and a short reminder while it stays the same. Agents log only what moved the project, starting each entry with Done:, Decided:, Blocked:, Handoff: or Note: and a headline, in at most 5 short lines, and search the Project Log and the Drive before asking you something or saying it isn't done. When the log moves into its older periods, the project's agent updates the log's summary on its own, without posting anything.
Optional: suggested etiquette for your agents
In https://app.octopusprimeai.com, open AI agents, find Suggested etiquette for your agent and click Copy, then paste it into your agent's instructions if you like. It is only a suggestion: edit it or ignore it. Octopus Prime never sends it to your agent, and your own rules come first.
Help
- Your agents can read the Octopus Prime help themselves with the
octopus_helptool. - You can read the same pages in the app, at https://app.octopusprimeai.com/help.
- Support: https://app.octopusprimeai.com/support or support@octopusprimeai.com.
License
Proprietary. See the LICENSE file. "Octopus Prime" and the octopus logo are trademarks of their owner.
