1. 为什么一个 Hermes Agent 不够用多 Profile 的真实痛点如果你刚开始用 Hermes Agent大概率是单 Profile 一路走到底一个~/.hermes目录一份config.yaml一套 API Key一个飞书或 Telegram Bot。白天写代码靠它晚上查资料也靠它周末写点东西还是它。用着用着你会发现这个 Agent 开始精神分裂了。问题出在状态是共享的。你在 coding 场景里让它记住的项目约定会污染研究场景的对话上下文你为写作助手精心调教的 SOUL.md 人格在调试代码时反而成了干扰。更麻烦的是密钥和模型写代码想用推理强的模型查论文想用长上下文便宜的模型但config.yaml里model.default只有一个值每次切换都要手动改配置、重启 gateway改完还容易忘记改回来。我试过最笨的办法把不同场景的配置写成几个 yaml 文件用的时候cp覆盖。结果有一次覆盖错了把生产环境的 Bot Token 带进了测试 Profile两个 gateway 抢同一个 token第二个直接启动失败。那次之后我才认真去研究 Hermes 的 Profile 机制。Hermes Agent 的多 Profile 本质上是一套多实例隔离方案。每个 Profile 是一个完全独立的 Agent拥有自己的config.yaml、.env、SOUL.md、skills/、sessions/、memory/、logs/、cron jobs 和 gateway state。底层实现上Hermes 代码里有 100 多处通过get_hermes_home()解析路径Profile 机制通过设置HERMES_HOME环境变量让所有这些路径自动指向对应 Profile 的目录。默认 Profile 就是~/.hermes本身自定义 Profile 放在~/.hermes/profiles/name/下。这套机制适合谁同时管理多套模型、多套密钥、多套工具链的开发者。比如你既要维护一个 coding assistant又要跑一个研究 bot还想有个写作助手三者模型选择、记忆体系、技能树完全不同。硬塞进一个 Agent迟早出问题。而 Profile 让它们在同一台机器上各过各的互不干扰。这篇内容会从机制解析讲到可复制配置先给出 Profile 目录结构和创建方式再讲切换脚本和验证动作然后重点说明如何通过 TaoToken 统一 Key 和 API 通道接入最后用一次多 Profile 并发调用验证隔离效果。全程给可复制的命令和配置你跟着敲就能跑起来。2. TaoToken 前置统一 Key 与 API 通道接入 Hermes Agent在讲 Profile 配置之前得先把模型接入这条链路理清楚。多 Profile 场景下如果你每个 Profile 都去单独申请一套模型厂商的 Key管理成本会爆炸三个 Profile 就是三套 Key轮换、额度、计费全要分开盯。更现实的做法是用一个统一的 API 通道所有 Profile 共享同一个 Base URL 和 Key靠 Model ID 区分调用哪个模型。TaoToken 在这里扮演的就是统一通道的角色。它提供兼容 OpenAI 风格的 API 接口Hermes Agent 的model.base_url和model.api_key指向它即可。官网入口是 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 地址是 https://taotoken.net/api 这个不加 UTM。注意 API 地址后面通常要接/v1具体以文档为准。先说清楚它解决什么问题。Hermes 的模型配置在config.yaml里长这样model: default: anthropic/claude-sonnet-4 base_url: https://taotoken.net/api/v1 api_key: sk-xxxxxxxxdefault是 Model IDbase_url是请求地址api_key是鉴权凭证。多 Profile 模式下你可以让所有 Profile 共用同一个base_url和api_key只在default上做区分coder 用推理强的research 用长上下文的writer 用文风好的。这样密钥只有一份轮换时改一处即可。这里有个关键点Model ID 的写法要跟通道支持的命名一致。不同通道对同一模型的 ID 命名可能不同比如有的写claude-sonnet-4有的写anthropic/claude-sonnet-4。配置前先确认通道文档里列出的可用 Model ID别自己猜。我踩过的坑就是照搬了别处的 ID结果请求返回model not found排查了半天才发现是命名不对。获取 Key 的流程进入控制台创建 API Key然后到文档页确认 Base URL 和 Model ID 列表。控制台地址是 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite API Keys 管理页是 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。如果你主要做长期编码或 Agent 任务可以看 Coding Plan https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。想先在网页里验证模型是否可用用模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。为什么多 Profile 场景特别适合统一通道因为隔离的是状态不是接入凭证。Profile 隔离的是 sessions、memory、skills 这些运行时状态而模型接入是基础设施层的东西共享一份反而更好管理。你想想如果每个 Profile 一套 Key某天某个厂商调整了计费或限流你得逐个 Profile 去改统一通道的话改一处所有 Profile 生效。还有一点值得说统一通道让模型对比这个场景变得很轻。你想对比两个模型在同一个任务上的表现只需要建两个 Profiledefault填不同的 Model IDbase_url和api_key完全一样。跑完对比决定主力用哪个把其他 Profile 的default改过去就行不用碰密钥。配置写入的位置要记牢每个 Profile 的.env文件在~/.hermes/profiles/name/.envconfig.yaml在同级目录。默认 Profile 则是~/.hermes/.env和~/.hermes/config.yaml。下一节给出完整的可复制配置。3. 可复制配置Profile 目录结构、切换脚本与 settings 片段这一节是全文最实操的部分所有配置都可以直接复制。先看完整的目录结构理解每个文件放什么~/.hermes/ ├── config.yaml # 默认 Profile 全局配置 ├── .env # 默认 Profile 的 API Keys ├── hermes-agent/ # 源码 ├── sessions/ # 默认 Profile 会话 ├── skills/ # 默认 Profile 技能 └── profiles/ ├── coder/ # Profile: 编程助手 │ ├── config.yaml # Profile 专属配置 │ ├── .env # Profile 专属 API Keys │ ├── SOUL.md # Profile 人格定义 │ ├── skills/ # Profile 专属技能 │ ├── sessions/ # Profile 专属会话 │ ├── memories/ # Profile 专属记忆 │ └── logs/ # Profile 专属日志 ├── research/ # Profile: 研究助手 └── writer/ # Profile: 写作助手创建 Profile 有四种方式按需选# 1. 空白创建从零配置 hermes profile create coder # 2. 克隆配置只复制 config.yaml 和 .env状态为空 hermes profile create research --clone # 3. 完整克隆连 skills、memory、sessions 一起复制 hermes profile create backup --clone-all # 4. 从指定 Profile 克隆 hermes profile create dev --clone-from coder创建后每个 Profile 的config.yaml需要写入模型接入配置。以 coder 为例编辑~/.hermes/profiles/coder/config.yamlmodel: default: anthropic/claude-sonnet-4 base_url: https://taotoken.net/api/v1 api_key: sk-你的TaoToken密钥 terminal: cwd: /absolute/path/to/your/project display: busy_ack_enabled: false streaming: enabled: true transport: edit对应的.env文件~/.hermes/profiles/coder/.envTAOTOKEN_API_KEYsk-你的TaoToken密钥 FEISHU_APP_IDcli_xxxxxxxx FEISHU_APP_SECRETxxxxxxxxresearch Profile 的config.yaml只改 Model ID其余复用model: default: openai/gpt-4-turbo base_url: https://taotoken.net/api/v1 api_key: sk-你的TaoToken密钥注意base_url和api_key三个 Profile 完全一致只有default不同。这就是统一通道的价值。如果你用 Claude Code 或类似工具配置片段格式类似关键是三件套齐全Base URL、Key、Model ID。以settings.json为例{ env: { ANTHROPIC_BASE_URL: https://taotoken.net/api, ANTHROPIC_API_KEY: sk-你的TaoToken密钥, ANTHROPIC_MODEL: anthropic/claude-sonnet-4 } }Codex 的auth.json结构{ base_url: https://taotoken.net/api/v1, api_key: sk-你的TaoToken密钥, model: anthropic/claude-sonnet-4 }Cline MCP 配置里同样三件套{ mcpServers: { hermes: { command: hermes, args: [-p, coder, mcp], env: { BASE_URL: https://taotoken.net/api/v1, API_KEY: sk-你的TaoToken密钥, MODEL_ID: anthropic/claude-sonnet-4 } } } }切换 Profile 有三种方式。命令别名最省事创建时自动生成coder chat # 等同于 hermes -p coder chat coder gateway start # 启动 coder 的 gateway-p参数适合脚本里动态指定hermes -p coder chat hermes -p research gateway startSticky Default 适合某段时间主用某个 Profilehermes profile use coder # 之后 hermes chat 默认用 coder hermes profile use default # 切回默认 cat ~/.hermes/active_profile # 查看当前活跃 Profile批量管理脚本保存为~/.local/bin/hermes-gateways#!/bin/sh profilesdefault coder research writer for profile in $profiles; do if [ $profile default ]; then hermes gateway $1 else hermes -p $profile gateway $1 fi done加执行权限后使用chmod x ~/.local/bin/hermes-gateways hermes-gateways start # 启动所有 hermes-gateways stop # 停止所有 hermes-gateways restart # 重启所有每个 Profile 的 SOUL.md 定义人格写入~/.hermes/profiles/coder/SOUL.md你是一个专注的编程助手擅长代码审查和调试。 回答时优先给出可运行的代码再解释思路。记忆规则写入~/.hermes/profiles/coder/memories/MEMORY.md会在每次新会话注入系统提示用户已配置飞书 CLI (lark-cli) 并使用 User 授权。 创建、查看、修改日程必须使用 lark-cli calendar 命令系列。 默认操作日历应为用户个人日历 (primary)。这套配置的核心思路接入层共享状态层隔离。Base URL 和 Key 一份Model ID、SOUL、skills、memory 各自独立。下一节验证这套配置是否真的隔离。4. 验证请求与成功结果多 Profile 并发调用实测配置写完不验证等于没配。这一节用一次多 Profile 并发调用确认隔离效果。验证分三步单 Profile 请求通、多 Profile 并发不串、状态目录确实隔离。先验证单个 Profile 能正常请求模型。用 coder Profile 发一条最简单的消息hermes -p coder chat --message 用一句话说明什么是环境变量预期返回一段正常的中文回答。如果这一步就报错先别往下走去第 5 节排查。成功的话你会看到类似环境变量是操作系统或程序运行时用来存储配置信息的键值对 程序通过读取它来获取路径、密钥等外部配置。接着验证 research Profile 用的是不同模型。发同样的消息观察返回风格和速度差异hermes -p research chat --message 用一句话说明什么是环境变量两个 Profile 的default不同返回的措辞、长度、速度应该有可感知的差异。如果完全一样检查config.yaml里的default是不是真的改了。现在做并发验证这是确认隔离的关键。开两个终端同时发起请求# 终端 1 hermes -p coder chat --message 写一个 Python 函数计算斐波那契数列 # 终端 2同时执行 hermes -p research chat --message 总结一下 Transformer 架构的核心思想两个请求同时跑观察是否互相干扰。隔离正常的话两个会话各自独立coder 返回代码research 返回文字总结互不影响。如果出现串话比如 research 返回了代码说明HERMES_HOME没生效检查是不是用了-p参数。再验证状态目录隔离。分别查看两个 Profile 的 sessions 目录ls -la ~/.hermes/profiles/coder/sessions/ ls -la ~/.hermes/profiles/research/sessions/你会看到各自的会话文件文件名和时间戳不同。coder 的会话不会出现在 research 目录里这就是隔离的直接证据。验证 memory 隔离。往 coder 的 MEMORY.md 写一条规则然后看 research 是否读到echo 测试规则回答时用中文。 ~/.hermes/profiles/coder/memories/MEMORY.md hermes -p coder chat --message 你好 hermes -p research chat --message 你好coder 的回答会遵循中文规则research 不受影响。如果 research 也变了说明 memory 路径没隔离检查HERMES_HOME环境变量。验证 gateway 并发。同时启动两个 Profile 的 gatewaycoder gateway start research gateway start两个都启动成功后查看进程ps aux | grep hermes-gateway应该看到两个独立进程服务名分别是hermes-gateway-coder和hermes-gateway-research。如果第二个启动失败并报 token 冲突说明两个 Profile 用了同一个 Bot Token去各自的.env里改成不同的。最后验证 API 通道统一。三个 Profile 的请求都走同一个 Base URL你可以在 TaoToken 控制台的用量记录里看到调用来源。如果三个 Profile 的调用都出现在同一个账号下说明统一通道生效了。控制台地址 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。验证通过的标准单 Profile 请求通、并发不串话、sessions 和 memory 目录各自独立、gateway 进程独立、用量记录统一。这五条都满足说明多 Profile 隔离配置成功。任何一条不满足去下一节对照排查。5. 本篇常见错排查401、local proxy failed、reading choices、OAuth多 Profile 配置过程中报错集中在几个地方。这一节按真实报错逐个排查每个都给定位方法和修复步骤。报错一401 UnauthorizedError: 401 Unauthorized {error: {message: Invalid API key, type: invalid_request_error}}这是鉴权失败最常见。排查顺序# 1. 确认 .env 里的 Key 存在且没写错 grep TAOTOKEN_API_KEY ~/.hermes/profiles/coder/.env # 2. 确认 config.yaml 里的 api_key 引用了正确的变量 grep -A3 model: ~/.hermes/profiles/coder/config.yaml # 3. 直接用 curl 测试 Key 是否有效 curl -X POST https://taotoken.net/api/v1/chat/completions \ -H Authorization: Bearer sk-你的密钥 \ -H Content-Type: application/json \ -d {model:anthropic/claude-sonnet-4,messages:[{role:user,content:hi}]}如果 curl 也返回 401说明 Key 本身无效去控制台重新生成。如果 curl 成功但 Hermes 报 401说明 Hermes 没读到.env检查是不是把 Key 写到了错误的 Profile 目录。多 Profile 下最容易犯的错就是改错了.env文件。报错二local proxy failedError: local proxy failed: dial tcp 127.0.0.1:7890: connect: connection refused这个报错说明 Hermes 尝试走本地代理端口但代理没运行。多 Profile 场景下可能是某个 Profile 的.env里残留了HTTP_PROXY或HTTPS_PROXY环境变量。排查grep -i proxy ~/.hermes/profiles/*/.env ~/.hermes/.env如果有输出把对应的代理配置删掉。Hermes 直连 API 通道即可不需要额外代理。删完重启 gatewayhermes-gateways restart报错三reading choicesError: reading choices: unexpected end of JSON input这个报错通常出现在流式响应解析时原因是返回体不是预期的 JSON 结构。常见诱因有两个一是base_url写错了比如漏了/v1或者多写了路径二是 Model ID 不被通道支持返回了错误页面而不是 JSON。排查# 确认 base_url 格式 grep base_url ~/.hermes/profiles/coder/config.yaml # 正确格式应为 https://taotoken.net/api/v1 # 确认 Model ID 在通道支持列表里 # 去文档页核对https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite修复后重启对应 Profile 的 gateway。如果只有某个 Profile 报这个错对比它和其他正常 Profile 的config.yaml差异通常就在base_url或default这两行。报错四OAuth 授权失败 invalid_clientError: invalid_client: The client secret is invalid这个报错出现在 lark-cli 用户身份授权时。根因是lark-cli config bind时把 appSecret 存进了 keychain如果 bind 时用的是占位符后来在.env里改了真实值keychain 不会自动更新。修复步骤# 1. 确认 Profile 的 .env 里是真实的 appSecret grep FEISHU_APP_SECRET ~/.hermes/profiles/coder/.env # 2. 清除旧配置 lark-cli config remove # 3. 重新绑定 lark-cli config bind --source hermes --identity user-default --force # 4. 重新发起 OAuth lark-cli auth login --domain calendar --no-wait --json拿到device_code后完成授权lark-cli auth login --device-code device_code lark-cli auth statusauth status显示user身份status: ready和tokenStatus: valid就对了。报错五Token 冲突导致 gateway 启动失败Error: bot token conflict detected Profile research uses the same TELEGRAM_BOT_TOKEN as coderHermes 的 Token Lock 机制会阻止两个 Profile 用同一个 Bot Token。排查grep -H TELEGRAM_BOT_TOKEN\|DISCORD_BOT_TOKEN\|FEISHU_APP_ID \ ~/.hermes/.env ~/.hermes/profiles/*/.env输出里重复的值就是冲突源。去对应 Profile 的.env改成不同的 Token。飞书的话每个 Profile 需要独立的飞书应用和 App ID。报错六流式卡片不更新如果飞书流式卡片没反应按顺序排查# 1. 检查 streaming 配置 grep -A2 streaming: ~/.hermes/config.yaml # 应为 enabled: true, transport: edit # 2. 检查 sidecar 状态 python3 -m hermes_feishu_card.cli status --config ~/.hermes_feishu_card/config.yaml # 3. 检查 doctor 诊断 python3 -m hermes_feishu_card.cli doctor \ --hermes-dir ~/.hermes/hermes-agent --explain多 Profile 模式下sidecar 配置里每个 Profile 的飞书凭据必须独立设置顶层的FEISHU_APP_ID环境变量会被忽略。这是最容易踩的坑。排查的核心思路先确认是接入层问题还是状态层问题。401 和 reading choices 属于接入层检查 Base URL、Key、Model ID 三件套local proxy failed 和 Token 冲突属于环境层检查环境变量和 Token 唯一性OAuth 和流式卡片属于平台集成层检查凭据和 sidecar 配置。分层定位比盲目重启快得多。6. 语义一致 CTA把多 Profile 体系跑起来配置和排查都过了一遍最后说下怎么把这套体系真正用起来。多 Profile 的价值不在于能建多个而在于建了之后每个都稳定可用。稳定可用的前提是接入层不出问题而接入层最容易被忽视的就是 Key 和通道管理。统一通道的好处在这里体现得最明显三个 Profile 共享一份 Key轮换时改一处所有 Profile 生效用量在同一个控制台里看不用在多个厂商后台之间切换Model ID 集中管理想换模型只改default一行。如果你还在每个 Profile 单独配 Key建议尽早收敛到统一通道。具体入口按场景分需要管理 Key、创建新凭证、查看用量去 API Keys 页 https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。接入配置遇到问题、要核对 Base URL 和 Model ID 格式去接入文档 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。想先在网页里验证某个模型是否可用、对比不同模型的回答质量用模型对话页 https://taotoken.net/chat?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。如果你主要跑长期编码任务或 Agent 工作流Coding Plan 更适合 https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewrite 。回到多 Profile 本身几个实用建议。第一Profile 命名用场景而不是模型名比如coder、research、writer这样换模型时不用改目录名。第二SOUL.md 和 MEMORY.md 要持续维护它们是 Profile 人格和行为的核心比每次对话里纠正高效得多。第三批量管理脚本放在 PATH 里日常启停一条命令搞定。第四重大配置调整前用--clone-all备份一份改炸了能回滚。这套体系跑顺之后你会发现自己不再纠结该用哪个模型而是这个任务该交给哪个 Profile。coder 处理代码research 查资料writer 整理输出各司其职。需要协作时用 Kanban 看板拆任务需要临时拆分用delegate_task。从单兵作战升级到团队协作这才是多 Profile 真正的意义。最后提醒一句Profile 隔离的是状态不是接入凭证。Base URL、Key、Model ID 这三件套在每个 Profile 的配置里都要写全缺一个就会报错。配置写完记得用第 4 节的并发验证跑一遍确认隔离生效再投入日常使用。