应配置视觉模型、安装图像描述Skill、构建截图工作流或接入IM工具。需启用vision参数、安装image-description技能、定义YAML工作流、配置飞书Webhook,确保模型服务运行且路径可达。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

如果您在使用OpenClaw处理图像时需要自动生成准确、结构化的文字描述,但当前未配置多模态理解能力或技能调用失败,则可能是由于本地模型未启用视觉支持、图像路径不可达或Skills未正确加载。以下是解决此问题的步骤:
一、配置支持视觉的本地多模态模型
该方法通过在OpenClaw中声明具备图像理解能力的本地模型,使其能接收图片输入并输出自然语言描述。关键在于确保模型服务已启动、API路径可达,且配置中明确启用vision能力。
1、确认已部署支持视觉的模型服务,例如ollama-QwQ-32B、Phi-3-vision-128k-instruct或Qwen3.5-9B-AWQ-4bit,并运行于本地端口(如http://localhost:8080)。
2、编辑~/.openclaw/openclaw.json配置文件,在对应模型provider区块中将"vision": true字段设为true。
3、验证配置语法无误后,执行openclaw gateway restart重启网关服务,使新配置生效。
4、运行测试命令:openclaw describe --image /path/to/test.jpg,观察是否返回合理描述文本。
二、安装并启用图像描述专用Skill
该方法利用OpenClaw Skills扩展机制,加载专用于图像理解与描述生成的预置技能包,屏蔽底层模型差异,提供统一指令接口。
1、访问https://linskills.qiniu.com/,搜索关键词image-description或vision-caption,获取对应Skill slug。
2、在终端执行安装命令:openclaw skills install image-description-qwen35(以Qwen3.5适配版为例)。
3、安装完成后,使用openclaw skills list确认该Skill状态为enabled。
4、直接调用:openclaw run "为这张图生成一段小红书风格的配文" --image /input/scene.png。
OpenClaw 原生 PDF/文档处理技能,适用于 Nutrient DWS,帮助用户完成 PDF 转换、OCR、文字/表格提取、PII 脱敏等功能。
三、构建本地截图→描述→写入的自动化工作流
该方法适用于需批量处理屏幕区域或指定窗口截图的场景,由OpenClaw自动捕获图像、调用模型、保存结果,全程无需人工干预图片传输。
1、编写YAML格式工作流文件caption-flow.yaml,定义trigger为on_screenshot,action为call_vision_model并指定output_path。
2、将文件存入~/.openclaw/workflows/目录下。
3、启用该工作流:openclaw workflow enable caption-flow。
4、执行openclaw screenshot --region "0,0,800,600",系统将自动生成描述并写入预设Markdown文件。
四、通过飞书/WhatsApp等IM工具触发远程描述任务
该方法将OpenClaw接入即时通讯平台,允许用户在聊天界面中发送图片,由Agent自动完成识别与描述,并将结果回传至同一对话线程,实现零客户端操作。
1、在~/.openclaw/integrations/下创建feishu-config.yaml,填入飞书机器人Webhook地址及事件订阅配置。
2、确保openclaw integrations enable feishu返回success。
3、向飞书机器人发送一张商品截图,并附带文字请描述这张图。
4、等待约8–12秒,机器人将自动回复含角色、场景、动作、情绪四要素的结构化描述文本。

















