Hermes起步配置：SOUL.md与主备模型没配好，等于装了个寂寞

1. 为什么你的 Hermes 装完像没装很多人第一次装 Hermes流程大概是这样的拉下来、跑起来、随便问两句然后心里冒出一句“这不就是个聊天壳子吗”接着就扔在一边吃灰了。问题往往不在 Hermes 本身而在于起步阶段最关键的几件事被跳过了——SOUL.md 没写、主备模型没配、doctor 命令没跑。结果就是它用一套默认人格、默认模型、默认记忆策略在跟你对话你自然感觉不到它和普通工具的区别。Hermes 的定位不是“装完即用的工具”而是一个需要你投入一点初始配置、之后越用越顺手的本地 AI 搭档。它和 OpenClaw 这类工具最大的差异恰恰藏在起步配置里SOUL.md 决定了它懂不懂你主备模型决定了它省不省 Tokendoctor 决定了你出问题时能不能自己救自己。这篇就按“起步即可用”的目标把这三块拆成可复制的步骤配置骨架直接给命令直接抄跑完你就能判断自己的 Hermes 到底有没有真正活过来。适合谁看正在本地搭 AI 工具链、已经装了 Hermes 但觉得“就这”的人以及准备从 OpenClaw 迁移过来的用户。全程不需要你懂底层原理跟着改文件、跑命令、看输出就行。2. 起步前先把 TaoToken 通道准备好Hermes 要调用模型就得有一个稳定的 API 入口。我自己的做法是统一走 TaoToken 的 API 通道好处是 Key 和地址集中管理主模型、备用模型、不同厂商的模型都能挂在同一个通道下配置里不用到处散落各家 Key迁移和排障都省事。你需要先拿到一个 API Key。打开控制台地址https://taotoken.net/console登录后在 API Keys 页面创建一个新 Key复制出来备用。这个 Key 就是后面 config.toml 里要填的凭证。关于接口地址统一用https://taotoken.net/api作为 base_url不要带任何多余参数。模型名称按你实际要用的填比如高阶模型用于记忆总结和技能创建免费或低价模型用于网页搜索这类杂活。TaoToken 的模型列表和接入文档在https://taotoken.net/doc配置前扫一眼确认模型名拼写能省掉后面一半的报错。注意Key 只创建一次就够不要每个模型配一个 Key。主备模型共用同一个 Key靠 model 字段区分这样 doctor 检查时也更容易定位问题。如果你还没决定用哪些模型可以先只配一个主模型把流程跑通等 doctor 通过后再加备用模型。起步阶段最忌讳一次配五六个模型结果哪个都不通排查起来头大。3. 可复制的 config.toml 骨架Hermes 的配置文件通常放在用户目录下的.hermes/config.toml具体路径以你安装版本的文档为准。下面这份骨架是我实测能跑通的结构主模型和备用模型分开写你可以直接复制后改字段值。# ~/.hermes/config.toml [provider] name taotoken base_url https://taotoken.net/api api_key sk-你的TaoToken密钥 [model] # 主模型负责记忆总结、技能创建等高价值任务 primary 你的高阶模型名 # 备用模型负责网页搜索、格式整理等重复性任务 fallback 你的免费或低价模型名 [model.params] temperature 0.7 max_tokens 4096 [soul] # SOUL.md 路径默认在配置同目录 path ~/.hermes/SOUL.md [memory] user_file ~/.hermes/user.md memory_file ~/.hermes/memory.md skills_dir ~/.hermes/skills state_db ~/.hermes/state.db [doctor] # 启动时自动检查配置 auto_check true几个字段说明一下。provider.base_url固定填https://taotoken.net/api不要加斜杠结尾。model.primary和model.fallback填模型名主模型建议选能力强的备用模型选免费或低价的这样贵的用在刀刃上杂活交给便宜的。soul.path指向你的 SOUL.md如果文件不存在Hermes 启动时会用默认人格这就是你觉得“没区别”的根源之一。SOUL.md 本身不用复杂起步阶段写清楚三件事就够你是做什么的、你希望它用什么语气、遇到不确定时先问还是先做。比如# SOUL.md ## 我是谁 我是一名后端开发主要用 Go 和 Python日常在本地做工具链搭建。 ## 沟通风格 直接给结论少客套。代码优先解释简短。不确定的地方先问我不要自己猜。 ## 工作习惯 改配置前先备份跑命令前先说明预期结果。遇到报错先给排查步骤不要直接重装。写完保存下次对话它就会按这个基调来。偷懒的办法也有先正常聊两天然后直接跟它说“根据我们的对话调整一下 SOUL.md”它会自己总结偏好写进去。4. 用 doctor 命令验证配置是否生效配置改完不验证等于没配。Hermes 自带hermes doctor命令专门用来检查配置、模型连通性和文件路径。跑之前先确认你已经保存了 config.toml 和 SOUL.md。hermes doctor正常输出会分几块provider 连通性、模型可用性、SOUL.md 加载状态、记忆文件路径。如果 provider 那块显示连接失败先检查 base_url 是不是写成了https://taotoken.net/api/多了斜杠或者 Key 有没有复制完整。模型可用性失败多半是模型名拼错回https://taotoken.net/doc对一下。想单独验证某个模型能不能通可以用hermes doctor --model primary hermes doctor --model fallback这会分别用主模型和备用模型发一个最小请求返回成功就说明通道没问题。我实测下来主备模型分开验证比一起验证更容易定位问题——如果一起跑失败你分不清是 Key 的问题还是某个模型名的问题。doctor 通过后再跑一次实际对话确认 SOUL.md 生效hermes chat 用一句话说明你现在的工作风格如果它回答的语气和你 SOUL.md 里写的一致说明人格加载成功。如果还是默认客套腔检查soul.path路径对不对或者文件是不是存成了.txt。5. 本篇常见错排查起步阶段报错集中在几个地方我踩过的坑列出来你对号入座。报错一provider 连接超时。先确认 base_url 是https://taotoken.net/api不要带 UTM 参数也不要写成别的路径。然后确认本机网络能正常访问该地址可以用curl https://taotoken.net/api看返回。如果 curl 通但 hermes doctor 不通检查 config.toml 里有没有多余空格或引号嵌套错误。报错二模型名无效。模型名区分大小写和连字符qwen3-coder和qwen-3-coder是两个东西。回文档复制不要手打。主备模型如果用了同一个名字doctor 不会报错但备用模型形同虚设记得区分。报错三SOUL.md 不生效。最常见的是路径写错。~在 toml 里不一定被展开保险起见写绝对路径比如/home/你的用户名/.hermes/SOUL.md。另外确认文件编码是 UTF-8中文内容用别的编码会乱码导致加载失败。报错四doctor 通过但对话没反应。检查model.params里的 max_tokens 是不是设得太小比如设成 100长回答会被截断。起步阶段设 4096 比较稳。如果还是没反应看 state.db 所在目录有没有写权限权限不足会导致会话无法创建。报错五从 OpenClaw 迁移后配置冲突。如果你跑了hermes migrate openclaw旧配置可能会覆盖新写的 config.toml。迁移完重新跑一次 doctor确认 provider 和 model 字段还是你新配的。迁移带过来的是技能和记忆模型通道建议重新配一遍。提示每次改完 config.toml 都跑一次hermes doctor不要攒着一起改。一次只改一个字段出问题立刻能定位到是哪次改动引起的。6. 配好之后Key 和文档从这里进起步配置跑通后日常最常打交道的两个入口一个是 API Key 管理一个是接入文档。Key 在https://taotoken.net/api-keys管理需要轮换或新增时从这里操作主备模型共用同一个 Key不用重复创建。接入文档在https://taotoken.net/doc模型名、参数、报错码都在里面配新模型前先查一眼能少走弯路。如果你主要用 Hermes 做长期编码或 Agent 任务建议把主备模型策略固定下来高阶模型走记忆总结和技能创建免费模型走搜索和格式整理这样 Token 消耗会明显下降。模型对话调试可以在https://taotoken.net/models里直接试确认模型可用再写进 config.toml。Coding Plan 适合需要长期跑编码任务的场景在https://taotoken.net/coding-plan看具体方案。配置这件事改完不验证等于没改。doctor 跑通、SOUL.md 生效、主备模型各发一次请求成功这三步做完你的 Hermes 才算真正起步。剩下的记忆维护和技能固化等用起来之后再慢慢补不用一次到位。