1. 项目概述为什么“2分钟拥有私人AI大脑”不是营销话术而是可落地的技术现实Hermes Agent 不是又一个调用大模型 API 的简单 wrapper它是一套真正具备“自我进化”能力的本地化 AI Agent 框架。我第一次在 Nous Research 的 GitHub 仓库看到它时就被它的设计哲学震住了它不满足于被动执行指令而是把每一次复杂任务的完成过程自动抽象、封装、测试、注册为一个可复用的 Skill——就像人类程序员写完一个函数后顺手把它加进自己的工具库。这个 Skill 会持续被后续任务调用、验证、优化形成一个正向循环。75000 Star 和 MIT 协议背后是它扎实的工程实现和清晰的架构分层。但标题里那个“2分钟”绝不是指从零开始到全功能上线的时间而是指在环境就绪的前提下核心框架的拉取、依赖安装、基础配置这最关键的三步确实可以压缩进两分钟内完成。真正的挑战在于“环境就绪”这四个字——Python 版本、Node.js 生态、浏览器二进制、包管理器源站任何一个环节卡住都会让这个“2分钟”变成“两小时”。这也是为什么网络上充斥着“hermes agent 安装超时”“playwright chromium 下载失败”这类热搜词。它们不是技术缺陷而是国内开发者面对全球开源生态时必须主动解决的基础设施适配问题。你不需要懂所有底层原理但必须知道每个环节的“开关”在哪里。比如uv不是 Python 的替代品而是新一代的、闪电般快速的 Python 包管理器和虚拟环境创建工具它比pipvenv组合快 10 倍以上playwright也不是一个简单的爬虫库而是一个能精准控制 Chromium 浏览器的自动化框架Hermes 用它来实现网页搜索、内容抓取等关键能力。理解这些工具的角色和痛点你才能在安装过程中像一个经验丰富的系统管理员一样而不是一个被报错信息淹没的新手。2. 核心技术栈拆解与国产化适配逻辑2.1 为什么是 Python 3.11版本锁死背后的性能与兼容性权衡Hermes Agent 的核心是 Python但它对版本的要求非常严格必须是 3.11 或更高。这不是随意设定的门槛而是有明确的技术动因。Python 3.11 引入了“快速启动”Faster CPython项目的核心成果其字节码解释器经过深度优化平均性能比 3.10 提升了 10%-25%。对于 Hermes 这种需要高频解析用户指令、调度多个异步工具、实时处理 LLM 流式响应的 Agent 来说毫秒级的延迟差异会直接累积成用户感知上的“卡顿”。更重要的是3.11 是第一个正式将ExceptionGroup和except*语法纳入标准库的版本这为 Hermes 复杂的错误恢复机制提供了原生支持——当一个 Skill 同时调用 Web 搜索、文件读取、API 调用三个工具时任何一个失败都不应导致整个流程崩溃而是要能精确捕获并隔离每个子错误。如果你强行用 3.9 或 3.10 安装大概率会在uv pip install -e .[all]这一步遇到ResolutionImpossible错误因为pyproject.toml中声明的依赖项如httpx0.24.0明确要求了python 3.11。此时pyenv就成了你的必备武器。它不是一个“高级玩具”而是现代 Python 开发者的生存工具。pyenv install 3.11命令背后是它为你自动下载、编译、安装一个纯净的 Python 3.11 解释器并将其与系统自带的 Python 完全隔离。我建议你永远不要用sudo apt install python3.11这种方式因为 Ubuntu/Debian 仓库里的 Python 版本往往带有发行版定制的补丁可能与 Hermes 依赖的某些 C 扩展如tokenizers产生 ABI 不兼容。pyenv global 3.11这条命令就是为你当前 Shell 会话设定了一个“语言环境”确保后续所有python命令都指向这个干净、可控的版本。这是整个安装流程最底层、也最重要的基石。2.2 uv超越 pip 的下一代包管理器为何它能成为提速关键uv是 Hermes Agent 官方指定的包管理器这绝非偶然。你可以把它理解为pip和venv的“超级融合体”一个命令就能完成虚拟环境创建、依赖解析、二进制轮子下载、编译安装的全部工作。它的核心优势在于“极简”和“极速”。uv venv venv --python 3.11创建一个虚拟环境耗时通常在 0.1 秒以内而uv pip install -e .[all]的速度是pip install -e .[all]的 5-10 倍。这种差距源于其底层架构uv是用 Rust 编写的它跳过了 Python 的 GIL全局解释器锁限制能充分利用多核 CPU 并行下载和解析依赖树。更重要的是uv对 PyPI 镜像源的支持是“原生”的、深度集成的。当你设置export UV_INDEX_URLhttps://mirrors.aliyun.com/pypi/simple/后uv会直接向阿里云镜像发起 HTTP 请求绕过所有中间代理和重定向。相比之下pip的镜像配置虽然也能生效但其内部逻辑更复杂有时会因为缓存或配置层级问题而失效。uv的另一个杀手锏是其“可重现性”Reproducibility。uv pip compile requirements.in -o requirements.txt会生成一个锁定所有依赖精确版本号的requirements.txt文件这保证了你在不同机器、不同时刻安装 Hermes得到的依赖环境是 100% 一致的。这对于调试和协作至关重要。如果你在安装过程中遇到Failed to build wheel for xxx的报错这几乎总是意味着你的系统缺少 C 语言编译工具链。在 Ubuntu/Debian 上sudo apt install build-essential python3-dev是必装项在 macOS 上则是xcode-select --install。这不是 Hermes 的 bug而是 Python 生态中大量高性能库如numpy,tokenizers需要本地编译的固有特性。uv只是把这个过程暴露得更早、更直接。2.3 Playwright 与 ChromiumAgent 的“眼睛”和“手”如何绕过网络墙Playwright 是 Hermes Agent 的“感官系统”。没有它Hermes 就是一个只能处理纯文本的“盲人”。它赋予了 Hermes 真正的“浏览网页”能力当你要查询“2024年最新显卡天梯图”Hermes 不是简单地把这句话丢给搜索引擎 API而是会启动一个真实的 Chromium 浏览器实例模拟人类操作——输入关键词、点击搜索、滚动页面、提取结构化数据。这个过程需要下载一个完整的、约 150MB 的 Chromium 二进制文件。问题来了这个文件默认从 Microsoft 的 CDNhttps://playwright.azureedge.net/下载而这个 CDN 在国内的访问体验用“九死一生”来形容毫不夸张。超时、中断、连接重置是家常便饭。这就是为什么“hermes agent桌面版安装超时”会成为一个高频热搜词。解决方案不是“等”而是“换”。export PLAYWRIGHT_DOWNLOAD_HOSThttps://npmmirror.com/mirrors/playwright这条命令就是把 Playwright 的“下载地址”这个开关从微软的服务器精准地拨到了国内的 npm 镜像站。npmmirror.com即淘宝 NPM 镜像是国内最稳定、最快速的开源资源分发节点之一它不仅托管了 npm 包也同步了 Playwright 的所有浏览器二进制。执行这条命令后再运行npx playwright install chromium你会发现下载速度瞬间飙升到 10MB/s 以上20 秒内搞定。如果你的机器上已经安装了系统级的 Chromium比如通过sudo apt install chromium-browser那甚至可以完全跳过下载步骤。只需设置export PLAYWRIGHT_CHROMIUM_EXECUTABLE_PATH/usr/bin/chromium-browser告诉 Playwright“嘿别下了直接用我本地这个就行。”这是一种典型的“务实主义”方案它不追求绝对的“纯净”而是以最快的速度达成目标。对于只想快速体验 Hermes 核心对话能力的用户你甚至可以在安装后立刻禁用 browser 工具hermes config set tools.browser.enabled false。这样hermes doctor就不会检查 Playwright 的状态整个流程会无比丝滑。等你哪天想用网页搜索功能了再回来单独执行PLAYWRIGHT_DOWNLOAD_HOST... npx playwright install --with-deps chromium即可。这是一种“渐进式启用”的智慧也是资深开发者区别于新手的关键思维。2.4 Node.js 22 与 npm 镜像为 WhatsApp Bridge 和前端工具铺路Hermes Agent 的野心远不止于 CLI 和网页搜索。它还内置了一个名为whatsapp-bridge的模块旨在让你能通过 WhatsApp 这个全球最流行的通讯软件与你的私人 AI 大脑进行无缝对话。这个桥接器的实现重度依赖 Node.js 生态。它需要npm来安装puppeteer另一个浏览器自动化库与 Playwright 形成互补、express用于创建一个轻量级的 Webhook 服务以及各种加密和消息协议库。因此Node.js 的版本要求是 22这同样不是随意定的。Node.js 22 是一个 LTS长期支持版本它包含了 V8 引擎的最新优化对WebAssembly的支持更加成熟这对于运行一些高性能的前端工具如 Hermes 自带的 TUI 界面渲染器至关重要。nvmNode Version Manager是管理 Node.js 版本的黄金标准。nvm install 22会为你下载、编译、安装一个纯净的 Node.js 22并将其设为默认。与pyenv类似nvm让你摆脱了系统包管理器的束缚拥有了对运行时环境的完全掌控。然而npm install本身也会遇到和pip类似的网络问题。npmjs.org的官方源在国内的访问速度常常比龟速还慢。npm config set registry https://registry.npmmirror.com这条命令就是为npm设置一个“国内专属通道”。npmmirror.com不仅是 Playwright 的镜像站更是整个 JavaScript 生态的“交通枢纽”。设置完成后npm config get registry的输出必须是https://registry.npmmirror.com否则配置无效。我建议你在执行cd ~/.hermes/hermes-agent npm install之前先手动进入scripts/whatsapp-bridge目录单独运行一次npm install --registryhttps://registry.npmmirror.com。这是因为whatsapp-bridge的package.json文件可能包含一些特殊的、对网络更敏感的依赖单独安装可以避免主项目安装脚本的干扰提高成功率。这体现了“分而治之”的工程思想把一个大而复杂的任务拆分成几个小而独立的、风险可控的子任务。3. 全流程实操指南从零开始的每一步详解与参数推演3.1 环境准备一份可直接复制粘贴的初始化清单在敲下任何一条安装命令之前请务必花 2 分钟确认你的系统已准备好以下“弹药”。这不是可选项而是硬性前提。请打开终端逐条执行并验证# 1. 检查并安装 Git几乎所有 Linux 发行版和 macOS 都已预装 git --version # 如果提示 command not found请根据你的系统安装 # Ubuntu/Debian: sudo apt update sudo apt install git # macOS: brew install git (需先安装 Homebrew) # 2. 检查并安装 pyenvPython 版本管理器 curl -fsSL https://pyenv.run | bash # 将以下三行添加到你的 ~/.bashrc 或 ~/.zshrc 文件末尾 export PYENV_ROOT$HOME/.pyenv command -v pyenv /dev/null || export PATH$PYENV_ROOT/bin:$PATH eval $(pyenv init -) # 重新加载配置 source ~/.bashrc # 或 source ~/.zshrc # 安装 Python 3.11 并设为全局默认 pyenv install 3.11.9 pyenv global 3.11.9 python --version # 输出应为 Python 3.11.9 # 3. 检查并安装 nvmNode.js 版本管理器 curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash # 将以下两行添加到你的 ~/.bashrc 或 ~/.zshrc 文件末尾 export NVM_DIR$HOME/.nvm [ -s $NVM_DIR/nvm.sh ] \. $NVM_DIR/nvm.sh # This loads nvm [ -s $NVM_DIR/bash_completion ] \. $NVM_DIR/bash_completion # This loads nvm bash_completion # 重新加载配置 source ~/.bashrc # 或 source ~/.zshrc # 安装 Node.js 22 并设为默认 nvm install 22 nvm use 22 node --version # 输出应为 v22.x.x npm --version # 输出应为 10.x.x # 4. 检查磁盘空间Hermes Agent 及其依赖总计需要约 2GB df -h ~ # 确保你的家目录~剩余空间大于 3GB留出缓冲 # 5. 安装系统级构建工具Ubuntu/Debian sudo apt update sudo apt install -y build-essential python3-dev libffi-dev libssl-dev # macOS 用户请运行xcode-select --install提示以上所有命令我都已在 Ubuntu 22.04 和 macOS Sonoma 上实测通过。如果你使用的是 Windows强烈建议放弃 WSL1直接使用 WSL2Windows Subsystem for Linux 2因为它提供了近乎原生的 Linux 内核体验能完美运行pyenv、nvm和playwright。在 Windows 上直接使用 CMD 或 PowerShell 安装 Hermes无异于自讨苦吃。3.2 核心安装国内镜像版一键脚本的深度解析与手动执行官方的curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/install.sh | bash命令在国内基本等于“宣告失败”。我们采用社区贡献的、经过充分验证的国内镜像版脚本。这个脚本的精妙之处在于它不是一个简单的“替换 URL”而是对整个安装流水线的国产化重构。第一步拉取代码解决 git clone 超时官方命令是git clone https://github.com/NousResearch/hermes-agent.git。我们的镜像版将其替换为git clone https://gitcode.com/GitHub_Trending/he/hermes-agent.git ~/.hermes/hermes-agent。GitCode是由华为云提供的、国内最稳定的 GitHub 镜像服务。它的优势在于1域名gitcode.com在国内 DNS 解析极快2CDN 节点遍布全国物理距离近3无需任何额外配置开箱即用。~/.hermes/hermes-agent是 Hermes 的标准安装路径它将所有文件集中在一个隐藏目录下便于管理和清理。如果你的网络环境极其特殊gitcode.com也不通脚本还提供了备选方案https://ghfast.top/https://github.com/NousResearch/hermes-agent.git这是一个基于反向代理的加速服务稳定性稍逊于 GitCode但作为兜底方案足够可靠。第二步安装依赖解决 uv 和 pip 源问题脚本会自动为你设置UV_INDEX_URL和PIP_INDEX_URL环境变量指向阿里云 PyPI 镜像。然后执行uv venv venv --python 3.11创建虚拟环境并激活它。紧接着它会执行uv pip install -e .[all]。这里的-e参数表示“开发模式安装”editable install这意味着你对hermes-agent代码库的任何修改都会立即反映在hermes命令中无需重新安装这对后续的调试和二次开发至关重要。.[all]是一个“可选依赖组”它会安装所有 Hermes 支持的功能包括cli命令行界面、cron定时任务、mcp多上下文规划、pty伪终端用于执行 shell 命令等。如果你只是想快速体验可以改为.[cli,mcp]这会节省大约 30% 的安装时间和磁盘空间。第三步安装 Node.js 依赖解决 npm 卡住脚本会进入hermes-agent目录执行npm install --registryhttps://registry.npmmirror.com。它还会专门进入scripts/whatsapp-bridge子目录再次执行npm install --registryhttps://registry.npmmirror.com。这种“双保险”策略确保了主框架和所有子模块的依赖都能被正确、完整地安装。第四步安装 Playwright解决 Chromium 下载失败脚本会设置PLAYWRIGHT_DOWNLOAD_HOST环境变量并执行npx playwright install chromium --with-deps。--with-deps参数会一并安装 Chromium 运行所必需的系统依赖如字体、多媒体库避免了后续运行时出现missing library的错误。一键执行# 方式一直接执行推荐最简单 curl -fsSL https://raw.githubusercontent.com/itech001/theaiera/main/scripts/install-cn.sh | bash # 方式二下载后检查再执行推荐给追求极致安全的用户 curl -fsSL https://raw.githubusercontent.com/itech001/theaiera/main/scripts/install-cn.sh -o install-cn.sh # 用 vim 或 nano 打开 install-cn.sh快速浏览其内容确认无恶意命令 vim install-cn.sh chmod x install-cn.sh ./install-cn.sh注意脚本执行过程中你会看到一个清晰的 ASCII 艺术框里面列出了所有正在使用的镜像源。这是脚本的“健康指示灯”如果它正常显示说明所有镜像配置都已生效。如果卡在某一步超过 2 分钟不要犹豫按CtrlC中断然后根据日志中的最后一行错误回到本文的“常见问题”章节进行排查。3.3 首次配置跳过向导手动编辑 config.yaml 的实战技巧hermes setup这个交互式向导听起来很友好但在国内网络环境下它往往是“陷阱”的开端。向导会引导你选择 LLM 提供商并尝试进行在线 API 连接测试。这个测试环节会直接访问api.deepseek.com、dashscope.aliyuncs.com等服务商的域名。虽然这些域名在国内是直连可用的但向导程序本身的网络请求库可能是httpx有时会因为 TLS 握手或 DNS 解析的问题而失败导致整个向导卡死。我的经验是永远不要信任向导永远手动配置。这是资深开发者的第一课。第一步创建配置文件目录mkdir -p ~/.hermes第二步创建并编辑config.yamlvim ~/.hermes/config.yaml将以下内容粘贴进去以 DeepSeek 为例这是目前对国内用户最友好的选择# ~/.hermes/config.yaml model: provider: deepseek name: deepseek-chat # 可选设置最大上下文长度DeepSeek 最高支持 128K max_tokens: 128000 providers: deepseek: api_key: ${DEEPSEEK_API_KEY} # 可选设置 API 基础 URL确保直连 base_url: https://api.deepseek.com/v1 tools: # 禁用 browser 工具避免首次启动时因 Playwright 未就绪而报错 browser: enabled: false # 启用文件操作工具这是最常用、最安全的工具 file: enabled: true # 启用终端命令工具让你能用自然语言执行 shell 命令 terminal: enabled: true # 可选设置默认的 Skill 存储位置 skill_dir: ~/.hermes/skills第三步创建.env文件存储密钥echo DEEPSEEK_API_KEYsk-your-actual-api-key-here ~/.hermes/.env提示DEEPSEEK_API_KEY的获取非常简单。访问 https://platform.deepseek.com 注册账号进入“API Keys”页面点击“Create API Key”即可。整个过程不到 2 分钟且免费额度充足。${DEEPSEEK_API_KEY}这种写法是 YAML 的环境变量引用语法hermes启动时会自动从~/.hermes/.env文件中读取该变量的值。这种方式比把明文 API Key 直接写在config.yaml里要安全得多也符合所有主流框架的最佳实践。3.4 验证与启动用hermes doctor和hermes命令进行终极检验安装和配置完成后不要急于启动对话先用 Hermes 自带的“体检医生”进行一次全面诊断。这是最能体现你安装是否成功的权威方式。# 运行诊断命令 hermes doctorhermes doctor会依次检查以下关键项检查项期望结果说明Python Version✅ Python 3.11.9确认pyenv配置成功Virtual Environment✅ Active virtual environment确认uv venv创建并激活成功Dependencies✅ All dependencies installed确认uv pip install成功Node.js npm✅ Node.js v22.x.x, npm 10.x.x确认nvm配置成功Playwright✅ Playwright is installed确认 Chromium 下载成功Model Provider✅ DeepSeek provider is configured确认config.yaml和.env配置正确API Key Test✅ API key is valid and accessible确认能成功调用 DeepSeek API如果所有检查项都显示✅恭喜你你的私人 AI 大脑已经组装完毕只待启动现在执行hermes你会看到一个基于rich库构建的、非常漂亮的 TUI文本用户界面。界面上会清晰地显示当前使用的模型名称deepseek-chat当前启用的工具列表file,terminal,browser等一个简洁的输入框❯现在你可以输入任何问题了。试试这个经典的开场白❯ 你好介绍一下你自己如果 Hermes 能流畅地、有逻辑地回复你那么整个安装流程就宣告圆满成功。你已经拥有了一个真正属于你自己的、可定制、可扩展、可进化的 AI 大脑。接下来你可以用hermes model命令切换到 Kimi 或 通义千问用hermes tools命令启用browser工具或者用hermes setup向导来配置 Telegram 机器人。一切都尽在你的掌控之中。4. 常见问题与独家避坑指南那些文档里不会写的血泪教训4.1 “git clone 超时”不是网络问题而是 DNS 问题很多用户报告git clone超时第一反应是“网络不好”于是去折腾代理。这是最大的误区。git clone超时90% 的情况是 DNS 解析失败而不是网络连接失败。GitHub 的域名github.com在国内的 DNS 解析记录经常被污染或返回错误的 IP 地址。解决方案不是换网络而是换 DNS。gitcode.com的强大之处就在于它的 DNS 解析在全球范围内都是稳定、快速的。所以永远优先尝试git clone https://gitcode.com/...。如果gitcode.com也不行再考虑ghfast.top。只有当这两个镜像都失效时才需要检查你的本地 DNS 设置如/etc/resolv.conf将其修改为114.114.114.114或8.8.8.8。4.2 “uv pip install 报错 ResolutionImpossible”依赖冲突的终极解法这个报错是uv和pip的“经典噩梦”。它意味着pyproject.toml中声明的依赖项之间存在无法调和的版本冲突。例如A 库要求requests2.28.0而 B 库要求requests2.28.0。uv的解析器会直接放弃抛出这个错误。最有效、最彻底的解决方法永远是“清空重来”。不要试图去手动修改pyproject.toml那只会引入更多未知风险。请执行以下三步# 1. 删除整个虚拟环境目录 rm -rf ~/.hermes/hermes-agent/venv # 2. 删除 uv 的缓存非常重要 rm -rf ~/.cache/uv # 3. 重新运行安装命令 cd ~/.hermes/hermes-agent uv venv venv --python 3.11 source venv/bin/activate uv pip install -e .[cli,mcp]~/.cache/uv是uv的全局依赖缓存。它会记住上次失败的解析结果并试图复用这反而会固化错误。删除它就相当于给uv一个“全新的大脑”让它从头开始、干净利落地解析整个依赖树。4.3 “npx playwright install chromium” 一直卡在 0%不是下载慢而是权限问题这是一个极其隐蔽的坑。npx playwright install chromium命令需要向~/.cache/ms-playwright目录写入文件。如果这个目录的权限被意外修改比如你之前用sudo执行过某些命令普通用户可能就没有写入权限了。此时命令会卡在Downloading chromium进度条永远是 0%并且没有任何错误提示。终极排查命令是# 检查 ~/.cache/ms-playwright 目录的权限 ls -ld ~/.cache/ms-playwright # 如果输出中没有 w写入权限或者所有者不是你就执行 sudo chown -R $USER:$USER ~/.cache/ms-playwrightchown命令会将该目录的所有权完全归还给你自己。这是 Linux 系统管理中最基础、也最容易被忽视的权限知识。4.4 “hermes doctor” 显示API key is invalid密钥格式与环境变量的双重校验这个报错通常有两个原因。第一个是密钥本身错误比如你复制时多了一个空格或者少了一个字符。第二个也是更常见的原因是环境变量没有被hermes进程正确读取。hermes是一个 Python 程序它启动时会读取~/.hermes/.env文件。但如果你是在一个新打开的终端里执行hermes doctor而这个终端的 Shell 并没有加载~/.hermes/.env那么hermes就读不到DEEPSEEK_API_KEY。最可靠的验证方法是# 在执行 hermes doctor 的同一个终端里先检查环境变量 echo $DEEPSEEK_API_KEY # 如果输出为空说明 .env 文件没有被加载 # 此时你需要手动加载它 source ~/.hermes/.env # 然后再运行 hermes doctorsource ~/.hermes/.env命令会将.env文件中的所有KEYVALUE行作为环境变量注入到当前 Shell 会话中。这是确保hermes能“看见”你的密钥的最直接、最可靠的方式。4.5 “hermes” 启动后界面空白或乱码TUI 渲染的字体与编码问题Hermes 的 TUI 界面依赖于终端的 Unicode 支持和字体渲染。如果你在 Ubuntu 的默认gnome-terminal或 macOS 的Terminal.app中看到一堆?或方块那几乎可以肯定是字体问题。解决方案是更换一个支持 Nerd Fonts 的终端字体。Nerd Fonts 是一套为开发者定制的、集成了大量图标符号的字体。下载并安装JetBrainsMono Nerd Font https://github.com/ryanoasis/nerd-fonts/releases/download/v3.2.1/JetBrainsMono.zip 然后在你的终端设置中将字体更改为JetBrainsMono Nerd Font。重启终端hermes的界面就会变得赏心悦目。此外确保你的终端编码是 UTF-8locale | grep LANG # 输出应为 LANGen_US.UTF-8 或 LANGzh_CN.UTF-8 # 如果不是请在 ~/.bashrc 或 ~/.zshrc 中添加 export LANGen_US.UTF-8 export LC_ALLen_US.UTF-85. 进阶应用与个性化定制让你的 AI 大脑真正“私人化”5.1 从 CLI 到桌面版利用hermes gateway搭建 Telegram 机器人CLI 是 Hermes 的起点但绝不是终点。hermes gateway命令是将你的私人 AI 大脑接入真实世界的“网关”。它支持 Telegram、Discord、Slack 等主流平台。以 Telegram 为例这是最简单、最快速的部署方式。第一步在 Telegram 创建 Bot打开 Telegram搜索BotFather。发送/newbot命令。按照提示为你的 Bot 起一个名字如MyHermesBot和用户名如my_hermes_bot必须以_bot结尾。BotFather 会给你一个API Token形如1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefg。请务必保存好这个 Token它就是你的 Bot 的“密码”。第二步配置 Hermes Gateway编辑~/.hermes/config.yaml在文件末尾添加gateways: telegram: enabled: true token: ${TELEGRAM_BOT_TOKEN} # 可选设置一个欢迎消息 welcome_message: 你好我是你的私人 AI 大脑 Hermes。你可以问我任何问题或者让我帮你执行任务然后在~/.hermes/.env文件中添加echo TELEGRAM_BOT_TOKEN1234567890:ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefg ~/.hermes/.env第三步启动网关hermes gateway telegram你会看到一条日志Telegram gateway started successfully! Listening for updates...。现在打开 Telegram搜索你刚刚创建的 Bot 用户名如my_hermes_bot点击Start。发送一条消息比如你好你的 Hermes 就会立刻回复你。整个过程不需要任何服务器、不需要任何云服务完全在你的本地机器上运行。你的 AI 大脑从此拥有了一个永不离线的、随时待命的“电话号码”。5.2 技能Skill的创建与管理让 Hermes 真正学会你的工作流Hermes 的核心魅力在于它的Skill系统。一个 Skill 就是一个可复用的、自动化的任务模板。官方文档里提到的“自我进化”指的就是 Hermes 能在你完成一个复杂任务后自动总结出这个任务的步骤并将其保存为一个 Skill。但作为初学者我建议你从“手动创建”开始这能让你深刻理解 Skill 的本质。创建一个最简单的 Skill自动整理下载文件夹创建 Skill 目录mkdir -p ~/.hermes/skills创建一个 YAML 文件vim ~/.hermes/skills/organize_downloads.yaml编写内容# ~/.hermes/skills/organize_downloads.yaml name: organize_downloads description: 将 ~/Downloads 目录下的文件按类型图片、文档、压缩包移动到对应的子文件夹 steps: - name: 创建子目录 action: terminal args: command: mkdir -p ~/Downloads/Pictures ~/Downloads/Documents ~/Downloads/Archives - name: 移动图片 action: terminal args: command: find ~/Downloads -type f \( -iname *.jpg -o -iname *.jpeg -o -iname *.png -o -iname *.gif \) -exec mv {} ~/Downloads/Pictures/ \; - name: 移动文档 action: terminal args: command: find ~/Downloads -type f \( -iname *.pdf -o -iname *.doc -o -iname *.docx -o -iname *.txt \) -exec mv {} ~/Downloads/Documents/ \; - name: 移动压缩包 action: terminal args: command: find ~/Downloads -