OpenClaw 龙虾技能 (OpenClaw Skill)
本项目采用 DTO 驱动 (Interface-Driven) 的架构模式。所有的功能均可通过 api.ts 配合标准化的 DTO Payload 进行调用。
核心原则 (Core Principles)
- 接口即标准: 所有的功能调用严格基于后端 API 的 Request DTO 设计。
- 文档即指引:
docs/下的 Markdown 文档用于解释对应接口的参数规则、必填项与约束。 - 分级阅读原则: 所有的发布任务文档采用“内容类型首页 (Index) + 平台详情页 (Platform)”的二级结构。
- 零映射透传: 鼓励调用者使用
api.ts透明地提交符合 DTO 要求的 JSON Payload。 - AI 场景化驱动: 所有的文档均包含
Trigger(触发场景) 和Logic Flow(执行逻辑) 模块，旨在通过自然语言语义引导 Agent 进行精确的意图识别与参数构造。
[!IMPORTANT] 严格合规性与执行标准 (Strict Compliance & Standard): 1. 执行标准: 所有 Agent 的调用行为、版本校验、错误处理必须遵循 yixiaoer-skill 严格执行标准。 2. 首选排错指南: 在遇到任何脚本报错、发布失败或逻辑异常时，必须优先查阅 蚁小二 Skill 避坑与故障排查手册。该手册汇总了 90% 以上常见失败场景的解决方案。 3. 文档检索顺序: 针对publish行为，查询文档时必须首先查阅对应内容类型的index.md（如docs/publish/article/index.md），以获取基础 JSON 结构。严禁跳过 Index 直接访问平台级文档（如douyin.md），否则可能导致 Payload根结构缺失。 4. 所有接口调用必须严格遵守各文档中定义的必填字段 (必填: 是) 以及对应的数据格式要求。 5. 资源引用规范: 所有的封面图 (cover)、图文图片 (images) 以及 视频文件 (video) 必须先通过资源上传接口上传至系统并获得唯一的key。禁止填入非系统内的网络 URL 或随意留空，否则会导致发布任务执行失败。 6. 素材库入库流程: 涉及“上传到素材库”时，必须执行两步逻辑：先upload(资源入存储) -> 后material(登记入库)。严禁省略第二步。
平台支持 (Platform Support)
API 调用时涉及的平台名称必须使用蚁小二定义的中文枚举或 Code。
- 平台枚举列表: docs/platform.md
统一执行指令 (Unified Execution)
所有的 API 功能统一通过 api.ts 脚本执行。调用时需通过 --payload 参数传入 JSON，且 action 字段为必填项，用于指定具体功能。
| action 值 | 对应的能力描述 | 相关文档 |
|---|---|---|
publish | 图文、视频、文章分发发布。支持发布到平台或保存为平台草稿。 | 文章, 图文, 视频, 草稿指南 |
save-draft | 保存内容到蚁小二草稿箱。仅云端存储，不触发推送。 | 草稿指南 |
accounts | 查询已绑定的账号列表 | query-accounts.md |
upload | 上传本地或 URL 图片/视频 | upload-resource.md |
material | 将已上传资源登记到蚁小二素材库 | material-resource.md |
records | 查询发布任务概览列表 | get-publish-records.md |
details | 查询特定任务的执行详情 | get-publish-records.md |
categories | 获取账号分类/话题列表 | get-publish-categories.md |
activities | 获取征文活动列表 | get-publish-activities.md |
locations | 获取 POI 物理位置列表 | get-locations.md |
music | 获取抖音/快手可选背景音乐 | get-music.md |
music-category | 获取音乐分类列表 | get-music-categories.md |
collections | 获取账号已创建的合集列表 | get-collections.md |
groups | 获取账号可绑定的群聊列表 | get-groups.md |
goods | 获取账号可绑定的商品列表 | get-goods.md |
hot-events | 获取平台实时热点列表 | get-hot-events.md |
challenges | 获取平台话题/挑战列表 | get-challenges.md |
miniapps | 获取可挂载的小程序列表 | get-miniapps.md |
syncapps | 获取可同步发布的关联账号 | get-sync-apps.md |
games | 获取可挂载的游戏列表 | get-games.md |
proxies | 获取团队可用代理列表 | proxy-management.md |
proxy-areas | 获取默认代理地区编码列表 | proxy-management.md |
account-overviews | 账号表现汇总 (V2) | get-account-overviews.md |
content-overviews | 查看发布作品数据统计 | get-content-overviews.md |
update-account | 更新账号信息 (如设置代理) | proxy-management.md |
drafts | (Read-only) 草稿列表管理指南 | save-draft.md |
草稿识别标准 (Draft Recognition Standard)
当用户意图涉及“保存”、“草稿”或“以后再发”时，Agent 必须进行次级研判：
- 蚁小二草稿 (YXE Draft):
- 逻辑：内容仅存储在蚁小二云端，不触发任何平台推送。 - Trigger: “存为蚁小二草稿”、“暂存到草稿箱”、“存为 YXE 草稿”。 - Action: save-draft
- 平台草稿 (Platform Draft):
- 逻辑：内容会被推送到对应平台（如抖音、小红书）的草稿箱，用户可在 App 端二次编辑。 - Trigger: “存为抖音草稿”、“推送到平台草稿箱”、“存为小红书草稿”。 - Action: publish (并在 accountForms 内每项设置 "contentPublishForm": {"pubType": 0})
⚠️ 歧义处理：若用户仅提及“存草稿”而未明确指出是“蚁小二草稿”还是“平台草稿”，Agent 必须立刻询问用户以明确意图，严禁自行默认或猜测。
调用示例 (Example)
# 查询账号列表 (action: accounts)
node scripts/api.ts --payload='{"action": "accounts", "platform": "抖音"}'开发指南 (Development Guide)
为了简化 API 的调用与脚本开发，我们提供了通用的 API 助手模块：
- API 助手模块:
scripts/api.ts - 开发指引文档: API 助手使用指南
在开发新功能或修改现有脚本时，请务必参考此指引。
[!NOTE] 所有的敏感信息应通过环境变量 YIXIAOER_API_KEY 注入。 如果用户没有发送clientId，则默认使用云发布，publishChannel: cloud 故障诊断与常见问题 (Troubleshooting FAQ): 请立即参阅最权威的避坑指南：🛡️ 蚁小二 Skill 避坑与故障排查手册 更多详情请参阅：YiXiaoEr Skill 严格执行标准