新手需依次完成环境安装、模型对接、记忆启用、微信接入和技能配置：运行安装脚本→配置yibuapi的openai兼容api→启用local memory→扫码连接微信→启用notion/github/file技能。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您刚接触Hermes Agent，希望快速完成基础配置并启动可用的AI助手，则需按顺序完成环境准备、模型对接与核心参数设定。以下是覆盖全平台的新手配置清单：
一、一键安装与环境初始化
该步骤自动完成Python运行时、依赖库及全局命令注册，适用于Linux、macOS及WSL2环境，避免手动配置虚拟环境和路径问题。
1、打开终端，执行官方安装脚本：
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
2、等待终端输出“Installation completed successfully”提示，表示基础环境已就绪。
3、验证安装是否生效：
hermes --version
4、如提示命令未找到，请重启终端或执行source ~/.bashrc（macOS/Linux）或重新打开WSL2窗口。
二、配置外部大模型API（解决空响应）
Hermes不内置模型，必须绑定兼容OpenAI API格式的服务端点，否则所有对话将返回空内容或报错“no model configured”。
1、访问一步API控制台（yibuapi.com），注册账号后进入API Keys页面。
2、点击「创建 API-KEY」，名称填写“hermes-prod”，生成并复制完整key（以sk-开头的字符串）。
3、在终端中运行交互式配置：
hermes setup
4、依次选择：
Provider: Custom endpoint (OpenAI compatible)
Base URL: https://api.yibuapi.com/v1
API Key: 粘贴上一步复制的key
Model name: z-ai/glm-5.1
5、确认配置写入成功后，系统自动生成config.yaml并保存至~/.hermes/config.yaml。
三、启用本地记忆与用户画像
默认配置下Hermes仅使用会话级临时记忆，需显式开启持久化记忆模块才能实现跨会话上下文延续与个性化偏好学习。
1、编辑配置文件：
nano ~/.hermes/config.yaml
2、在文件末尾添加以下区块：
memory:
enabled: true
provider: local
3、保存退出后，执行：
hermes memory init
4、验证记忆服务状态：
hermes memory status
5、终端应返回“Local memory initialized, 0 memories stored”，表明双层记忆架构已激活。
四、微信扫码接入（零代码网关）
通过内置微信消息网关，无需开发接口或部署服务器，即可将Hermes作为个人AI助理直接在微信中使用，扫码即连。
1、确保已安装ffmpeg与qrencode：
sudo apt install -y ffmpeg qrencode
2、启动微信网关模式：
hermes messenger wechat --mode qr
3、终端将生成一个动态二维码，使用微信“扫一扫”功能扫描该码。
4、微信端显示“已连接 Hermes Agent”后，即可在任意聊天窗口发送消息，例如：
“帮我总结上周会议纪要”
5、首次连接成功后，配置自动持久化至~/.hermes/messengers/wechat.yaml。
五、技能系统快速启用
技能（Skills）是Hermes执行具体任务的能力单元，新手无需编写代码即可启用社区预置技能，提升实用性。
1、查看当前可用技能列表：
hermes skills list
2、启用基础生产力技能：
hermes skills enable productivity.notion
3、启用代码辅助技能：
hermes skills enable github.codebase-inspection
4、启用文件操作技能：
hermes skills enable tools.file_operations
5、验证启用状态：
hermes skills status
6、终端应显示对应技能状态为“enabled”，且无报错信息。
