# Clawvisual

> URL or long-form text to social carousel generator via local CLI + MCP endpoint.

- Skill: `dvcrn/clawvisual-2` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add dvcrn/clawvisual-2`
- Raw SKILL.md: https://api.skillmd.com/api/skills/dvcrn/clawvisual-2/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: dvcrn (https://skillmd.com/u/dvcrn)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/dvcrn/clawvisual-2

---


# clawvisual

Use clawvisual as a callable skill for agent workflows. It can auto-start a local web/MCP service and expose stable CLI commands for generation and job polling.

## Quick start

```bash
npm install -g clawvisual
clawvisual set CLAWVISUAL_LLM_API_KEY "your_openrouter_key"
clawvisual initialize
clawvisual convert --input "https://example.com/article" --slides auto
clawvisual status --job <job_id>
```

For local repo usage, you can also run:

```bash
npm run skill:clawvisual -- initialize
```

## What it does

- Convert URL or direct long-form text into social carousel output.
- Provide job-based async workflow (`convert` -> `status --job`).
- Support revision operations (`revise`, `regenerate-cover`).
- Expose MCP JSON-RPC tools for OpenClaw and other agent runtimes.

## Commands

- `clawvisual initialize`: probe/start local service and print Web URL.
- `clawvisual status`: check service identity (must be `clawvisual-mcp`).
- `clawvisual tools`: list MCP tools.
- `clawvisual convert --input <text_or_url> [--slides auto|1-8] [--ratio 4:5|1:1|9:16|16:9] [--lang <code>]`
- `clawvisual status --job <job_id>`: query job state and result.
- `clawvisual revise --job <job_id> --instruction <text> [--intent rewrite_copy_style|regenerate_cover|regenerate_slides]`
- `clawvisual regenerate-cover (--job <job_id> [--instruction <text>] | --prompt <text>) [--ratio 4:5|1:1|9:16|16:9]`
- `clawvisual call --name <tool_name> --args <json>`: raw tool invocation.

## Config

Optional local config file:

- `~/.clawvisual/config.json`

Manage config with CLI:

```bash
clawvisual set CLAWVISUAL_LLM_API_KEY "your_key"
clawvisual get CLAWVISUAL_LLM_API_KEY
clawvisual config
clawvisual unset CLAWVISUAL_LLM_API_KEY
```

Supported keys:

- `CLAWVISUAL_LLM_API_KEY` (alias: `LLM_API_KEY`)
- `CLAWVISUAL_LLM_API_URL` (alias: `LLM_API_URL`)
- `CLAWVISUAL_LLM_MODEL` (alias: `LLM_MODEL`)
- `CLAWVISUAL_MCP_URL` (alias: `MCP_URL`)
- `CLAWVISUAL_API_KEY`

When auto-starting local service, `CLAWVISUAL_LLM_*` values are mapped to runtime `LLM_*` envs.

## Workflow pattern

1. `initialize`
2. `convert`
3. Poll `status --job <job_id>` until completion
4. Optional `revise` / `regenerate-cover`
5. Poll revised job with `status --job`

## Output contract

All commands return JSON to stdout for deterministic parsing by upstream agents.