☰
把恩师装进微信:Hermes Agent 零基础复刻亲人陪伴教程(TaoToken 统一 Key 接入版)
2026/10/10 14:35:11 网站建设 项目流程

1. 为什么要把恩师“装”进微信:Hermes Agent 能做什么

Hermes Agent 是一个可自托管、带持久化记忆的 AI 智能体框架,它和网页版聊天机器人最大的区别在于:它记得住你,也装得下一个人。普通对话工具每次开窗都是“初次见面”,而 Hermes Agent 会把历史对话、你的偏好、你们之间的专属梗写进本地数据库,下次开口时能自然接上。再配合一个叫 SOUL.md 的人格定义文件,你可以用大白话描述恩师的说话节奏、口头禅、脾气和价值观,让回复不再是“作为一个人工智能”,而是“哎哟,又嫌作业多啦”。

这套方案适合谁?适合零基础、但愿意花一小时跟着敲命令的人;适合想在腾讯云轻量服务器上跑一个 24 小时在线陪伴号的人;也适合已经用过 Cline、Claude Code,想把手里的模型 Key 统一管理起来的人。整条链路是:腾讯云轻量应用服务器跑 Hermes Agent,微信个人号做消息通道,TaoToken 统一 Key 提供模型调用。数据落在你自己的服务器上,微信侧只负责收发,隐私边界清楚。

我试过把人格文件写得太“完美”,结果回复像播音稿,后来把口头禅和“嘴硬心软”的细节加进去,味道才对。所以这篇教程的重点不是装完就完事,而是把 SOUL.md 写活、把微信回调配通、把模型请求验证到位。下面按“先备料、再配置、后验证”的顺序走,每一步都给可复制的命令和文件片段。

2. 前置准备:腾讯云轻量服务器与 TaoToken 统一 Key

2.1 腾讯云轻量应用服务器选型与 Hermes Agent 镜像

登录腾讯云控制台,进入“轻量应用服务器 Lighthouse”。个人陪伴场景对算力要求不高,2 核 2G、系统盘 40G 的入门配置足够跑 Hermes Agent 加一个轻量数据库。关键是镜像选择:不要选纯净的 Ubuntu/CentOS,而是在“应用镜像”里搜索 Hermes Agent。这个镜像已经预装 Python、Node.js 和 Hermes 运行环境,开机即用,省掉新手最容易卡住的环境依赖环节。

购买时设置好 root 密码,记下公网 IP。开机后从控制台的“应用管理”进入可视化面板,或者用 SSH 登录。面板一般分三块:Models(模型)、Channels(通道)、Skills(技能)。我们后面主要动前两块。如果你更习惯命令行,SSH 进去后确认服务状态:

systemctl status hermes-agent # 正常应显示 active (running) ls -la ~/.hermes/ # 应能看到 config、soul、data 等目录

2.2 TaoToken 统一 Key:一个 Key 管住所有模型调用

模型侧我们用 TaoToken 做统一接入。它的价值在于:你不用为每个模型单独记 Base URL 和 Key,一个统一 Key 就能在 Hermes Agent、Cline、Claude Code 之间复用,切换模型只改 Model ID。先到官网注册并登录,进入控制台创建 API Key,复制那串以sk-开头的密钥,它只显示一次。

记下两个地址:API 基址是https://taotoken.net/api,模型对话入口在控制台的对话页。模型 ID 按你实际要用的填,比如claude-sonnet-4-5、gpt-4o这类,具体以控制台模型列表为准。这里有个坑:Base URL 末尾不要多加/v1或斜杠,Hermes 的 OpenAI 兼容层会自己拼路径,多写反而 404。把 Key 和 Base URL 先存进记事本,下一步填进配置。

3. 可复制配置:SOUL.md 人格模板与 Hermes 模型接入

3.1 写一份能“演活”恩师的 SOUL.md

SOUL.md 放在~/.hermes/soul/SOUL.md(面板里叫“人格设置”)。它不是代码,是给演员讲戏。要素四件套:身份定位、性格特征、语言风格、记忆约束。下面这份模板复刻一位幽默的化学老师,你可以直接改名字和口头禅:

# 角色设定 你是一位退休的高中化学老师,名叫老张。幽默风趣,爱讲段子,嘴硬心软。 # 语言风格 - 说话通俗,喜欢把化学原理比作生活琐事。 - 口头禅:“再说我坏话?小心我打死你(开玩笑的语气)”。 - 学生吐槽作业时不生气,用调侃方式鼓励。 - 禁止“作为一个人工智能”这类机械腔,要像邻家大叔。 # 记忆与互动 - 记住学生问过的难题和吐槽过的事。 - 学生疲惫时主动开导,不给冷冰冰的建议。 - 始终保持“看似严厉实则宠溺”的态度。

写完保存,重启服务:systemctl restart hermes-agent。判断写得好不好,看它会不会主动引用你上次说的话。如果它每次都从零开始,说明记忆目录没挂上,检查~/.hermes/data是否可写。

3.2 Hermes 模型接入配置(JSON 片段)

