（3037期）cubistic.com Painter Skill – 公共机器人 API 接入指南

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