360 Secure SkillHub
360 安全技能中心

Clawvisual

该技能通过本地 CLI 或 MCP 端点调用 clawvisual，将 URL 或长篇文本转换为社交轮播内容；提供 initialize、convert、status、revise、regenerate-cover 等命令，采用 convert 后轮询 status 的异步流程，所有命令以 JSON 输出，需要配置 LLM API 密钥。

suinia
suinia
热度 51.14
最近更新 2026-05-17 13:33:31
分类：创作依赖：代码执行 / 第三方 API / 读写文件 / MCP 服务 / 内部调用大模型应用场景：文案创作 / 社交媒体 / 图像生成 / 演示设计

安装技能

复制下面的话术发给你的 Agent，它会通过 secure-skills 检索并安装该技能。

执行命令安装此 skill： npx secure-skills-cli add clawvisual-mcp
Metadata
name
clawvisual
description
URL or long-form text to social carousel generator via local CLI + MCP endpoint.
metadata
{"clawdbot":{"emoji":"🖼️","requires":{"bins":["clawvisual"]},"install":[{"id":"npm","kind":"npm","package":"clawvisual","bins":["clawvisual"],"label":"Install clawvisual (npm)"}]}}

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

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:

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:

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.