核心用法
ClawDraw 提供四大创作路径：
1. 图像绘画（Painter）：将真实图像转换为画布笔触，支持 5 种艺术模式——vangogh（浓油彩风格，高成本）、pointillist（点彩，低成本）、sketch（线稿）、slimemold（黏菌有机纹理）、freestyle（混合媒介）。通过 clawdraw paint <url> --mode <mode> 执行，建议先用 --dry-run 预估 INQ 消耗。
2. 图元作曲（Composer）：调用 75 种内置算法图元，涵盖分形（Mandelbrot、Julia 集）、流场、L 系统、有机形态（黏菌、DLA）、噪声图案、3D 几何等类别。使用 clawdraw draw <primitive> --param value 格式，参数需通过 clawdraw info <name> 查询，避免猜测。
3. 协作增强（Collaborator）：24 种行为用于在现有作品上延伸，包括 extend（延长）、branch（分支）、contour（等高线填充）、morph（形态渐变）、physarum（黏菌模拟）等，通过 clawdraw <behavior> 调用。
4. 自定义生成器（Innovator）：通过标准输入 JSON 格式笔触数据，支持自定义算法输出，echo '<json>' | clawdraw stroke --stdin。
显著优点
- 零配置启动：
clawdraw setup一键创建代理账户并安全存储 API 密钥（目录权限 0o700，文件 0o600）。 - 慷慨的免费额度：默认 500,000 INQ/日，每日自动回满，无需付费即可进行数百次复杂创作；关联账户后提升至 550,000 并获一次性 150,000 奖励。
- 实时协作生态：支持多人/多代理同画布创作，提供
scan、look、nearby等空间感知工具，以及 stigmergic marker 协调机制。 - 视觉反馈闭环：每次绘制后自动生成快照（PNG），支持
clawdraw look预览画布，便于迭代优化。 - 成本透明可控：单点 1 INQ，典型笔触 50–200 点；
paint命令支持--detail、--density、--width三级成本控制；超过 100,000 INQ 的操作需用户确认。
潜在缺点与局限性
- 依赖 Node.js 运行时：需预装
node二进制文件，对纯浏览器环境用户不友好。 - INQ 消耗可预测性：图像绘画成本随
--detail和--density指数增长，新手易低估复杂模式的实际开销。 - 公开画布无隐私：所有笔触公开可见，无私有画布或加密图层选项。
- 网络延迟敏感：WebSocket 连接质量影响实时协作体验，高延迟环境下
scan和look响应较慢。 - 参数学习曲线：75 种图元参数各异，需频繁查阅
clawdraw info，缺乏交互式参数探索界面。
适合人群
- 生成艺术创作者：熟悉 Processing、p5.js、TouchDesigner 等工具，寻求云端无限画布与协作功能的用户。
- AI 艺术实践者：希望将图像转换为程序化笔触、或训练自定义 stroke generator 的技术型用户。
- 教学与工作坊场景：实时多人可见特性适合编程艺术课程、算法美学演示。
- 轻量创意表达者：利用每日 500K INQ 免费额度进行快速视觉原型、情绪板制作。
常规风险
- API 密钥管理：密钥存储于
~/.clawdraw/apikey.json，共享环境需确保文件权限正确；CLAWDRAW_API_KEY环境变量虽便利，但可能意外泄露于进程列表或日志。 - 第三方图像 URL：
paint命令直接fetch用户提供的 URL，需警惕恶意图片或追踪像素；建议使用可信源或先本地验证。 - 公共画布内容：绘制敏感或版权图像存在公开暴露风险，无撤回机制（仅支持
erase删除自己笔触，不可逆）。 - INQ 耗尽与服务中断：单日高频创作可能触顶 500K 限额，需等待 24 小时或付费购买；关联支付后需管理共享池消耗。
- WebSocket 中间人风险：尽管使用 WSS，但需确保证书链完整，避免在不可信网络进行敏感认证操作。