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
CODEBLOCK0
For local repo usage, you can also run:
CODEBLOCK1
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. - INLINECODE5 : check service identity (must be
clawvisual). - INLINECODE7 : list MCP tools.
- INLINECODE8
- INLINECODE9 : query job state and result.
- INLINECODE10
- INLINECODE11
- INLINECODE12 : raw tool invocation.
Config
Optional local config file:
Manage config with CLI:
CODEBLOCK2
Supported keys:
- -
CLAWVISUAL_LLM_API_KEY (alias: LLM_API_KEY) - INLINECODE16 (alias:
LLM_API_URL) - INLINECODE18 (alias:
LLM_MODEL) - INLINECODE20 (alias:
MCP_URL) - INLINECODE22
When auto-starting local service, CLAWVISUAL_LLM_* values are mapped to runtime LLM_* envs.
Workflow pattern
- 1. INLINECODE25
- INLINECODE26
- Poll
status --job <job_id> until completion - Optional
revise / INLINECODE29 - Poll revised job with INLINECODE30
Output contract
All commands return JSON to stdout for deterministic parsing by upstream agents.
clawvisual
将clawvisual作为智能体工作流的可调用技能使用。它可以自动启动本地Web/MCP服务，并暴露稳定的CLI命令用于生成和任务轮询。
快速开始
bash
npm install -g clawvisual
clawvisual set CLAWVISUALLLMAPIKEY youropenrouter_key
clawvisual initialize
clawvisual convert --input https://example.com/article --slides auto
clawvisual status --job
对于本地仓库使用，你也可以运行：
bash
npm run skill:clawvisual -- initialize
功能说明
- - 将URL或直接的长文本转换为社交媒体轮播图输出。
- 提供基于任务的异步工作流（convert -> status --job）。
- 支持修订操作（revise、regenerate-cover）。
- 为OpenClaw和其他智能体运行时暴露MCP JSON-RPC工具。
命令
- - clawvisual initialize：探测/启动本地服务并打印Web URL。
- clawvisual status：检查服务标识（必须为clawvisual）。
- clawvisual tools：列出MCP工具。
- clawvisual convert --input orurl> [--slides auto|1-8] [--ratio 4:5|1:1|9:16|16:9] [--lang
] - clawvisual status --job id>：查询任务状态和结果。
- clawvisual revise --job id> --instruction [--intent rewritecopystyle|regeneratecover|regenerateslides]
- clawvisual regenerate-cover (--job id> [--instruction ] | --prompt ) [--ratio 4:5|1:1|9:16|16:9]
- clawvisual call --name name> --args ：原始工具调用。
配置
可选的本地配置文件：
- - ~/.clawvisual/config.json
通过CLI管理配置：
bash
clawvisual set CLAWVISUALLLMAPIKEY yourkey
clawvisual get CLAWVISUALLLMAPI_KEY
clawvisual config
clawvisual unset CLAWVISUALLLMAPI_KEY
支持的配置项：
- - CLAWVISUALLLMAPIKEY（别名：LLMAPIKEY）
- CLAWVISUALLLMAPIURL（别名：LLMAPIURL）
- CLAWVISUALLLMMODEL（别名：LLMMODEL）
- CLAWVISUALMCPURL（别名：MCPURL）
- CLAWVISUALAPIKEY
当自动启动本地服务时，CLAWVISUALLLM的值会映射到运行时的LLM_环境变量。
工作流模式
- 1. initialize
- convert
- 轮询status --job 直到完成
- 可选的revise / regenerate-cover
- 使用status --job轮询修订后的任务
输出约定
所有命令均返回JSON格式到标准输出，供上游智能体进行确定性解析。
