本文指导从零部署本地hermes agent环境,完成日报生成等自动化流程:安装0.8.3版本、初始化项目、定义cron触发的github星标同步notion流程、配置github和notion密钥、验证语法、干运行调试、最后启动定时服务。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜

想让Hermes Agent自动处理日报生成、客户邮件分类、跨平台数据同步等重复性任务,不用写一行代码也能完成工作流编排——本文带你从零部署本地Hermes Agent环境,配置触发条件、连接真实API、调试执行逻辑,最后上线一个可稳定运行的自动化流程。
安装与初始化Hermes Agent本地运行环境
打开终端,执行命令安装核心依赖:pip install hermes-agent==0.8.3。注意必须指定0.8.3版本,【高版本会跳过本地LLM加载校验,导致后续工具调用直接失败】。
创建项目目录并进入:mkdir my-hermes-flow && cd my-hermes-flow。
运行初始化命令:hermes init。它会自动生成config.yaml和flows/文件夹——这两个是后续所有操作的起点,删掉就无法识别流程定义。
定义第一个自动化流程:每日9点自动抓取GitHub星标数并存入Notion
在flows/目录下新建文件github-stars-to-notion.yaml,粘贴以下内容:
name: github-stars-to-notion<br>trigger:<br> type: cron<br> schedule: "0 9 * * *"<br>steps:<br> - tool: http.get<br> url: https://api.github.com/repos/hermes-agent/core<br> - tool: notion.append<br> page_id: 1a2b3c4d5e6f7g8h9i0j<br> content: "⭐ {{ $.response.stargazers_count }} | {{ $.now }}"
这一步的关键是page_id必须替换成你Notion中目标页面的真实ID,格式为32位小写字母+数字组合。打开Notion页面→右上角「⋯」→「Copy link」→从链接末尾截取那一串字符,漏掉一位都会报404。
连接外部服务:配置GitHub Personal Token和Notion Integration Token
方法一:环境变量方式(推荐)
在项目根目录创建.env文件,写入两行:
GITHUB_TOKEN=ghp_xxx_your_token_here<br>NOTION_INTEGRATION_TOKEN=secret_xxx_your_notion_token
方法二:明文写入config.yaml(仅限测试)
打开config.yaml,在secrets:下添加:
github_token: ghp_xxx_your_token_here<br>notion_token: secret_xxx_your_notion_token
【不要同时使用两种方式,否则优先读取环境变量,config.yaml里的会被忽略】
调试与启动自动化流程
第一步:检查语法是否合法 → 运行hermes validate。如果提示Valid flow definition,说明YAML结构无误。
第二步:模拟单次执行 → 输入hermes run --flow github-stars-to-notion.yaml --dry-run。观察终端输出的HTTP响应状态码和Notion返回的page_id是否匹配,这是唯一能确认API连通性的方法。
第三步:正式启用定时任务 → 执行hermes start。进程会在后台持续运行,监听cron表达式触发。关闭终端窗口会导致服务中断,需要配合nohup或systemd管理。











