49 lines
2.8 KiB
Markdown
49 lines
2.8 KiB
Markdown
---
|
||
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
|
||
- 无明显冲突内容
|