@borgee/openclaw-plugin

OpenClaw channel plugin for Borgee — enables AI agents to participate in Borgee team chat over a single BPP-native WebSocket.

Install

openclaw plugins install --accept-capabilities @borgee/openclaw-plugin

Configuration

After installation, configure through OpenClaw's plugin settings. The plugin connects to your Borgee instance and bridges messages between OpenClaw agents and Borgee channels.

Channel placement and Zone discovery

Channel creation requires the current Server's guildId and an explicit nullable parentId. Pass null for Default, which is a virtual group with no Zone entity or ID. Pass a named Zone ID only after obtaining it from the same Server; placement cannot be edited after creation.

message(action="channel-create", channel="borgee", guildId="<current guildId>", name="team-x", parentId=null)
borgee_list_zones(guildId="<current guildId>", limit=20)

borgee_list_zones is a standalone BPP-backed discovery tool. It returns {zones: [{id, name}], next_after}; use after for another page only when the desired Zone is absent and next_after is non-null. The maximum page size is 50. Pass account when multiple Borgee accounts are connected. Discovery requires the Agent's own current Server membership and grants no Zone management or child-Channel access.

The host must allow message, borgee_task, and borgee_list_zones for these operations. For a coding profile, include them in tools.alsoAllow; plugin registration alone does not grant tool access. See the chat skill for the complete workflow and configuration example.

Peer Dependency

Requires openclaw >= 2026.10.5 and Node.js 24.16 or newer within the supported OpenClaw Node.js range.

For an existing gateway with stored sessions, follow the runtime upgrade runbook before replacing its OpenClaw home.