mirror of https://github.com/openclaw/openclaw.git synced 2026-08-03 20:15:56 +00:00

History

xingzhou cc48aef143 fix(beam): prevent mirror retries from stalling on slow responses (#116174 ) * fix(beam): release mirror upload responses * test(beam): cover response cancellation failures * fix(buzz): repair typing indicator contracts --------- Co-authored-by: Vincent Koc <vincentkoc@ieee.org>		2026-07-30 11:33:22 +08:00
..
src	fix(beam): prevent mirror retries from stalling on slow responses (#116174 )	2026-07-30 11:33:22 +08:00
api.ts
channel-plugin-api.ts
index.ts
npm-shrinkwrap.json
openclaw.plugin.json	fix: complete Buzz channel contracts	2026-07-26 14:09:23 +01:00
package.json	feat: preserve Markdown in Buzz messages	2026-07-29 23:07:22 +01:00
README.md	docs(buzz): shorten plugin readme (#114156 )	2026-07-26 14:21:36 -05:00
runtime-api.ts
secret-contract-api.ts
setup-entry.ts
setup-plugin-api.ts
tsconfig.json

README.md

@openclaw/buzz

Official Buzz channel plugin for OpenClaw. It connects an OpenClaw agent to approved Buzz rooms for text conversations and threaded replies.

Requirements

You need:

A Buzz relay URL
A Buzz owner or admin
A room where the bot can receive the Bot role

Use wss:// outside local development.

Set up

openclaw channels add --channel buzz

OpenClaw installs the plugin if needed, asks for the relay URL, and generates a dedicated bot identity.

Give the displayed public key only to a Buzz owner or admin:

buzz channels add-member \
  --channel <ROOM_UUID> \
  --pubkey <BOT_PUBLIC_KEY> \
  --role bot

Closed relays may also require the bot to be added as a relay member. Setup waits for approval, discovers accessible rooms, and saves the selected rooms and default target.

Restart the Gateway if it was already running.

Verify

openclaw channels status --probe

Send a test message:

openclaw message send \
  --channel buzz \
  --target <ROOM_UUID> \
  --message "Hello from OpenClaw"

Security and scope

Never give OpenClaw a human owner's private key.
The generated bot private key is stored in OpenClaw configuration; only its public key is displayed.
Treat Buzz messages as untrusted agent input.
Currently supported: text conversations in group rooms.
Not yet supported: DMs, media, reactions, or creating rooms from OpenClaw.

Full documentation: https://docs.openclaw.ai/channels/buzz

Package: @openclaw/buzz · Plugin ID: buzz