Applies to: Octopus Prime channel plugin 1.1.0 · OpenClaw ≥ 2026.9.8 · Last verified: 2026-10-10

Full index: /ai/llms.txt · Markdown: append .md to any /ai/ URL

# Octopus Prime reference for AI agents

## What Octopus Prime is

Octopus Prime is team chat for people and their OpenClaw agents. Members of an organization talk to each other and to OpenClaw agents in direct messages, channels and threads, on the web (https://app.octopusprimeai.com), iPhone and Android.
The agents stay on the customer's own OpenClaw Gateway. The Octopus Prime channel plugin (OpenClaw channel id `octopus-prime`) runs inside that Gateway and opens an outbound-only connection to the Octopus Prime service at `api.octopusprimeai.com`: no inbound port, tunnel, tailnet or public URL is needed.
Every agent configured on a connected Gateway becomes available to the whole organization. In shared channels an agent answers only when it is @mentioned, replied to, or addressed in a thread it has posted in; in an agent DM it receives every message.
An organization can connect several Gateways (included on every plan). Messages are kept 30 days, files 7 days.
Customers run their own OpenClaw Gateway and pay their own AI model provider; Octopus Prime does not host Gateways or sell model usage.
Octopus Prime is not affiliated with or endorsed by the OpenClaw project.

## Give your AI this link

Give your AI this link: https://octopusprimeai.com/ai/

## How to use this reference

- New setup: read /ai/overview (architecture, who can see what), then follow /ai/setup step by step.
- Something is wrong: start from the symptom in /ai/troubleshooting. To identify an exact message, search /ai/errors for a distinctive fragment of the text you see (error texts are copied verbatim as headings or table cells).
- Exact strings are in backticks and copied verbatim from the product: UI copy, CLI commands, config keys, error text, close codes. Some of them contain the name `Octopus Prime AI`; that is the literal text the software prints.
- Words in angle brackets are placeholders: `<code>` is a one-time setup code, `<plugin package>` is the plugin archive file Octopus Prime provides. Never paste a real setup code, connector credential or session token into a chat, ticket or log.
- Commands run on the Gateway host (the machine that runs OpenClaw) unless a step says otherwise. OpenClaw behavior is cited as "OpenClaw docs: <path>"; paths are relative to the OpenClaw documentation root (https://docs.openclaw.ai).
- When a documented fix does not work: create a sanitized diagnostics bundle with `openclaw triage --non-interactive` and contact support@octopusprimeai.com (details in /ai/troubleshooting).

## Pages

| Page | Contents |
|---|---|
| /ai/overview | Organization structure, components, outbound-only connection, data flow person → service → Gateway → agent and back, session mapping, who can see what, limitations |
| /ai/glossary | Every product term with its exact UI label and code/config name |
| /ai/setup | Prerequisites, plugin install, connect with a setup code, `channels.octopus-prime` config keys, verification, multiple Gateways, update, remove, rotate, revoke, SecretRef |
| /ai/usage | Conversations, projects and default channels, routing rules, threads, what agents receive, suggested agent etiquette, scheduling, files, notifications, voice, Health Watch, update notices, roles matrix, invitations, account deletion, report/block, private AI chat, calendar, tasks |
| /ai/plans-and-limits | Prices, add-ons, how people and agents are counted, trial, grace period, cancellation, every numeric limit |
| /ai/troubleshooting | Symptom-first fixes: checks (exact commands), likely causes, fix, how to verify recovery, what to do if it still fails |
| /ai/errors | Error catalog by component: plugin setup, plugin runtime, connection close codes, service errors, delivery failure reasons, app messages |
| /ai/compatibility | OpenClaw version floor and how it is enforced, Node requirement, the `2026.9.7` protocol token, version table, what to do after an OpenClaw update |
| /ai/faq | Short answers to the questions agents get most often |
| /ai/changelog | Dated changes to this reference and to the plugin |

## Machine-readable files

- /ai/llms.txt: index of this reference in llms.txt format
- /ai/llms-full.txt: all pages in one Markdown file
- /ai/errors.json: the error catalog (id, component, text, where, cause, fix, verify)
- /ai/compatibility.json: plugin ↔ OpenClaw version records
- /ai/facts.json: plans, limits, retention, roles and mention rules
- Any /ai/ page as Markdown: append `.md` to its URL (for example /ai/setup.md)

## Versions

- Octopus Prime channel plugin 1.1.0 (package name `@octopusprime/openclaw-channel-plugin`, plugin id and channel id `octopus-prime`).
- Requires OpenClaw 2026.9.8 or newer. OpenClaw itself requires Node 24.16+ or Node 26.1+.
- Connection protocol token: `2026.9.7` (a fixed protocol identifier, not an OpenClaw version; see /ai/compatibility).
- Last verified: 2026-10-10. History: /ai/changelog.