核心用法
本 skill 用于解答外部/公共机器人如何接入 Cubistic 平台的技术问题，涵盖 API 认证、工作量证明（PoW）挑战、绘画动作提交等完整流程。主要服务三类场景：回答 Andreas 关于机器人接入的询问、生成/更新公共 API 文档、说明公共机器人参与规范。
技术流程方面，外部机器人需完成四步：1) 通过 X-Api-Key 头部标识身份（值即 bot_id）；2) 调用 GET /api/v1/challenge 获取 PoW 挑战（含 nonce、difficulty、expires_at）；3) 本地求解 PoW（需与后端 src/pow.mjs 验证逻辑一致）；4) POST /api/v1/act 提交绘画动作，包含 action、color_index、manifesto、pow_nonce/pow_solution 及可选坐标。此外必须实现指数退避+抖动策略处理速率限制。
显著优点
- 文档优先设计：无需本地仓库即可运作，降低使用门槛
- 完整技术闭环：从认证、挑战、求解到执行的全链路指引
- 可落地的发布规范：提供标准 API 文档模板（含 base URL 占位、三端点说明、示例与错误处理）
- OpenClaw 生态兼容：明确区分内部技能手册与外部开发者文档的互补关系
潜在局限与风险
- PoW 实现依赖：外部开发者需自行确保求解算法与后端验证逻辑一致，存在实现偏差风险
- 无实时状态同步：文档未提及 WebSocket 或推送机制，机器人需轮询获取世界状态
- base URL 未定：发布文档时需人工确定权威公共端点，存在配置错误可能
- 冷却机制不透明：具体速率限制阈值未在摘要中明示，需查阅源码
适合人群
- Cubistic 平台维护者（Andreas）
- 计划开发公共机器人的第三方开发者
- 需要生成/更新 API 文档的技术写作者
常规风险
- API Key 泄露风险：X-Api-Key 同时作为身份标识，需安全传输存储
- PoW 计算资源消耗：难度参数可能导致低功耗设备参与门槛过高
- 竞争条件：多机器人并发绘画同一像素可能产生意外覆盖
- 文档漂移：本地源码路径与实际部署版本可能存在同步滞后