若OpenClaw采集失败，需依次检查：一、Gateway服务状态与端口占用；二、重载Skills技能并验证向量引擎连接；三、刷新本地缓存并重建Memory索引；四、切换至备用解析器并禁用JavaScript渲染。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试使用OpenClaw执行网络数据采集任务，但系统无法启动采集流程或返回空结果，则可能是由于AI解析模块未加载、向量引擎未就绪或Skills技能未正确注册。以下是解决此问题的步骤：
一、检查Gateway服务状态与端口占用
Gateway是OpenClaw的通信中枢，所有采集请求均需经其路由转发。若服务未运行或端口被占，将导致整个采集链路中断。
1、打开终端（Windows使用PowerShell，macOS/Linux使用bash），执行命令：curl http://127.0.0.1:8080/health，确认返回status: "ok"。
2、若返回连接拒绝，执行：netstat -ano | findstr :8080（Windows）或lsof -i :8080（macOS/Linux），查出占用进程PID。
3、终止该进程：taskkill /PID [PID] /F（Windows）或kill -9 [PID]（macOS/Linux）。
4、进入OpenClaw安装目录，运行：./gateway --port 8080 --log-level debug，观察控制台是否输出Gateway started on http://0.0.0.0:8080。
二、重载Skills技能并验证向量引擎连接
OpenClaw依赖Skills模块执行具体采集动作，而向量引擎负责语义理解与结构化映射。若Skills未激活或向量引擎离线，自然语言指令将无法转化为可执行操作。
1、访问http://127.0.0.1:8080/skills/list，确认返回JSON数组中包含"web_crawler"和"html_parser_v2"两项已启用技能。
2、若缺失，执行：openclaw skills install web_crawler html_parser_v2 --force。
3、检查向量引擎状态：运行curl http://127.0.0.1:7777/v1/health，应返回{"status":"healthy","model":"bge-m3-local"}。
4、若失败，在config/vector.yaml中确认host为127.0.0.1、port为7777，且models/bge-m3-local目录存在完整权重文件。
三、强制刷新本地缓存并重建Memory索引
OpenClaw的Memory组件会缓存网页结构特征与历史解析模式，当网站改版或HTML语义变更时，过期缓存将导致AI误判页面布局，从而跳过关键字段提取。
1、定位到OpenClaw安装根目录下的data/memory/子目录。
2、删除以下全部内容：cache.db、index_v3.bin、schema_snapshot.json。
3、执行命令：openclaw memory rebuild --full --no-prompt，等待输出Rebuild completed. 127 nodes indexed.（具体数值依环境而异）。
4、重启Agent服务：pkill -f "openclaw agent"，再运行openclaw agent start --debug。
四、切换至备用解析器并禁用JavaScript渲染
部分目标站点采用强动态渲染机制，本地Chromium内核可能因版本不兼容或GPU驱动缺失而挂起。此时应临时降级为纯HTML+CSS选择器解析路径，绕过JS执行环节。
1、编辑config/tasks/default.yaml，将renderer字段值由chromium改为none。
2、在同文件中，将parser字段设为cv_layout_v1（基于计算机视觉的布局识别器）。
3、添加强制解析开关：force_static_parse: true，保存文件。
4、提交一次测试采集：openclaw task run --url "https://example.com" --field "title,price"，观察日志中是否出现Parsed 2 fields via CV layout。
