1. 凌晨三点告警没人看Hermes Agent 要解决的到底是什么问题Hermes Agent 是一个可以常驻在服务器上的个人 AI 助手框架它能通过 cron 定时任务在无人值守时自动执行对话、推送、数据整理等动作适合独立开发者、运维兼职党、以及想把重复性系统管理外包给 AI 的人。你不需要一直开着终端只要进程活着、cron 到点它就会自己跑。我试过最典型的场景是这样的白天写业务代码晚上跑数据同步凌晨两点监控告警响了人睡死第二天早上打开手机发现用户已经投诉完走人。问题不在于你不会处理而在于那个时间点你不在。Hermes Agent 的价值就是把「到点必须有人做」的事情交给一个常驻进程它不睡觉也不抱怨。它和普通聊天机器人的区别在于三点。第一它有调度层cron 表达式决定什么时候触发而不是你手动发消息。第二它有投递层跑完的结果可以推到飞书、微信、邮件等渠道而不是留在日志里。第三它有凭据与配置层模型走哪个通道、用哪个 Key、时区怎么算全部写在一份 config.yaml 里改一处就生效。这篇内容按「从零到常驻」的路径走先用 venv 把依赖隔离干净再写最小 config.yaml 把模型通道接上然后创建第一个 cron 任务最后做三步验证——本地单次对话、定时触发日志、常驻进程存活检查。全程命令可复制配置片段可直接改。需要提前说明的是模型接入部分我用 TaoToken 作为统一 Key 通道这样你不需要在 Hermes 里维护多家厂商的 Key一个 Base URL 加一个 Key 就能切换模型。官网入口在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 后面配置里会反复用到。环境基线建议 Ubuntu 22.04 LTS内存 4GB 起步实测 3.8GB 也能跑满基础功能。不需要公网 IP家里宽带或云主机都行。Python 用 3.10因为部分依赖对 3.11 的兼容还在追。下面从依赖隔离开始。2. venv 隔离与 Hermes Agent 安装别让系统 Python 被污染这一节解决的是「装完 Hermes 之后系统 Python 崩了」的问题。很多人第一次装 AI Agent 类项目直接sudo pip install结果系统包目录膨胀几百 MB未来升级 Python 全部失效。venv 隔离是必须动作不是可选项。先装基础依赖。Ubuntu 22.04 自带 Python 3.10但 venv 模块要单独装sudo apt update sudo apt install -y python3.10 python3.10-venv git确认版本python3.10 --version # 期望输出Python 3.10.x然后拉代码并创建虚拟环境。目录放在~/.hermes和后面 config.yaml 的默认路径保持一致git clone 你的 Hermes 仓库地址 ~/.hermes cd ~/.hermes python3 -m venv venv source venv/bin/activate pip install -e .pip install -e .是开发模式安装好处是你改代码不用重装。装完之后确认 hermes 命令可用which hermes # 期望输出/home/你的用户名/.hermes/venv/bin/hermes如果which hermes输出的是/usr/bin/hermes或空说明 venv 没激活成功回到source venv/bin/activate那一步重来。这一步踩过的坑最多因为很多人 clone 完直接开新终端venv 状态丢了。凭据文件权限要收紧。Hermes 会在~/.hermes/.env里存敏感信息Linux 下必须 chmod 600touch ~/.hermes/.env chmod 600 ~/.hermes/.env ls -l ~/.hermes/.env # 期望输出-rw------- 1 user user ... .env如果权限是-rw-r--r--说明 chmod 没生效检查是不是用了 sudo 创建文件导致属主不对。属主不对时先sudo chown $USER:$USER ~/.hermes/.env再 chmod。venv 隔离的核心原则只有一条所有 pip 安装都在激活状态下执行。判断方法很简单激活后命令行提示符前面会有(venv)字样。如果你在没激活的终端里pip install scikit-learn包会进系统目录未来 Python 升级全部失效。正确写法永远是source ~/.hermes/venv/bin/activate pip install scikit-learn装完之后可以用pip list确认包在 venv 里再用deactivate退出。这一步做完环境就干净了接下来写配置。3. config.yaml 最小配置用 TaoToken 统一 Key 接入模型通道这一节是全文技术核心。Hermes Agent 的控制中心就是~/.hermes/config.yaml200 多行的完整配置里 90% 用默认值真正要改的就三段模型通道、时区、投递。下面给最小可运行片段路径和字段名按 Hermes 实际结构写。先拿 TaoToken 的 Key。打开 https://taotoken.net/api-keys 登录后创建一个 API Key复制出来形如sk-xxxxxxxx。这个 Key 后面同时用于对话模型和 coding 场景不需要为每个模型单独申请。接入文档在 https://taotoken.net/doc 遇到字段疑问可以对照。然后编辑 config.yaml。最小配置如下注意 YAML 用两个空格缩进不要用 Tab# ~/.hermes/config.yaml model: provider: openai_compatible base_url: https://taotoken.net/api api_key: sk-你的TaoToken密钥 model_id: claude-sonnet-4-20250514 timeout: 120 timezone: Asia/Shanghai delivery: default: feishu feishu_home: oc_你的群ID credentials: feishu_app_id: cli_你的应用ID feishu_app_secret: 你的应用密钥三个关键字段解释一下。base_url必须是https://taotoken.net/api不要加 UTM 参数否则部分客户端会把它当查询串拼进请求路径导致 404。model_id可以换成你账号下可用的任意模型切换模型只改这一行Key 和 Base URL 不动。timezone写Asia/Shanghai因为 Ubuntu 默认 UTC不改的话 cron 的「早上 7 点」会变成中国时间下午 3 点。如果你用 Claude Code 或 Cline 这类工具配置结构类似三件套是 Base URL、Key、Model ID。以 Claude Code 的 settings 为例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: claude-sonnet-4-20250514 } }Codex 的auth.json结构不同但同样是三件套{ base_url: https://taotoken.net/api, api_key: sk-你的TaoToken密钥, model: claude-sonnet-4-20250514 }写完配置后做一次语法检查YAML 对缩进极其敏感python3 -c import yaml; yaml.safe_load(open(/home/$USER/.hermes/config.yaml)); print(YAML OK) # 期望输出YAML OK如果报yaml.scanner.ScannerError八成是 Tab 缩进或冒号后没空格。YAML 里key: value冒号后必须有一个空格key:value会被当成一个整体字符串。配置写完先别急着建 cron下一节先验证模型通道能不能通。这一步不通后面全是白搭。4. 三步验证本地单次对话、cron 触发日志、常驻进程存活配置写完必须验证否则你会在凌晨发现 cron 跑了但模型没回。验证分三步从简单到复杂每步都有明确的成功标志。第一步本地单次对话。在 venv 激活状态下执行source ~/.hermes/venv/bin/activate hermes chat --prompt 用一句话说明你现在能做什么成功标志是终端直接返回模型回复类似「我可以按 cron 定时执行任务并推送到飞书」。如果卡住超过 120 秒检查 config.yaml 里的timeout和网络。如果报 401说明 Key 不对或没生效回到上一节确认api_key字段。如果报local proxy failed说明 base_url 写错了确认是https://taotoken.net/api而不是带路径的地址。第二步创建第一个 cron 并看触发日志。用hermes cron create建一个每分钟跑一次的测试任务方便快速验证hermes cron create \ --schedule * * * * * \ --prompt 输出当前时间戳用于验证 cron 触发 \ --deliver origin \ --timeout 120--schedule * * * * *是每分钟触发--deliver origin表示结果推回创建来源。创建后列出任务确认hermes cron list等一到两分钟看日志tail -f ~/.hermes/logs/cron.log成功标志是日志里出现本次触发记录包含 prompt 和模型返回。如果日志里只有调度记录没有模型返回说明模型通道在 cron 环境下没读到 config.yaml检查 cron 执行时的工作目录和HERMES_CONFIG环境变量。如果报reading choices相关错误通常是返回体结构不符合预期确认 model_id 拼写正确。第三步常驻进程存活检查。Hermes 的 cron 调度依赖常驻进程进程死了 cron 不会触发。用 systemd 托管最稳sudo tee /etc/systemd/system/hermes.service /dev/null EOF [Unit] DescriptionHermes Agent Afternetwork.target [Service] Typesimple User你的用户名 WorkingDirectory/home/你的用户名/.hermes ExecStart/home/你的用户名/.hermes/venv/bin/hermes daemon Restartalways RestartSec10 [Install] WantedBymulti-user.target EOF sudo systemctl daemon-reload sudo systemctl enable --now hermes sudo systemctl status hermes成功标志是Active: active (running)。如果状态是failed用journalctl -u hermes -n 50看具体报错。常见的是 WorkingDirectory 写错导致找不到 config.yaml或者 venv 路径不对。三步都通过后把测试 cron 删掉换成真实任务hermes cron list hermes cron delete 任务ID到这里你的 24/7 助手就跑起来了。下面把常见报错集中排一遍。5. 常见报错排查401、local proxy failed、reading choices、OAuth这一节按真实报错对照每条给出症状、根因、正解。遇到问题先在这里找找不到再去看接入文档 https://taotoken.net/doc 。401 Unauthorized。症状是hermes chat直接返回 401。根因通常是 Key 没写对或没生效。检查顺序先确认 config.yaml 里api_key是完整的sk-开头字符串没有多余空格再确认.env里没有覆盖同名变量最后确认 Key 在 TaoToken 控制台是启用状态。如果 Key 是从别处复制带换行YAML 会把它当多行字符串用引号包起来。local proxy failed。症状是请求发不出去报连接失败。根因是base_url写错。正确值是https://taotoken.net/api不要写成https://taotoken.net/api/v1或带 UTM 参数的地址。UTM 参数会被拼进请求路径导致 404 或代理失败。如果你从浏览器复制了带?utm_source...的地址手动删掉问号后面全部内容。reading choices 相关错误。症状是模型返回了内容但解析失败报类似cannot read choices或choices is undefined。根因是返回体结构和客户端预期不一致。先确认model_id拼写正确不存在的模型会返回错误结构。再确认provider字段是openai_compatibleHermes 会按 OpenAI 格式解析choices[0].message.content。如果模型返回的是流式格式但客户端按非流式解析也会报这个错检查是否误开了 stream。OAuth 相关报错。症状是飞书投递时报 OAuth 或 token 失效。根因是feishu_app_id和feishu_app_secret不匹配或应用权限没开。正解是去飞书开放平台确认应用已发布、机器人能力已开启、oc_开头的群 ID 正确。如果报tenant_access_token获取失败检查应用密钥有没有复制错位。时区导致 cron 不按预期触发。症状是设了0 7 * * *但下午才跑。根因是系统时区是 UTC。正解是在 config.yaml 里写timezone: Asia/Shanghai同时确认 systemd 服务里没有覆盖 TZ 环境变量。可以用date命令确认系统时间用timedatectl看时区。venv 相关报错。症状是hermes: command not found或ModuleNotFoundError。根因是 venv 没激活或 systemd 里用了系统 Python。正解是 systemd 的ExecStart必须指向 venv 里的可执行文件即/home/你的用户名/.hermes/venv/bin/hermes不能写hermes。排查完这些基本能覆盖 90% 的首次部署问题。剩下 10% 多半是网络或账号配额看日志里的具体错误码即可。6. 从单次对话到长期编码把 TaoToken 通道用满跑通之后你可以把 TaoToken 的通道用在更多场景。Hermes Agent 只是其中一个消费方同一个 Key 还能接 Claude Code、Cline、Codex 等工具省去多平台维护 Key 的麻烦。如果你主要做长期编码或 Agent 类任务建议看一下 Coding Plan入口在 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。它适合需要持续调用、任务量较大的场景比按次计费更可控。想先验证模型效果可以直接用模型对话页面试https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。在网页里发几条 prompt确认返回质量符合预期再写进 config.yaml 的model_id。Claude Code 用户看这个接入页https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 。里面有三件套的完整配置示例和本文第 3 节的 settings 片段一致。控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 可以看用量和余额。API Keys 管理在 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content 需要轮换 Key 时在这里操作。最后给一个实用技巧把 config.yaml 里的model_id抽成环境变量这样切换模型不用改文件。在.env里写HERMES_MODELclaude-sonnet-4-20250514config.yaml 里写model_id: ${HERMES_MODEL}。Hermes 启动时会做变量替换改模型只改.env一行重启服务即可。这个做法在多环境部署时特别省事测试环境和生产环境用不同模型配置文件可以完全一致。
