Pubblue

使用 pubblue CLI 把 HTML 或文本内容发布为默认私有的页面，支持获取、更新、列出与删除；启动守护进程后可配合浏览器端“Go Live”在 chat/canvas 频道读写消息，并用 doctor/status 校验运行状态。依赖 Node.js 18+ 与 pub.blue API Key。

xmanatee

热度 61.05

最近更新 2026-05-17 12:43:54

分类：自动化依赖：代码执行 / 读写文件 / 第三方 API应用场景：自动化脚本 / 工作流

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add pubblue

Metadata

name: pubblue
description: Publish and visualize output via the pubblue CLI, with live P2P browser sessions.
license: MIT
compatibility: Requires Node.js 18+ with npm/pnpm/npx.
metadata: {"author":"pub.blue","version":"5.1.2"}
allowed-tools: Bash(pubblue:*) Bash(npx pubblue:*) Bash(node:*) Read Write

pubblue

Use this skill when the user asks about publishing, showing, or visualizing agent output on pub.blue.

Required CLI Version

Use pubblue CLI 0.6.9+.

pubblue --version
npm i -g pubblue@latest

Setup

# One-time auth
pubblue configure --api-key pub_KEY
# or
echo "pub_KEY" | pubblue configure --api-key-stdin

Key source: https://pub.blue/dashboard

By default, config is stored at ~/.openclaw/pubblue/config.json. Override config directory with PUBBLUE_CONFIG_DIR env var (useful in sandboxed environments). For OpenClaw bridge mode, daemon runtime defaults to OPENCLAW_WORKSPACE=~/.openclaw/workspace.

Core Commands

pubblue create page.html
pubblue create --slug demo --title "Demo" --public page.html
cat notes.md | pubblue create

pubblue get <slug>
pubblue get <slug> --content

pubblue update <slug> --file next.html
pubblue update <slug> --title "New title" --public

pubblue list
pubblue delete <slug>

Notes:

Pub is built for agent-driven output sharing and live visualization.
Pubs are private by default.
create supports --public/--private, --title, --slug, --expires.
update supports --file, --title, --public/--private, --slug.
Content is optional: a pub can be live-only.

Going Live

Live is browser-initiated: the user opens the pub page and clicks Go Live; the daemon answers.

Start the agent daemon:

pubblue start --agent-name "<agent-name>"
# optional explicit mode:
pubblue start --agent-name "<agent-name>" --bridge openclaw
pubblue start --agent-name "<agent-name>" --bridge claude-code

Check runtime status:

pubblue status

Send replies:

pubblue write "Hello"
pubblue write -c canvas -f /tmp/view.html

Read incoming (manual/debug):

pubblue read --follow -c chat
pubblue read --all

Stop daemon:

pubblue stop

Validate end-to-end:

pubblue doctor
pubblue doctor --wait-pong --timeout 30
pubblue doctor --skip-chat --skip-canvas

Important:

write waits for delivery confirmation.
read is consumptive; avoid multiple read --follow consumers on the same channel.

Advanced Details (On Demand)

Only when needed:

Show effective saved config: pubblue configure
Inspect runtime and bridge state: pubblue status
See command-specific options: pubblue <command> --help