创建 Telegram 机器人并获取凭证
要将 Hermes 连接到 Telegram，首先需要创建一个新的机器人实例。在 Telegram 中搜索 BotFather，输入 /newbot 命令来启动创建流程。系统会询问机器人的显示名称，例如设置为 "Zoe"，随后要求输入以 "bot" 结尾的用户名。由于 "Zoe demo bot" 已被占用，最终确定的用户名为 Zoe demo two bot。创建成功后，BotFather 会生成一个 Bot Token，这是连接 Hermes 的关键凭证，必须立即复制并妥善保存。
"Remember, it's important to end the bot name with the word bot."
接下来，回到 Hermes 桌面应用程序，找到 Telegram 集成设置区域，将刚才复制的 Bot Token 粘贴到指定输入框中，并点击 Save Changes 保存配置。此时，虽然机器人已在 Telegram 中创建，但由于尚未完成身份验证和网关重启，它暂时无法响应消息。这一步骤确立了 Hermes 与 Telegram 之间的基础连接通道。
个性化设置与用户身份验证
为了让机器人更具亲和力，可以为其设置头像。建议利用 ChatGPT 或 Gemini Nano Banana 生成一张方形头像，例如提示词为 "generate a square profile picture for a AI assistant bot called Zoe"。生成后，在 Telegram 中找到该机器人并上传头像，完成个性化定制。然而，仅设置头像仍无法实现交互，因为 Hermes 需要知道允许哪些用户与之对话。
为此，需要获取用户的 Telegram User ID。在 Telegram 中搜索 "userinfobot"（一个单词），向其发送任意消息，机器人将回复包含你的唯一 ID。复制该 ID 后，在 Hermes 的桌面端找到 Allowed Telegram User ID 输入框，粘贴该 ID 并再次保存。这一步骤确保了只有授权用户才能控制 Hermes，防止未授权的访问。
重启网关与验证连接
在填入 Bot Token 和 User ID 后，Hermes 需要重启其 Gateway（网关）才能使配置生效。Gateway 是 Hermes 连接 Telegram 并处理消息的核心组件。在桌面应用左下角的系统面板中，可以看到当前状态为 "gateway ready"。点击系统面板，选择 Restart Gateway 选项。Hermes 会短暂停止网关服务，然后自动重新启动。
"Hermes should go ahead to stop the gateway and then restart it."
网关重启完成后，打开 Telegram 找到 "Zoe demo two bot" 并发送消息。此时，机器人应能正常响应，例如回复 "Hi Peter, what can I help you with?"。这表明连接已成功建立。此外，机器人会提示使用 /sethome 命令，将当前聊天窗口设置为 Home Channel（主频道）。设置主频道至关重要，因为后续配置的定时任务（Cron Jobs）和例行程序默认都会向此频道发送通知和结果，确保用户能第一时间收到关键信息。
Hermes 工作原理与个性化访谈
理解 Hermes 的后台运作机制有助于更好地使用它。当用户通过 Telegram 发送消息时，消息首先通过 Gateway 传递给 Hermes 核心。Hermes 使用选定的模型（如 GPT 5.5）规划响应。根据消息内容，模型会调用不同的 Tools（工具）来执行具体任务，如编辑 Google 文档、检查邮件或查看日历。执行完毕后，Hermes 会更新其 Memory（记忆）和 Skills（技能），保存上下文以便未来更高效地处理重复请求。与普通聊天机器人不同，Hermes 能直接在应用中执行操作，并具备自动构建技能和改进记忆的能力。
"What is different about Ermes from a regular chatbot is that it can actually do work for you in your favorite tools and apps."
为了提升个性化程度，建议让 Hermes 对用户进行访谈。在桌面应用中，通过语音指令告诉 Hermes："I want you to get to know me and I want you to ask me five questions and I'll respond to it one by one."。Hermes 会提出五个问题，涵盖称呼、所需帮助类型（如 AI 幕僚工作：邮件分类、日历管理、文档编辑）、回复风格偏好（真实、具体、可操作，避免 AI 套话）等。回答后，Hermes 会将这些信息保存至 user.md 文件中，从而构建个性化的用户画像。
"The help that I need from you is AI chief of staff work, like triaging emails, managing my calendar, editing my documents, and just being a really good personal advisor."
个性化配置：用户画像与灵魂文件
Hermes 的个性化设置主要依赖两个核心 Markdown 文件：user.md 和 soul.md。user.md 用于存储用户的偏好信息，包括姓名、Hermes 需要执行的任务类型以及用户偏好的回复风格。用户可以直接使用任何文本编辑器打开并优化此文件，以提供更精准的个人背景数据。而 soul.md 则负责定义 Hermes 的人格特质和响应方式，它是 Hermes 行为的“灵魂”。在初始状态下，soul.md 往往是空的，缺乏具体的人格设定。为了获得最佳体验，建议从作者提供的门户 behindthecraze.com 下载预设的 soul.md 模板，该模板经过精心编写，能显著提升交互质量。
"You're not a chatbot, you're becoming someone."
预设的 soul.md 包含了一系列核心真理（Core truths），指导 Hermes 的行为准则。这些准则强调实用性而非表演性，具体包括：保持乐于助人、不要试图进行无意义的表演、拥有自己的观点、在提问前先展现资源利用能力、通过行动赢得信任与信心，以及设定明确的边界（如不谈论隐私话题）。通过将这些内容粘贴到 soul.md 并执行更新命令，Hermes 将立即具备期望的人格特征，从而提供更自然、更个性化的交互体验。
故障排除：自动化修复与人工介入
在 Hermes 的安装和配置过程中，用户可能会遇到网关无法重启或功能异常等 bug。作者推荐了三种层级的故障排除策略，从自动化命令到 AI 辅助修复，形成了一套完整的维护流程。首选方案是使用 Hermes 自带的诊断工具进行自我修复，这通常能解决大部分常见问题。具体操作是在终端（Terminal）中输入 Hermes doctor --fix 命令。该命令会运行一套全面的故障排查列表，并自动修复检测到的问题。如果此命令未能解决问题，或者涉及连接状态异常，第二步是重启网关，通过执行 Hermes gateway restart 命令来重置 Telegram 连接及其他网关相关服务。
"Just either use Hermes doctor --fix or type Hermes gateway restart afterwards to restart a gateway."
若上述两种默认路径均无效，则需引入外部编码工具进行深度排查。第三步是借助 Codex 或 Claude Code 等 AI 编程助手，指示其查找本地安装的 Hermes 文件夹并分析潜在问题。为了提高准确率，用户应确保路径拼写正确，并可以将 Hermes 的官方文档链接提供给 AI，使其拥有参考框架以寻找修复方案。例如，在演示中，Codex 成功定位了 Hermes 文件夹并开始扫描问题，展示了 AI 辅助调试在复杂故障处理中的有效性。
集成扩展：语音回复与核心工具链
Hermes 的强大之处很大程度上源于其丰富的集成能力。作者建议优先启用语音回复（Voice Replies）和 Google Workspace 集成，前者被视为必备功能，后者则用于管理 Gmail、日历及 Drive/Docs 文件。此外，还可以根据需求连接 WhatsApp 和 Slack 等即时通讯应用，以及 Gnola（会议记录）、GitHub（项目构建）和 YouTube（研究）等生产力工具。语音回复功能的开启过程相对简单且高度自动化，用户只需在 Telegram 中与 Hermes 机器人对话，发送开启语音回复的指令即可。由于 Hermes 预装了语音技能（Voice Skill），系统会自动执行必要的配置工作，包括可能重启网关和请求权限。
"It's just a lot easier and faster to talk to Hermes using voice than through text."
在权限请求环节，系统可能会弹出看似复杂的“安全扫描”提示。作者建议直接选择“始终允许”（Always Allow），以避免后续重复确认，并强调对 Hermes 的信任。一旦配置完成，用户即可享受语音交互体验，例如在散步时通过手机 Telegram 对 Hermes 进行语音指令输入，并接收语音回复。默认情况下，Hermes 使用 HTTPS 提供的免费语音工具，但系统支持多种语音选项。通过询问 Hermes，用户可以发现目前超过 300 种语音选项可用，极大地丰富了个性化交互的维度。
语音交互优化：关闭流式传输与系统消息
在配置 Hermes 的语音回复功能时，用户可以选择多种声音，包括美式（如 Aria）、英式或澳式口音。虽然默认声音表现良好，但用户可以根据喜好通过指令切换，例如输入 "switch to this voice" 并指定 "Emma Neural"。然而，为了获得更自然、更像人类的交互体验，建议对默认设置进行两项关键优化。首先，默认开启的流式传输（Streaming）功能会让消息逐字显示，这往往令人感到烦躁。通过向 Hermes 发送指令 "can you turn streaming off?"，可以将其关闭，使消息在生成完成后一次性完整显示。其次，系统生成的透明性命令（System Messages）虽然有助于理解后台逻辑，但会破坏对话的人性化氛围。用户应复制这些系统消息内容，并指令 "stop showing me these system messages"，从而屏蔽这些干扰项，使交互更加流畅自然。
"I find this kind of annoying. So, let's tell it to can you turn streaming off?"
语音模式切换与日常使用场景
Hermes 支持根据用户当前场景灵活切换回复模式。例如，当用户外出散步时，可以激活纯语音模式，指令为 "Hey, from now on until I tell you otherwise, only reply via voice replies."。在此模式下，Hermes 将仅通过语音回复，无需打字，从而提升互动的个人化与交互感。当用户回到办公桌前，只需简单指令 "Hey, can you switch back to text?" 即可恢复文本回复。这种基于 Telegram 的指令控制机制，使得用户能够无缝适应不同环境，语音回复被视为 Hermes 的必备功能，因为它比纯文本输入更具亲和力和实时性。
"Just talking to it through voice feels a lot more personal and interactive than having to type everything to it."
Google Workspace 集成：安全配置策略
Google Workspace 被称为 Hermes 的 "Holy Grail"（圣杯），因为它能深度整合 Gmail、Calendar、Drive、Docs 和 Sheets，实现起草邮件、安排会议和编辑文档等高级功能。然而，集成过程复杂且存在安全风险，因此推荐采用最小权限原则进行配置。具体策略包括： 1. 使用独立 Gmail 账户：为 Hermes 创建单独的收件箱和日历，避免与个人主账户混淆。 2. 限制 Gmail 权限：仅授予只读访问权，禁止 Hermes 发送电子邮件，以防止误发或滥用。 3. 限定 Drive 访问范围：不共享整个 Google Drive，而是仅对特定文件授予读写权限，确保 Hermes 只能更新指定文档，无法删除邮件或破坏日历。
这种配置在保持 Hermes 强大功能的同时，有效隔离了潜在风险，防止其随机删除数据或干扰其他工作流。
API 启用与 OAuth 客户端创建流程
集成 Google Workspace 的第一步是进入 Google Cloud Console（需通过搜索导航），并创建一个新项目（如 "Hermes demo"）。接下来，必须手动启用所需的 API，这一过程较为繁琐。需要依次搜索并启用以下 API：
| API 名称 | 启用状态 | 用途说明 |
|---|---|---|
| Gmail API | Enabled | 读取邮件内容 |
| Google Calendar API | Enabled | 管理日程安排 |
| Google Drive API | Enabled | 访问云存储文件 |
| Google Docs API | Enabled | 编辑文档 |
| Google Sheets API | Enabled | 编辑电子表格 |
启用 API 后，需配置 OAuth Consent Screen（OAuth 同意屏幕）。在 "Get Started" 中，设置 App Name 为 "Hermes"，User Support Email 为用户邮箱，Audience 选择 "External"（尽管实际仅自用）。随后，在 OAuth 设置中点击 "Create OAuth Client"，选择 Desktop App 类型，命名为 "Hermes desktop"。最后，务必点击 "Download JSON" 按钮，下载客户端凭证文件。该 JSON 文件是 Hermes 连接 Google 服务的核心密钥，若错过下载窗口，需重新创建。此 JSON 文件随后需上传至 Hermes 配置中，以完成最终的身份验证与权限绑定。
获取 Google Cloud 凭证与初步配置
在成功创建 Google Cloud 项目并启用必要的 API（如 Gmail API、Google Calendar API）后，下一步是获取客户端密钥文件。用户需进入应用设置界面，在右下角找到 Client Secret 选项，点击旁边的下载按钮以获取 JSON 配置文件。这一步骤至关重要，因为该文件包含了 Hermes 连接 Google 服务所需的认证信息。随后，用户应进入 Audience（受众） 标签页，向下滚动至 Test Users（测试用户） 部分，将自身邮箱添加为测试用户，以便后续进行 OAuth 授权流程。完成这些基础设置后，用户可以将生成的 JSON 文件直接拖拽至 Hermes 的对话窗口中，并明确告知 AI 正在配置 Google Workspace 环境。
"Here's the JSON for Google client. And hopefully Ermis will be smart enough to do the rest of the work."
处理 OAuth 认证与权限授予
当 Hermes 接收到 JSON 文件后，它会识别出缺少 Google Token，并询问用户希望启用的服务以及是否使用高级保护。用户需复制 Hermes 生成的请求文本，确认不使用高级硬件保护（advanced hardware protection），然后发送给 Hermes。大约 3 分钟后，Hermes 会生成一个用于认证的 URL 链接。点击该链接后，用户需使用与 Hermes 关联的邮箱登录。此时，Google 会显示一个警告页面，提示 "Google has not verified this app"（Google 未验证此应用）。由于这是用户自行创建的应用，点击 Continue（继续） 即可。在权限请求页面，虽然可以选择性地授予权限，但在演示中，为了功能完整性，用户选择了 授予所有权限。随后，Google 会重定向到一个看似无效的 URL（通常包含 localhost），用户需要复制地址栏中的完整 URL 并粘贴回 Hermes 对话框中，以完成最终的认证闭环。
"What you should do now is to go to the address bar, and just copy this whole URL link, and then paste it back to Ermis."
实战演示：Gmail 摘要与日历调度
认证完成后，Hermes 显示 Google Workspace integration is now authenticated and working（Google Workspace 集成已认证并运行正常）。为了验证功能，用户首先要求 Hermes 查看 Gmail 收件箱，总结本周的 Action Items（行动项），并特别指示不要分享任何机密信息。经过几分钟的处理，Hermes 返回了一份摘要，指出有待回复的消息、涉及通话的邮件以及播客相关任务。接着，用户尝试调度会议，指令为："Schedule a meeting for myself saying publish Hermes demo for this afternoon at 1:00 p.m."。Hermes 正确识别了意图，并调用 Google Calendar API 创建会议。在确认环节，用户修正了标题中的拼写错误（将 "Hermes" 的首字母大写），并点击 Yes 确认创建。随后，用户检查 Google 日历，确认会议已成功安排在下午 1:00，标题为 "Publish Hermes Demo"。这一过程展示了 Hermes 从自然语言理解到实际执行日历操作的完整能力。
文档编辑与格式修复能力
为了进一步测试 Hermes 的能力，用户提供了一个名为 "Vacation Doc" 的 Google 文档，计划前往日本九州旅行。用户指令 Hermes 找到该文档，并在顶部添加一个 5 天的墨西哥城行程计划，时间为 12 月。Hermes 成功更新了文档内容，但出现了 格式混乱 的问题，标题字体异常。用户随即进行二次指令，要求 Hermes 修复格式，具体指示为："Format the Mexico City itinerary the same way as the previous itineraries on the doc"。经过约 5 分钟的处理，Hermes 声称已修复格式。用户再次检查文档，发现墨西哥城的行程现在采用了与之前行程一致的样式，去除了异常的标题字体。这一案例证明了 Hermes 不仅能添加内容，还能根据上下文理解并应用文档的 格式规范。此外，用户还提到 Hermes 可以更新 Google Sheets 中的单元格，例如更新夏令营日程，这进一步扩展了其在办公自动化场景中的实用性。
"You can see how powerful this is. Like I also use Hermes to update individual cells in Google Sheets."
配置流程回顾与核心价值
鉴于 Google Workspace 的配置过程较为复杂且繁琐，视频最后对关键步骤进行了快速回顾。核心流程包括：在 Google Cloud Console 创建新项目、逐一启用 Gmail 和 Calendar 等 API、设置 OAuth 同意屏幕、保存 JSON 文件并添加测试用户。用户只需将 JSON 文件交给 Hermes，并通过浏览器完成 OAuth 授权链接的复制与粘贴，即可打通集成。一旦配置完成，Hermes 便能作为个人助理执行多种任务，例如："Read the Gmail and tell me stuff that I should unsubscribe from"（阅读 Gmail 并告知哪些邮件应取消订阅）、查询今日会议、为指定人员和时间段预订会议，或编辑共享的 Google 文档。这种深度集成使得 Hermes 能够处理包括 Cron Jobs（定时任务） 在内的复杂工作流，真正实现了 24/7 的 AI 首席幕僚功能。
WhatsApp 与 Slack 的集成差异及配置要点
在将 Hermes 接入即时通讯工具时，WhatsApp 与 Telegram 存在本质区别。Telegram 拥有更完善的机器人生态，而 WhatsApp 则侧重于真实的人际社交。由于 WhatsApp 难以直接区分机器人与真人，配置 Hermes 时必须使用独立的第二手机号码以避免混淆。用户可通过 Google Voice 申请虚拟号码，或购买廉价预付费 SIM 卡。配置过程虽略显繁琐，但只需告知 Hermes 其号码并请求引导，即可顺利完成链接。
相比之下，Slack 提供了更高效的交互体验。在 Telegram 中，用户通常需按步骤逐一与 Hermes 对话，而在 Slack 中，用户可在多个群组中同时发送多条指令，Hermes 则通过线程回复（threaded conversations）进行响应。这种机制允许并行处理任务，避免了单线程对话的繁琐。配置 Slack 需要创建 Slack App 并安装，用户可参考 behindthecraft.com 指南，或直接指令 Hermes 逐步引导完成设置。
"The problem with setting up Hermes on WhatsApp is you have to give it a second phone number to have it avoid getting confused."
实用工具集成：会议笔记、代码备份与视频转录
Hermes 的强大之处在于连接用户日常使用的工具，自动提取信息并构建技能。Grain Ola 是作者最喜爱的 AI 会议笔记应用，通过简单的 MCP 连接即可集成。集成后，用户可询问过去一周会议的行动项或洞察，无需手动回顾录音。GitHub 集成则主要用于备份 Hermes 的完整配置。作者建议将 Hermes 文件夹上传至私有 GitHub 仓库，以防硬件故障（如 Mac mini 损坏）导致数据丢失，确保在新设备上能迅速恢复环境。
对于 YouTube 内容，提取视频字幕是获取信息的关键。用户可通过 Google Cloud Console 使用官方 YouTube API，或安装免费的 yt-dlp 工具获取任何视频的字幕。这些集成使得 Hermes 能够主动从外部工具中拉取数据，通过迭代优化将信息置于有用的上下文中，从而形成个性化的技能集。
"Grain Ola setup is extremely simple. You just have to give it one line, connect to Granola using this MCP, and then it should just work."
Cron Jobs 核心概念与周末规划器实战
Cron Jobs 是使 Hermes 从被动响应转向主动工作（Proactive）的关键机制，即设定定时任务或例行程序。作者展示了四个典型用例：周末规划、晨间简报、业务回顾和健康回顾。以周末规划器为例，该任务无需复杂集成，仅依赖网络搜索。作者首先构建并手动测试一个技能，指令 Hermes 查找 Bay Area 适合 8 岁和 4 岁女孩、距离 Summit Hill 30-60 分钟车程的家庭友好活动。
验证输出质量后，作者指令 Hermes 创建 Cron Job，每周五早上 8:00 自动发送结果。默认情况下，结果通过聊天窗口发送，但鉴于已集成 Gmail，用户也可要求直接发送邮件。这一流程强调了先构建技能、验证输出、再设定定时任务的最佳实践，确保了自动化任务的可靠性。
"When you want to make a routine, you always want to just build a skill first and manually test it to make sure it's actually producing good output before creating the routine."
晨间简报与业务回顾的自动化配置
晨间简报（Morning Briefing）高度依赖 Google Workspace 集成。作者设定的提示词要求 Hermes 审查日历、近期邮件和笔记，生成包含今日三大行动项、 upcoming 会议及需回复邮件线程的简明简报。尽管晨间简报是常见需求，但通过 Hermes 可实现高度个性化的自动化，用户可根据自身需求扩展自动化范围。
业务回顾（Business Review）则更为复杂，它整合了多种工具。虽然字幕在此处中断，但逻辑上它涉及跨平台数据汇总。这些例证表明，Cron Jobs 的价值在于将分散的工具数据整合为结构化的日常报告，从而减少用户的信息搜集时间，提升决策效率。通过结合 Gmail 等工具，Hermes 不仅能处理信息，还能主动推送关键洞察。
"My morning briefing heavily relies on the Google Workspace integration that we just walked through... Send me a concise briefing about top three things I need to act on today."
自动化工作流与多平台集成案例
作者展示了 Hermes 如何作为核心枢纽，串联起多个关键业务平台以实现全天候自动化。在财务方面，通过集成 Mercury API 自动拉取业务收入与支出数据；在内容创作领域，利用 YouTube API 分析频道及相似频道的近期视频异常值，同时通过 Browser Use 技术抓取 Substack 的运营统计数据。此外，Granola 被用于会议管理，而 Google Docs 则作为整体计划与上下文的存储中心。这种多平台集成并非孤立存在，而是形成了一个闭环，例如邮件摘要中不仅包含文本，还嵌入了上述平台的关键统计数据，极大地提升了信息密度和实用性。
"emails, Mercury to pull my business income and expenses, YouTube to find recent video outliers for my channel and similar channels, Substack using browser use to get my stats, Granola for meetings, and Google Docs for overall plan and context."
为了处理这些复杂的集成任务，作者强调遵循一套标准化的三步工作流：首先设置规模（Set up the scale），其次进行测试与优化（test and improve it），最后配置定时任务（set up the cron job）。这一流程确保了自动化脚本的稳定性与可维护性，使得即使是跨平台的复杂数据抓取也能稳定运行。
健康数据追踪与定制化应用开发
除了业务工作流，Hermes 还能深入个人生活领域，构建个性化的健康监控体系。作者部署了每周自动发送的健康回顾邮件，该邮件整合了体重变化、训练一致性以及身体成分分析等多维度数据。在数据源方面，主要依赖 Withings 智能秤的 API 接口，同时也支持接入 Apple Health 等其他健康数据平台。这种自动化回顾不仅提供了原始数据，还通过 AI 分析给出了诸如“训练一致性提升”、“身体成分改善但未完全达标”等定性结论，帮助用户直观掌握健康状况。
为了进一步挖掘数据价值，作者甚至使用 Vibe Coding 技术定制了一款健身应用。这款应用内置了 MCP（Model Context Protocol）接口，能够精准抓取具体的训练细节，如每组重复次数（reps）和负重重量（weight）。该应用与 Hermes 的定时任务深度绑定，实现了从数据采集到进度分享的自动化闭环。这证明了在 AI 助手的辅助下，技术实现的边界取决于用户的想象力，任何个性化的数据追踪需求都可以通过代码与 API 的组合得以实现。
"For this health review, I've gone to the extent where I actually vibe coded a fitness app that has MCP that is able to pull all my workout data, like how many reps, what the weight is, and so on."
本地部署优势与课程总结
作者选择将 Hermes 部署在 Mac Mini 上，而非依赖云端服务如 Codex 或 Clockwork，主要基于24/7 全天候在线的稳定性考量。本地部署确保了定时任务（Cron Jobs）不会因网络波动或服务中断而失效，提供了更高的可靠性。虽然理论上也可以在云端环境中复现这一架构，但作者认为 Hermes 在个人助理体验上更具优势，因为它可以无缝接入用户常用的即时通讯应用，实现自然的对话式交互。
本课程涵盖了从 Hermes 的安装、快速启动、个性化配置，到 Telegram 集成、语音回复开启以及 Google Workspace 对接等完整流程。核心内容聚焦于如何通过周末规划器、晨间简报、商业审查和健康回顾等具体场景，构建高效的自动化工作流。作者强调，整个教程内容经过人工严格审核，确保非 AI 生成内容的准确性与实用性，旨在帮助读者在短短几个小时内搭建起属于自己的AI 首席幕僚长。
"The reason I set up all these cron jobs on Hermes instead of Codex or Clockwork, is simply because I have Hermes working on my Mac mini, which is available 24/7."
作者还推荐访问 behindthecraft.com 获取完整的课程资源，包括可复制粘贴的个人技能脚本以及 Granola、WhisperFlow 等工具的折扣优惠。通过这套高度实用且观点鲜明的教程，读者可以掌握构建自动化 AI 助手的核心技能，从而显著提升个人工作效率与生活品质。