Hermes Agent数据采集需按五步配置：启用终端交互工具、配置Camofox网页爬取、设置本地文件读取、添加定时Cron任务、开启Session Search记忆检索，确保各模块在config.yaml中正确启用并验证响应。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望Hermes Agent自动获取外部数据，但发现终端无响应、网页内容未解析或文件读取失败，则可能是由于数据采集工具未启用或配置路径错误。以下是配置数据采集功能的具体步骤：
一、启用内置终端交互采集工具
该方法通过tools/terminal_tool.py模块捕获用户在终端中的操作行为与命令输出，适用于日志分析、运维监控等场景，无需额外依赖即可直接启用。
1、确认Hermes Agent已安装终端后端：执行uv pip install -e "./mini-swe-agent"确保终端工具包已加载；
2、在~/.hermes/config.yaml中添加tool启用配置：
3、将以下YAML片段插入tools节区：
tools:
terminal:
enabled: true
capture_history: true
4、重启Hermes Agent服务使配置生效；
5、运行任意shell命令（如ls -l），观察agent是否在trajectory.py中记录对应操作轨迹。
二、配置网页爬取工具（支持反爬伪装）
该方式利用集成的tools/web_tools.py模块，结合Camofox服务模拟真实浏览器行为，有效绕过目标网站的JS渲染检测与IP频率限制。
1、在项目根目录下启动Camofox服务：docker run -d -p 8080:8080 --name camofox nousresearch/camofox；
2、编辑config.yaml，在tools节区添加web配置：
web:
enabled: true
proxy_url: "http://localhost:8080"
timeout: 15
user_agent: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36"
3、确保SOUL.md中已定义“先验证后执行”原则，防止未经校验的URL被批量抓取；
4、调用web_scrape(url: str)函数测试采集效果，例如输入web_scrape("https://example.com")；
5、检查返回内容是否包含完整HTML结构及可提取文本，而非仅返回403或空响应。
三、启用本地文件数据采集模块
此方法通过tools/file_tools.py读取本地CSV、JSON或TXT格式的客户历史记录、销售台账等结构化数据，适合作为离线分析的数据源接入点。
1、将待采集文件存放于~/.hermes/data/inbound/目录下；
2、在config.yaml中配置file工具参数：
file:
enabled: true
allowed_extensions: ["csv", "json", "txt"]
max_file_size_mb: 50
3、设置环境变量HERMES_DATA_ROOT指向该目录路径，例如在~/.hermes/.env中添加：HERMES_DATA_ROOT=/home/user/.hermes/data；
4、调用file_read(path: str)函数并传入相对路径，如file_read("inbound/sales_q1.json")；
5、验证返回结果是否为合法JSON对象或按行分割的字符串列表，且无权限拒绝（PermissionError）报错。
四、配置定时数据采集任务（Cron调度）
该机制依托Hermes Agent内建的cron任务调度功能，实现能源数据、行情信息、新闻摘要等周期性采集任务的自动化触发，无需外部调度器介入。
1、在config.yaml的cron节区下新增采集任务定义：
cron:
- name: "daily_news_fetch"
schedule: "0 8 * * *"
task: "fetch_financial_news_from_sources"
- name: "energy_meter_poll"
schedule: "*/5 * * * *"
task: "collect_energy_metrics_via_api"
2、确保每个task名称已在skills/目录下存在对应Python模块；
3、检查agent/trajectory.py是否成功生成对应时间戳的采集记录条目；
4、手动触发一次任务验证逻辑：执行hermes cron run daily_news_fetch；
5、查看控制台输出是否含"Task completed: daily_news_fetch"及有效载荷内容。
五、启用Session Search记忆驱动采集
该方式不依赖外部接口，而是从Hermes Agent自身长期记忆库中检索历史采集结果，形成闭环式数据复用，适用于客户行为轨迹重建与上下文回溯场景。
1、在config.yaml中启用原生Session Search功能：
session_search:
enabled: true
index_strategy: "hybrid"
max_results: 10
2、确保已执行过至少一次终端或网页采集，使记忆库中存在可检索的trajectory数据；
3、调用search_memory(query: str, tool_type: str)函数，例如：search_memory("用户昨日点击的商品详情页", "web")；
4、确认返回结果中包含url、timestamp、content_snippet三项关键字段；
5、比对返回内容与原始采集日志是否一致，验证记忆索引准确性。
