Hermes Agent国内安装指南：Python 3.11+、uv、Playwright镜像加速实战

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 包管理器和虚拟环境创建工具，它比pip+venv组合快 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中声明的依赖项（如httpx>=0.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_URL=https://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 与 Chromium：Agent 的“眼睛”和“手”，如何绕过网络墙

Playwright 是 Hermes Agent 的“感官系统”。没有它，Hermes 就是一个只能处理纯文本的“盲人”。它赋予了 Hermes 真正的“浏览网页”能力：当你要查询“2024年最新显卡天梯图”，Hermes 不是简单地把这句话丢给搜索引擎 API，而是会启动一个真实的 Chromium 浏览器实例，模拟人类操作——输入关键词、点击搜索、滚动页面、提取结构化数据。这个过程需要下载一个完整的、约 150MB 的 Chromium 二进制文件。问题来了，这个文件默认从 Microsoft 的 CDN（https://playwright.azureedge.net/）下载，而这个 CDN 在国内的访问体验，用“九死一生”来形容毫不夸张。超时、中断、连接重置，是家常便饭。这就是为什么“hermes agent桌面版安装超时”会成为一个高频热搜词。解决方案不是“等”，而是“换”。export PLAYWRIGHT_DOWNLOAD_HOST=https://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 界面渲染器）至关重要。nvm（Node 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 --registry=https://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. 检查并安装 pyenv（Python 版本管理器） 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. 检查并安装 nvm（Node.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，直接使用 WSL2（Windows 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 解析极快；2）CDN 节点遍布全国，物理距离近；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 --registry=https://registry.npmmirror.com。它还会专门进入scripts/whatsapp-bridge子目录，再次执行npm install --registry=https://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 分钟，不要犹豫，按Ctrl+C中断，然后根据日志中的最后一行错误，回到本文的“常见问题”章节进行排查。

3.3 首次配置：跳过向导，手动编辑 config.yaml 的实战技巧

hermes setup这个交互式向导，听起来很友好，但在国内网络环境下，它往往是“陷阱”的开端。向导会引导你选择 LLM 提供商，并尝试进行在线 API 连接测试。这个测试环节，会直接访问api.deepseek.com、dashscope.aliyuncs.com等服务商的域名。虽然这些域名在国内是直连可用的，但向导程序本身的网络请求库（可能是httpx）有时会因为 TLS 握手或 DNS 解析的问题而失败，导致整个向导卡死。我的经验是：永远不要信任向导，永远手动配置。这是资深开发者的第一课。

第一步：创建配置文件目录

mkdir -p ~/.hermes

第二步：创建并编辑config.yaml

vim ~/.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_KEY=sk-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 doctor

hermes doctor会依次检查以下关键项：

如果所有检查项都显示✅，恭喜你，你的私人 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 库要求requests>=2.28.0，而 B 库要求requests<2.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-playwright

chown命令会将该目录的所有权，完全归还给你自己。这是 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 doctor

source ~/.hermes/.env命令，会将.env文件中的所有KEY=VALUE行，作为环境变量注入到当前 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-8：

locale | grep LANG # 输出应为 LANG=en_US.UTF-8 或 LANG=zh_CN.UTF-8 # 如果不是，请在 ~/.bashrc 或 ~/.zshrc 中添加： export LANG=en_US.UTF-8 export LC_ALL=en_US.UTF-8

5. 进阶应用与个性化定制：让你的 AI 大脑真正“私人化”

5.1 从 CLI 到桌面版：利用hermes gateway搭建 Telegram 机器人

CLI 是 Hermes 的起点，但绝不是终点。hermes gateway命令，是将你的私人 AI 大脑接入真实世界的“网关”。它支持 Telegram、Discord、Slack 等主流平台。以 Telegram 为例，这是最简单、最快速的部署方式。

第一步：在 Telegram 创建 Bot

1. 打开 Telegram，搜索@BotFather。
2. 发送/newbot命令。
3. 按照提示，为你的 Bot 起一个名字（如MyHermesBot）和用户名（如my_hermes_bot，必须以_bot结尾）。
4. 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_TOKEN=1234567890: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：自动整理下载文件夹

1. 创建 Skill 目录：mkdir -p ~/.hermes/skills
2. 创建一个 YAML 文件：vim ~/.hermes/skills/organize_downloads.yaml
3. 编写内容：

# ~/.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 -