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+.
CODEBLOCK0
Setup
CODEBLOCK1
Key source:
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
CODEBLOCK2
Notes:
- - Pub is built for agent-driven output sharing and live visualization.
- Pubs are private by default.
- INLINECODE3 supports
--public/--private, --title, --slug, --expires. - INLINECODE8 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.
- 1. Start the agent daemon:
CODEBLOCK3
- 2. Check runtime status:
CODEBLOCK4
- 3. Send replies:
CODEBLOCK5
- 4. Read incoming (manual/debug):
CODEBLOCK6
- 5. Stop daemon:
CODEBLOCK7
- 6. Validate end-to-end:
CODEBLOCK8
Important:
- -
write waits for delivery confirmation. - INLINECODE14 is consumptive; avoid multiple
read --follow consumers on the same channel.
Advanced Details (On Demand)
Only when needed:
- - Show effective saved config: INLINECODE16
- Inspect runtime and bridge state: INLINECODE17
- See command-specific options: INLINECODE18
pubblue
当用户询问关于在pub.blue上发布、展示或可视化代理输出时，使用此技能。
所需CLI版本
使用 pubblue CLI 0.6.9+。
bash
pubblue --version
npm i -g pubblue@latest
设置
bash
一次性认证
pubblue configure --api-key pub_KEY
或
echo pub_KEY | pubblue configure --api-key-stdin
密钥来源：
默认情况下，配置存储在 ~/.openclaw/pubblue/config.json。
可通过 PUBBLUECONFIGDIR 环境变量覆盖配置目录（在沙盒环境中很有用）。
对于 OpenClaw 桥接模式，守护进程运行时默认使用 OPENCLAW_WORKSPACE=~/.openclaw/workspace。
核心命令
bash
pubblue create page.html
pubblue create --slug demo --title Demo --public page.html
cat notes.md | pubblue create
pubblue get
pubblue get --content
pubblue update --file next.html
pubblue update --title New title --public
pubblue list
pubblue delete
说明：
- - Pub 专为代理驱动的输出共享和实时可视化而构建。
- Pub 默认私有。
- create 支持 --public/--private、--title、--slug、--expires。
- update 支持 --file、--title、--public/--private、--slug。
- 内容是可选的：pub 可以仅用于实时展示。
实时模式
实时模式由浏览器发起：用户打开 pub 页面并点击 Go Live；守护进程响应。
- 1. 启动代理守护进程：
bash
pubblue start --agent-name
可选显式模式：
pubblue start --agent-name --bridge openclaw
pubblue start --agent-name --bridge claude-code
- 2. 检查运行时状态：
bash
pubblue status
- 3. 发送回复：
bash
pubblue write Hello
pubblue write -c canvas -f /tmp/view.html
- 4. 读取传入消息（手动/调试）：
bash
pubblue read --follow -c chat
pubblue read --all
- 5. 停止守护进程：
bash
pubblue stop
- 6. 验证端到端连接：
bash
pubblue doctor
pubblue doctor --wait-pong --timeout 30
pubblue doctor --skip-chat --skip-canvas
重要提示：
- - write 会等待投递确认。
- read 是消耗性的；避免在同一通道上有多个 read --follow 消费者。
高级详情（按需提供）
仅在需要时：
- - 查看已保存的有效配置：pubblue configure
- 检查运行时和桥接状态：pubblue status
- 查看命令特定选项：pubblue --help
