---
title: "Hermes Agent 配置笔记"
type: source
tags: ["hermes", "agent", "configuration"]
date: 2026-04-27
---

## Source File
- [[Agent/Hermes Agent 配置笔记]]

## Summary（用中文描述）
- 核心主题：Hermes Agent 的多角色配置与 Telegram 集成实战
- 问题域：Vibe Coding 多角色 Agent 场景下的身份隔离、Telegram Bot 连接与国内网络代理问题
- 方法/机制：SOUL.md 角色人设 + AGENTS.md 项目背景双文件分层；`hermes profile` 创建独立 Agent 实例；Gateway 代理配置解决 Telegram 连接问题
- 结论/价值：提供了一套完整的 Hermes Agent 多角色配置体系，覆盖身份定义、Profile 隔离、Telegram 接入、网络代理全链路

## Key Claims（用中文描述）
- SOUL.md 定义角色人设（全局生效，随 Agent 走），AGENTS.md 定义项目背景（项目级生效，随项目走），两者分工明确
- `hermes profile create --clone` 创建独立 Agent 实例，每个 Profile 拥有独立的 SOUL.md、配置、记忆、会话历史和技能
- Telegram Bot 无响应的根因通常是 Gateway 未启动、Token 配错 Profile 或用户 ID 未加入白名单
- Telegram 在国内被封，需在 Profile 的 .env 中配置代理（HTTPS_PROXY/HTTP_PROXY）才能正常连接

## Key Quotes
> "配置 token ≠ gateway 在运行，新 profile 需要单独启动。" — Telegram Bot 无响应的最常见原因
> "每个 profile 的 .env 需要单独配置，互不共享。" — 代理配置隔离原则
> "同一个 token 被两个 gateway 同时使用会导致两个 gateway 互相冲突，都无法正常收消息。" — Token 独占性要求

## Key Concepts
- [[SOUL]]：角色人设文件，定义 Agent 的身份、思维方式、沟通风格，位于 `~/.hermes/SOUL.md`
- [[AGENTS-md]]：项目背景文件，定义技术栈、架构、开发约定，位于项目根目录的 `AGENTS.md`
- [[Multi-Profile-Isolation]]：多 Profile 隔离机制，每个 Profile 拥有独立的配置、会话、记忆，实现角色分离
- [[Telegram-Bot-Gateway]]：Telegram Bot 通过 Hermes Gateway 接入，Gateway 需单独启动
- [[Proxy-Configuration]]：代理配置，通过 HTTPS_PROXY/HTTP_PROXY 环境变量解决 Telegram 在国内的连接问题

## Key Entities
- [[Marty-Cagan]]：《Inspired》作者，产品经理角色命名来源
- [[Werner-Vogels]]：Amazon CTO，架构师角色命名来源
- [[Hermes-Agent]]：本文档的主体工具，Vibe Coding 多角色 Agent 框架

## Connections
- [[Hermes-Agent]] ← configured_by ← [[SOUL]]
- [[Hermes-Agent]] ← configured_by ← [[AGENTS-md]]
- [[Multi-Profile-Isolation]] ← enables ← [[Hermes-Agent]]
- [[Telegram-Bot-Gateway]] ← depends_on ← [[Hermes-Agent]]
- [[Proxy-Configuration]] ← solves ← [[Telegram-Bot-Gateway]]

## Contradictions
- 无明显冲突内容