LiveClaw 直播推流执行者

解决什么问题

当 OpenClaw Agent 在执行任务时，外部渠道往往只能看到最终文本，缺少可观察的执行过程。LiveClaw 针对直播场景把 Agent 的指令、思考、工具调用和结果推送到实时 Dashboard，并通过 TRTC 形成可公网访问的观看地址，同时支持 TTS 状态播报和 Viewer 侧消息回传。它适合需要把 agent live 执行流作为直播内容展示的场景。

工作方式与关键步骤

• 初始化：读取或生成 $WORK_DIR/config.json，使用 TRTC SDKAppID 与 SecretKey 生成房间、RTMP URL 和默认 7 天有效的 UserSig。
• 启动推流链路：依次启动帧渲染、守护进程、TTS worker 与 HTTP viewer 服务，并要求看到 Stream ready 或等待足够时间后才生成观看页。
• 事件上报：直播启动后，Agent 每次回复都必须通过 agent_bus.py 上报 task、info、result 或 error 等事件；纯文本回复也需要 info 分段上报，否则 Dashboard 与 TTS 看不到正文。
• 双向交互：Viewer 可通过 IM 消息触发 Agent，Agent 的处理结果再经由推流画面、事件流和 TTS 展示。

适用边界与注意点

该技能依赖腾讯云 TRTC 体验版或更高版本，且会占用固定端口；SecretKey、CAM 密钥和回调 Token 不应写入日志或公开仓库。重新初始化后必须重新生成观看页，避免观众进入错误房间。它主要面向直播推流与 Agent 状态可视化，不应用于与推流无关的通用任务。