Base-layer skill for the SenseNova-Skills project, providing low-level APIs for image generation, recognition (VLM), and text optimization (LLM).
This skill does not preprocess inputs; it only calls backend services and returns results.
This skill is not user-facing and is intended for upper-layer skills only.
Installer avec Codex ou Claude Copiez ce prompt, collez-le dans Codex, Claude ou un autre assistant, puis laissez-le vérifier la page du skill et l'installer pour vous.
Une commande directe contourne le prompt de vérification. Examinez la source avant de l'exécuter.
Base-layer skill for the SenseNova-Skills project, providing low-level APIs for image generation, recognition (VLM), and text optimization (LLM).
This skill does not preprocess inputs; it only calls backend services and returns results.
This skill is not user-facing and is intended for upper-layer skills only.
sn-image-recognize: image recognition (uses VLM to analyze image content)
sn-text-optimize: text optimization (uses LLM to process text)
This skill does not perform any input preprocessing and only calls backend services to return results.
Tools List
sn-image-generate
Image generation tool that calls the text-to-image-no-enhance API.
--prompt is required; all other parameters are optional:
Parameter
Type
Default
Description
--prompt
string
Required
Prompt text for image generation
--negative-prompt
string
""
Negative prompt
--image-size
string
2k
Image size preset (case-insensitive). Recommended: 2k. 4k optional, needs model support (sensenova rejects it → status=failed). Other values → status=failed.
--aspect-ratio
string
16:9
Aspect ratio, e.g. 1:1, 16:9, 9:16
--seed
int
None
Random seed for reproducible generation
--unet-name
string
None
Specify a UNet model name
--api-key
string
SN_IMAGE_GEN_API_KEY -> SN_API_KEY
API key (CLI argument has priority; MissingApiKeyError is raised when all are empty)
--base-url
string
SN_IMAGE_GEN_BASE_URL -> SN_BASE_URL
API base URL (CLI argument has priority)
--poll-interval
float
5.0
Polling interval (seconds)
--timeout
float
300.0
Timeout (seconds)
--insecure
flag
False
Disable TLS verification
--save-path
Path
Auto-generated
Save path
sn-image-recognize
Image recognition tool that uses VLM (Vision Language Model) to analyze image content. Supports multiple image inputs.
--images and --user-prompt (or --user-prompt-path) are required. All other parameters use three-level defaults (CLI > env var > built-in default):
Authentication parameters for sn-image-generate have the following default behavior:
Parameter
Default
Override
Description
--base-url
SN_IMAGE_GEN_BASE_URL -> SN_BASE_URL
--base-url "..."
CLI argument has priority
--api-key
SN_IMAGE_GEN_API_KEY -> SN_API_KEY
--api-key "..."
CLI argument has priority; throws MissingApiKeyError if all values are empty
sn-image-recognize and sn-text-optimize use priority: CLI argument > command-specific env var > shared SN_CHAT_* env var > global SN_* env var > built-in default.
api_key resolution order (high to low): CLI --api-key > command-specific key (SN_VISION_API_KEY/SN_TEXT_API_KEY) > SN_CHAT_API_KEY > SN_API_KEY. If all are unset, MissingApiKeyError is raised.
Only --api-key must be provided via CLI or environment; base URL, model, and interface type have shared chat defaults.
Agent Configuration Integration
The agent can automatically read parameters from openclaw.json without manual input:
CLI Parameter
openclaw.json Field
Example
--base-url
providers.<name>.baseUrl
https://api.anthropic.com
--llm-type
providers.<name>.api
anthropic-messages / openai-completions
--vlm-type
providers.<name>.api
anthropic-messages / openai-completions
--model
providers.<name>.models[].id
claude-sonnet-4-6
--api-key
providers.<name>.apiKey or env var
sk-cp-...
Note: --llm-type and --vlm-type share the same providers.<name>.api field and are used by LLM and VLM tools respectively.
Mapping between provider.api and interface type:
api Value
Corresponding --llm-type / --vlm-type
Endpoint Path
anthropic-messages
anthropic-messages
/v1/messages
openai-completions
openai-completions
/v1/chat/completions
openai-responses
(future extension)
/responses
Mapping Between base-url and Interface Type
Different API types have different requirements for base-url format:
Type
--llm-type / --vlm-type
Recommended base-url
Code Appended Path
Final URL Example
LLM
openai-completions
https://token.sensenova.cn/v1
/chat/completions
https://token.sensenova.cn/v1/chat/completions
LLM
anthropic-messages
https://api.anthropic.com/v1
/messages
https://api.anthropic.com/v1/messages
VLM
openai-completions
https://token.sensenova.cn/v1
/chat/completions
https://token.sensenova.cn/v1/chat/completions
VLM
anthropic-messages
https://api.anthropic.com/v1
/messages
https://api.anthropic.com/v1/messages
Note:
Recommended chat base URLs include the provider API version path, for example /v1.
For compatibility, if the configured chat base URL has no path, the runner appends /v1/chat/completions or /v1/messages.
If the configured chat base URL already has a path such as /v1, the runner appends only /chat/completions or /messages.
Some providers use versioned paths other than /v1, such as Gemini's /v1beta/openai.
Output Format
All tools support two output formats:
--output-format text (default): outputs plain text result
--output-format json: outputs JSON, including status and elapsed_seconds (runtime in seconds, rounded to 2 decimals)
JSON output for sn-image-recognize and sn-text-optimize also includes model, base_url, and interface_type to verify the effective runtime configuration:
