WebChat Image Support
by @styoha
Enables agents to detect and analyze images sent via WebChat or other channels using vision-capable models or fallback media processing.
clawhub install webchat-image-support📖 About This Skill
webchat-image-support
Universal image understanding enhancement for OpenClaw. This skill enables image understanding across all channels (WebChat, Discord, Slack, etc.) and works with any model that supports image input.
What It Does
When users send images through any channel, this skill ensures the agent can understand and analyze them:
Requirements
1. Gateway with image support (OpenClaw 2026.3.29+)
2. At least one vision-capable model configured in models.json:
- Claude (with vision)
- MiniMax-VL-01
- Gemini Pro Vision
- GPT-4 Vision
Usage
No explicit commands needed. Just send images:
User: [sends a screenshot of error]
Agent: "我看到了错误信息：Unable to load script..."User: [sends a photo]
Agent: "这张图片显示了一个卡通猪头..."
Configuration
Model Selection
For best results, use a vision-capable model. In ~/.openclaw/agents/main/agent/models.json:
{
"providers": {
"minimax": {
"models": [
{
"id": "MiniMax-VL-01",
"input": ["text", "image"]
}
]
}
}
}
Default Behavior
| Model Support | Behavior | |---------------|----------| | Model supports images | Direct image input to model | | Model no images | Use media understanding pipeline |
Troubleshooting
Q: Agent doesn't see images
A: Make sure your model supports image input (check input field in models.json)
Q: Images sent but no response A: Check gateway logs for media processing errors
Q: Works in CLI but not WebChat A: This skill requires OpenClaw 2026.3.29+ with the MediaPath fix
Related
💡 Examples
No explicit commands needed. Just send images:
User: [sends a screenshot of error]
Agent: "我看到了错误信息：Unable to load script..."User: [sends a photo]
Agent: "这张图片显示了一个卡通猪头..."
⚙️ Configuration
Model Selection
For best results, use a vision-capable model. In ~/.openclaw/agents/main/agent/models.json:
{
"providers": {
"minimax": {
"models": [
{
"id": "MiniMax-VL-01",
"input": ["text", "image"]
}
]
}
}
}
Default Behavior
| Model Support | Behavior | |---------------|----------| | Model supports images | Direct image input to model | | Model no images | Use media understanding pipeline |
📋 Tips & Best Practices
Q: Agent doesn't see images
A: Make sure your model supports image input (check input field in models.json)
Q: Images sent but no response A: Check gateway logs for media processing errors
Q: Works in CLI but not WebChat A: This skill requires OpenClaw 2026.3.29+ with the MediaPath fix