imagecanvas

CLI for Image Canvas image generation, local image uploads, custom templates, canvas sessions, task status, and multi-branch draws.

npm install -g openclaw-imagecanvas
imagecanvas auth configure --base-url https://imagecanvas.shop --auth-token ic_xxx
imagecanvas generate --prompt "A clean product poster" --count 4

The CLI only calls your configured Image Canvas server. It does not call upstream image providers directly.

auth configure also creates a local ~/imagecanvas git repository with images/, uploads/, records/, and skills/. Successful generations are downloaded to ~/imagecanvas/images by default and logged to ~/imagecanvas/records/YYYY-MM-DD.md.

During generate, progress is emitted as JSONL on stderr with Chinese message fields such as 任务已收到，开始生成图片 and 正在生成中, so agents can wait without rerunning the command. The final JSON includes one completion summary, timings, chatFiles, and an images array. Each image includes the original file and a chat-safe chatFile; when the original download is larger than 5 MB, chatFile is an automatically compressed JPEG copy. Agents should upload/render every images[i].chatFile once and avoid repeating the same completion message. Use --no-wait to create tasks and return immediately, then poll with imagecanvas status --session-id <id> and download final images with imagecanvas download --image-id <id>. If a chat platform has a stricter media limit, pass --chat-max-mb 2 to generate or download.