2.8 KiB
2.8 KiB
title, type, tags, date
| title | type | tags | date | |||
|---|---|---|---|---|---|---|
| Hermes Agent 配置笔记 | source |
|
2026-04-27 |
Source File
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
- 无明显冲突内容