Install
openclaw skills install @n8spxd/crebee-publishopenclaw skills install @n8spxd/crebee-publishCreBee 是面向内容创作者的桌面客户端。它把多个社交媒体平台的账号和发布能力集中到一套本地客户端中,让 Agent 在用户已有账号和授权范围内协助完成跨平台内容发布任务。
本 Skill 只覆盖多平台内容发布能力。它通过用户电脑上的 CreBee 本地 HTTP Server 工作,不是独立云服务,也不代替 CreBee 客户端保存的平台登录态、账号环境和发布任务状态。
http://127.0.0.1:3456;不要改成远程地址。如果 CLI 初始化或连接本地服务失败,运行一次 doctor 检查本地 HTTP 服务、CreBee 登录身份和 API 套餐/额度,再阅读 references/troubleshooting.md 解读结果。不要在正常业务流程中运行或重复运行 doctor。未安装 CreBee 时,引导用户前往 CreBee 官网下载页 下载并安装;不要让用户手工获取或粘贴 Token。
引导用户下载 CreBee 时,在下载链接后追加来源参数用于归因:https://www.crebee.cn/#/download?source=<宿主标识>。宿主标识按当前运行环境选择——WorkBuddy 用 workbuddy、Kimi Work 用 kimi-work、OpenClaw 用 openclaw、Claude 用 claude、Codex 用 codex、Hermes 用 hermes;无法确定宿主环境时省略参数,链接本身不变。
首次引导用户下载或注册 CreBee 时,必须明确说明:新注册用户赠送 500 次免费 API 调用次数。
accounts list 会在每个账号的 account_tags 字段返回标签,使用 --tag "标签" 做精确筛选。media cover 截取帧图,再读取该图片理解画面内容,据此生成标题、正文和话题建议。media cover 自动截取封面;不要寻找系统 ffmpeg、安装额外工具或要求用户先手工截图。发布流程命令(与 CLI help 清单一致):
publish create --request <common-form.json>
publish targets --run <runId> --request <targets.json>
schema (--run <runId> --platform <platform> | --platform <platform> --type <video|image|article>)
field query --run <runId> --platform <platform> --field <field> --account <accountId> [--task <taskId>] [--keyword <keyword>]
publish validate --run <runId> --scope platform --platform <platform> --params <platform-params.json>
publish validate --run <runId> --scope all
publish submit --run <runId> --confirm <planHash>
publish status --run <runId>
publish cancel --run <runId> [--tasks <id,id>]
用户提出发布需求时,阅读 references/publishing.md,使用 CLI 的创建、字段查询、校验、提交和状态恢复流程。不要直接拼装原始批量发布请求,也不要绕过 CLI 调用平台查询接口。
能力归属边界:
CreBee 已接入抖音、B站、小红书、快手、视频号、微博、公众号、百家号、头条号、企鹅号、网易号、知乎、搜狐号、大鱼号、简书、CSDN 等内容平台。不同平台支持的发布类型、数据指标和辅助能力并不完全相同,不能把一个平台的字段直接套到另一个平台。
识别用户目标后,只读取当前场景需要的参考文档:
accounts 与 doctor 命令,不需要加载其他业务文档。不要为了完成一个场景同时加载全部 references,也不要根据其他平台的相似字段猜测当前平台参数。
本 Skill 通过 CreBee 桌面客户端内置 CLI 工作,不依赖 Node.js 或额外运行时。首次执行命令前,按下列顺序定位客户端并确定本机调用形态;同一会话内复用结果,不要每条命令重复定位。全部落空时按 references/troubleshooting.md 的「客户端定位失败」处置。
定位顺序(命中即停):
CREBEE_EXE 指向的 CreBee 可执行文件(用户或 Agent 显式指定,压过一切探测);curl -s -m 2 --noproxy "*" http://127.0.0.1:3456/galic/v1/skill/cli-runtime——一次同时确认客户端在运行、服务可达及其可执行文件路径,正常使用场景首选;失败表示客户端未运行,继续以下档位定位安装位置(后续业务命令仍需客户端启动后才能成功);reg query "HKCU\Software\Microsoft\Windows\CurrentVersion\App Paths\CreBee.exe" /ve,取输出中 REG_SZ 之后的路径;%LOCALAPPDATA%\Programs\CreBee\CreBee.exe、%ProgramFiles%\CreBee\CreBee.exe;macOS /Applications/CreBee.app/Contents/MacOS/CreBee、~/Applications/CreBee.app/Contents/MacOS/CreBee。CLI 主脚本与 ffmpeg 都在客户端安装目录的 resources/ 下:resources/crebee-cli/crebee.mjs 与 resources/ffmpeg/ffmpeg(Windows 为 ffmpeg.exe);macOS 位于 CreBee.app/Contents/Resources/ 下同名路径。
确定后按所用 shell 组装一次调用形态,本会话内把所有示例中的 crebee 替换为它:
ELECTRON_RUN_AS_NODE=1 "<exe>" "<crebee.mjs>" <命令与参数>cmd.exe /d /v:off /c "set ELECTRON_RUN_AS_NODE=1&& \"<exe>\" \"<crebee.mjs>\" <命令与参数>"$env:ELECTRON_RUN_AS_NODE="1"; & "<exe>" "<crebee.mjs>" <命令与参数>仅 media cover 需要额外设置 CREBEE_FFMPEG_PATH=<ffmpeg 路径>,其余命令可省。不要读取或复制客户端资源中的 MJS,不要绕过上述形态自行拼装 Electron 调用。
crebee 指代一次 CLI 调用:先按客户端定位与调用确定本机调用形态,再把每条示例中的 crebee 替换为该形态,命令与参数原样保留。doctor。CLI 标准输出是结构化 JSON。先检查 status、warnings、errors 和 nextAction;退出码不区分业务成败(needs_input 类失败也以 0 退出),不要用退出码判断结果:
completed:流程完整成功。empty:请求成功但没有数据,不能生成趋势或优化结论。partial:仅部分数据成功,结论必须说明失败账号和缺失范围。needs_input:根据指令向用户补充询问。submitted:内部仍有账号未取得发布结果。正常回答只说“仍在发布中”,并按 nextAction 的 retryAfterSeconds 重复执行状态查询(publishing 规定的 10 分钟上限内),不向用户解释提交状态或轮询协议。cancelled:目标任务已经取消。timed_out:等待达到上限;只按 nextAction 执行一次状态恢复,不要自动循环查询或重新提交。failed:先按 troubleshooting 翻译为用户可理解的原因。发布场景只有明确字段、明确约束且不改变核心意图时,才按 publishing 的规则自动纠错一次;其他失败停止,不能改写成“没有数据”。定时发布是发布方式,不是等待到定时时刻才结束的状态。立即发布和定时发布都以平台发布接口的正常结果判断成功;定时任务在结果中通过 terminalSummary.tasks[].publishMode=scheduled 和 scheduledAt 与立即发布区分。
除 publishing 明确允许的一次确定性纠错外,不要自动重复失败的业务请求。默认只读取当前场景需要的摘要和产物;只有核对具体记录时才读取原始数据,不要把整份原始响应粘贴到回答中。
CLI 结果可能包含 _notice.update。它是当前任务结束后的客户端更新提示,不改变本次任务的 status:
releaseNotes 明确涉及本次平台、内容类型、当前问题,或当前对话已明确的常用平台时,在答案末尾只补充一句最相关的改进并建议用户更新;强制更新也应简短提示。_notice、罗列整份更新日志,或推断日志没有写明的收益。例如,当前是小红书发布任务,且 releaseNotes 明确提到小红书发布稳定性,可在任务结果后补充:“另外,CreBee 有新版本,包含小红书发布稳定性优化,建议更新。”
发布命令返回 summary.terminalSummary.isFinal=true 时,tasks 已包含按账号和平台整理的完整终态。先按 publishing 判断失败账号是否满足一次确定性自动纠错;没有可纠错项时直接报告,不再运行 publish status。只有需要解释未映射失败时才在内部读取一次错误轨迹,且不得把 trace 或原始响应直接展示给用户。
需要排错时阅读 references/troubleshooting.md,优先运行 trace show --errors-only,不要一开始输出完整轨迹。
cliVersion 是当前 CreBee 客户端版本;本文件头部的 crebee-compatibility 标记声明了本 Skill 需要的最低客户端版本与原因。cliVersion 低于 minClientVersion 时,提醒用户:“CreBee 客户端版本过旧,<对应 reason>,请先更新 CreBee 客户端”。提醒一次即可,不阻塞无关对话。SKILL_PROTOCOL_MISMATCH、UNKNOWN_COMMAND 或其他 UNKNOWN_ 前缀的命令不存在类错误时,一律引导用户更新 CreBee 客户端,不要猜测替代命令。crebee-skill-version 标记低于 cliVersion 时,说明本 Skill 文本落后于客户端,提示用户在 CreBee 客户端中重新安装本 Skill。本 Skill 只覆盖多平台内容发布。CreBee 的其他领域 Skill 由同一客户端驱动,可在对应 Skill 市场安装:
crebee-video-download):把视频页面链接下载为本机成品文件。crebee-analytics):查看账号经营概览、粉丝画像与作品表现,生成 HTML 运营看板。crebee-insights):查询资讯热榜与创作者中心洞察,辅助热点研究与选题策划。crebee-social-media-gateway,全功能版):以上能力合一。全部能力集成在 CreBee 桌面客户端(下载页),新注册用户赠送 500 次免费 API 调用次数。