一、前置条件
开始配置前，请确认已满足以下条件：
1. Memory Hub 已部署并可正常访问。
2. 已在 Memory Hub 的 API Key 页面获取以下两项信息：
·客户端接入地址：找到 Hermes 对应的地址，单击复制。
·User Key：以 sk-mem- 开头的密钥，用于身份认证。
3. 已安装 Hermes 客户端。
二、配置步骤
Hermes 的接入配置通过主目录下的 ~/.hermes/config.yaml 文件完成，包含连接地址与密钥两项核心信息。
注意：说明：
注意：~ 表示当前登录用户的主目录，例如 Windows 下为 C:\\Users\\用户名，macOS / Linux 下为 /home/用户名 或 /Users/用户名。首次使用需先创建该文件夹，例如执行 mkdir -p ~/.hermes。
三、步骤一：配置 config.yaml
编辑 ~/.hermes/config.yaml，写入以下内容：
model: # 接入地址，粘贴从 Memory Hub 复制的地址 baseURL: http://127.0.0.1:8096/hermes/default # User Key，粘贴从 Memory Hub 获取的密钥 apiKey: sk-mem-xxxxxxxxxxxxxxxx
上述参数的含义如下：
| 参数 | 作用 | 是否需要修改 |
| baseURL | Memory 的接入地址，决定请求实际发送的目标。将示例中的地址替换为从 Memory Hub 复制的实际地址，末尾不要追加 /v1 | 是 |
| apiKey | 用于身份认证的 User Key，以 sk-mem- 开头。将示例中的占位值替换为从 Memory Hub 获取的实际密钥 | 是 |
注意：说明：
注意：登录 Memory Hub，进入 API Key 页面，找到 DeepSeek Harness 对应的客户端接入地址与 User Key。
四、步骤二：设置文件权限
由于配置文件中包含密钥，建议限制文件访问权限：
chmod 700 ~/.hermeschmod 600 ~/.hermes/config.yaml
五、启动并完成首次初始化
1. 启动 Hermes 客户端。
2. 在对话框中发送任意消息（例如 hi）。Proxy 会依次返回以下选择器（按钮形式）：
·是否关联团队资产（Associate team assets?）：选择 Yes 注入团队上下文，选择 No 跳过。
·选择团队（Team）：仅存在一个团队时会自动跳过。
·选择 Agent：在所选团队下选择 Agent。
·选择任务（Task）：首行是虚拟的 "No task" 条目。
3. 完成选择后，Agent 会进行自我介绍，并在后续每轮对话中自动注入以下上下文：会话上下文（<session_context>）、可用的技能列表（<available_skills>）与用户画像记忆（<tdai_profile_memory>）。
4. 初始化完成后，可在聊天中输入以下斜杠命令使用相关能力：
·mem:help：查看记忆命令的帮助。
·mem:sync：同步记忆。
·mem:create-skill：创建技能。
六、常见问题
| 现象 | 可能原因 | 解决方法 |
| 启动后提示连接失败 | Proxy 未启动或接入地址不正确 | 确认 Proxy 服务正常运行，检查 baseURL 是否与 Memory Hub 页面一致 |
| 发送消息后无选择器弹出 | User Key 无效或过期 | 重新从 Memory Hub 复制 User Key，更新 config.yaml 中的 apiKey |
| 配置文件修改后未生效 | 客户端未重新加载配置 | 完全退出并重新启动 Hermes |