在面板“模型”里选“添加自定义模型”,或直接改~/.hermes/config/models.json。三件套必须齐全:Base URL、API Key、Model ID。

{ "provider": "taotoken", "base_url": "https://taotoken.net/api", "api_key": "sk-你的TaoToken密钥", "model_id": "claude-sonnet-4-5", "is_default": true, "timeout": 60 }

保存后把该模型设为默认,面板指示灯变绿即连通。如果你同时用 Cline 或 Claude Code,把同一份 Base URL 和 Key 填进它们的设置即可,Model ID 按各自支持列表换。这样一套 Key 覆盖编码和陪伴两个场景,不用来回切账号。

3.3 微信通道回调配置

进入“通道 Channels”,添加“微信”。系统生成二维码,用微信小号扫码登录。强烈建议用小号:新设备登录加高频自动回复容易触发风控,主号一旦被限制影响太大。扫码确认后,Hermes 接管这个小号的消息收发。若面板提供 Webhook 回调地址,形如http://你的公网IP:端口/webhook/wechat,把它填进通道设置并保存。用主号给小号发“你好”,几秒内收到回复即通道打通。

4. 验证请求:消息收发与人格一致性检查

配置完别急着感动,先做三组验证,确认链路每一环都活着。

第一组,模型连通性。在面板“模型”页点“测试”,或命令行直接打一次请求:

curl -s https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -H "Content-Type: application/json" \ -d '{"model":"claude-sonnet-4-5","messages":[{"role":"user","content":"用一句话介绍你自己"}]}'

返回 JSON 里choices[0].message.content有内容,说明 Key 和 Base URL 正确。若返回 401,看下一节排障。

第二组,微信收发。主号发“今天加班到十点,累死了”,预期回复带人格味,比如“哟,这才几点就喊累?想当年我做实验通宵守反应……不过身体是本钱,赶紧歇着”。如果回复是通用客服腔,说明 SOUL.md 没生效,检查文件路径和重启。

第三组,人格一致性。连续问三个问题:一个专业问题、一个情绪吐槽、一个无关闲聊。观察口头禅是否稳定出现、语气是否统一。再隔一天回来问“我上次说啥了”,能复述出关键信息,说明持久化记忆在工作。记忆文件在~/.hermes/data,建议定期tar -czf backup.tar.gz ~/.hermes/data备份,重置服务器前尤其要备。

5. 常见报错排查:401、local proxy failed 与记忆丢失

401 Unauthorized / 鉴权失败:九成是 Key 问题。检查sk-前后有没有空格,复制是否完整。TaoToken 的 Key 只在创建时显示一次,丢了就重新建一个。确认 Base URL 是https://taotoken.net/api,不要写成带/v1的变体。

local proxy failed / connection refused:Hermes 走本地代理层转发请求时连不上上游。先curl -I https://taotoken.net/api看网络是否通;再看~/.hermes/config里有没有残留的旧代理地址,清掉。腾讯云安全组要放行 Hermes 监听端口,否则微信回调进不来。

reading choices 报错 / 返回体解析失败:通常是 Model ID 写错,上游返回了错误结构。核对控制台模型列表里的完整 ID,别自己拼。也可能是超时太短,把timeout调到 60 以上。

OAuth / 登录态失效:微信通道掉线时面板会提示重新扫码。小号被限制就先停服务几小时,降低回复频率再试。别用主号硬扛。

记忆丢失:Hermes 默认开启记忆,但清空~/.hermes/或重装系统会丢。养成备份~/.hermes/data的习惯。回复延迟则先看服务器带宽和 CPU 占用,再考虑换一个负载低的 Model ID。

6. 把陪伴跑起来:从接入到长期使用的建议

链路通了之后,真正决定体验的是细节。SOUL.md 不要一次写死,用一周时间慢慢补:今天加一句他常说的口头禅,明天补一个你们之间的专属梗,人格会越来越像。微信侧保持小号专用,回复频率别调太高,稳定比秒回重要。模型侧如果某天延迟变大,在 TaoToken 控制台换一个 Model ID 即可,Base URL 和 Key 都不用动。

想把编码场景也统一进来,可以在 Cline 或 Claude Code 里填同一套 Base URL 和 Key,Model ID 换成对应编码模型,一个 Key 管两端。需要长期跑 Agent 任务、或者想用更完整的 Coding Plan 能力,可以到 TaoToken 的 Coding Plan 页面看看;只想先验证模型效果,直接进模型对话页试几句;接入过程中卡在配置,去接入文档和 API Keys 页对照检查。地址都在下面,按需取用。

  • 官网:https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content=
  • API 基址:https://taotoken.net/api
  • 模型对话:https://taotoken.net/console/chat?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite
  • Coding Plan:https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite
  • 控制台:https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_content=console&utm_campaign=rewrite
  • API Keys:https://taotoken.net/console/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite
  • 接入文档:https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

最后留一个实用技巧:把 SOUL.md 和~/.hermes/data一起放进一个私有 Git 仓库,每次改完人格提交一次。哪天服务器重装,克隆下来就能恢复那个熟悉的语气。技术是冷的,但写进去的每一句口头禅都是热的。

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询