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.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
A direct command skips the review prompt. Inspect the source before running it.
The command stays on one line. Scroll horizontally to inspect it before copying.
Prefer a local copy? Download the files currently available to SkillsMP.
File Explorer
28 files
Showing SKILL.md
SKILL.md
Source instructions · Read-only preview
name
sn-image-base
description
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:
