调教 AI 助手：OpenClaw 与 Hermes-Agent 配置指南

最近抽空把 OpenClaw 和 Hermes-Agent 两个 AI 助手调教好了，以后只需通过微信、QQ、钉钉发送消息，AI 就能帮我处理问题，大大提升了效率。本文记录完整的安装配置过程，希望能帮到有同样需求的朋友。

AI助手

前置安装

1Panel 安装

我家里有一台飞牛 NAS 物理机，为了最大化利用资源，直接在上面安装 OpenClaw（小龙虾）和1Panel。
通过 1Panel 安装 OpenResty、OneDev、Hermes-Agent。

OpenResty 安装

在 1Panel 应用商店中安装 OpenResty，建议选择 1.21 版本。

什么是 OpenResty？

OpenResty 是一个基于 Nginx 的高性能 Web 应用服务器，将 Nginx 与 Lua 编程语言集成在一起，提供强大的功能和灵活性。

核心特性：

• 高性能代理：继承 Nginx 强大的反向代理和负载均衡能力，处理大量并发请求
• 动态内容生成：通过 Lua 脚本处理请求、生成响应，创建高度定制化的 Web 应用
• 高级 URL 路由：支持灵活的 URL 路由和重写规则，便于构建 RESTful API
• 缓存优化：提供强大的缓存功能，支持压缩、连接池等性能优化
• 安全防护：多层次安全控制，包括防 DDoS 攻击、访问控制列表、SSL/TLS 加密
• 生态丰富：众多第三方模块和插件可供选择

OneDev 安装

在 1Panel 应用商店中安装 OneDev。OneDev 是一款集成了 CI/CD、看板和包管理的 Git 服务器，非常适合小团队使用。

OneDev 主要功能：

• 项目管理：创建、编辑项目，管理成员和权限
• 代码托管：完整的 Git 仓库托管和版本控制
• CI/CD：内置持续集成/持续部署功能
• 问题跟踪：创建、分配和解决问题
• Wiki 文档：创建和共享项目文档
• 代码审查：支持代码审查和合并请求管理

OpenClaw 安装及配置

安装过程采用图形化界面配置，非常简单，按照向导一步步操作即可。

Hermes-Agent 安装及配置

对于自定义模型配置，建议使用 Hermes-Agent 的命令行工具。同样，QQBot、微信等网关配置也推荐通过命令行完成。

进入 Docker 容器的 bash 环境，使用 hermes model 和 hermes gateway setup 命令分别配置模型和网关。

模型配置

以下是 Hermes 0.10.0 版本自定义模型（OpenAI 兼容）的配置总结，包含命令行和配置文件两种方式。

方法一：交互式设置（推荐）

# 启动模型选择向导
hermes model

操作流程：

1. 选择 More providers
2. 选择 Custom endpoint (enter URL manually)
3. 输入 base_url（如 https://api.deepseek.com/v1 或本地 http://localhost:11434/v1）
4. 输入 api_key（没有则填 dummy）
5. 从列表选择模型 → 确认设为默认

方法二：命令行直接指定

临时使用（不保存）：

hermes \
  --provider openai \
  --base_url https://your-endpoint.com/v1 \
  --api_key sk-xxx \
  --model your-model-name \
  “你的问题”

设为全局默认：

hermes model set \
  --provider openai \
  --base_url https://your-endpoint.com/v1 \
  --api_key sk-xxx \
  --model your-model-name

方法三：配置文件方式

配置文件路径：~/.hermes/config.yaml 或项目目录下的 config.yaml

单模型配置：

model:
  provider: openai
  base_url: https://your-endpoint.com/v1
  api_key: sk-xxxxxxxxxxxxxxxxxxxxxxxx
  model_name: your-model-name

多自定义模型配置（0.10.0 支持）：

custom_providers:
  - name: local-ollama
    base_url: http://localhost:11434/v1
    api_key: “”
    models:
      llama3:
        context_length: 8192
  - name: deepseek
    base_url: https://api.deepseek.com/v1
    api_key: sk-xxx
    models:
      deepseek-chat:
        context_length: 32768

切换模型：

hermes model set local-ollama/llama3

方法四：环境变量方式

# .env 文件
OPENAI_BASE_URL=https://your-endpoint.com/v1
OPENAI_API_KEY=sk-xxx
HERMES_DEFAULT_MODEL=your-model-name

生效命令：

hermes model reload

验证配置

# 查看当前默认模型
hermes model list

# 测试连通性
hermes --test-model

QQBot 配置（微信等其他平台操作类似）

以下是 Hermes 0.10.0 配置 QQBot 的完整流程，包含准备、配置、启动、测试全步骤。

推荐使用扫码

直接通过手机扫描二维码快速配置QQbot

第一步：获取 QQ 开放平台凭证

1. 访问 QQ 开放平台 并登录
2. 创建应用 → 选择「机器人」→ 获取 AppID 和 AppSecret（请妥善保存）
3. 开启必要权限：C2C 私聊 和 群聊@消息

第二步：配置 QQBot（交互式，推荐）

# 启动网关配置向导
hermes gateway setup

操作流程：

1. 从列表选择 QQ Bot（通常是第 16 项）
2. 选择 扫码接入（最方便）或 手动填写 AppID/AppSecret
3. 扫码方式：复制二维码链接 → 浏览器打开 → 手机 QQ 扫码 → 选择机器人 → 完成连接
4. 确认配置：输入 y 保存

第三步：命令行直接配置（适合自动化脚本）

hermes gateway add qqbot \
  --app-id "你的AppID" \
  --app-secret "你的AppSecret"

第四步：验证配置

# 查看所有网关
hermes gateway list

# 查看 qqbot 详情
hermes gateway show qqbot

第五步：启动 QQBot 网关

# 前台启动（调试用，日志直接输出）
hermes gateway

# 或后台启动（生产环境推荐）
hermes gateway start

第六步：测试

1. 在 QQ 中搜索你的机器人
2. 发起私聊，发送消息（如「你好」）
3. 机器人正常回复即配置成功

配置文件参考

配置文件路径：~/.hermes/config.yaml

gateways:
  qqbot:
    app_id: "xxxx"
    app_secret: "xxxx"
    enabled: true

Git 初始化与 SSH 密钥配置

一、Git 全局配置

# 设置用户名
git config --global user.name "your-name"

# 设置邮箱（与 SSH 密钥邮箱一致）
git config --global user.email "your-email@qq.com"

# 验证配置
git config --global --list

二、生成 SSH 密钥

推荐使用 ed25519 算法（更安全）：

ssh-keygen -t ed25519 -C "your-email@qq.com"

一路回车，不设置密码，直接生成。

三、查看并复制公钥

cat ~/.ssh/id_ed25519.pub

输出示例：

ssh-ed25519 AAAAC3NzaC1lZDI1NTE5AAAA... your-email@qq.com

四、配置公钥到 Git 服务器

1. 登录你的 Git 平台（Gitea/GitLab/自建 Git）
2. 找到 SSH 密钥 / SSH Keys 设置页面
3. 粘贴完整的公钥内容
4. 保存

五、测试 SSH 连接

ssh -T -p 40086 git@11.11.11.11

• 提示确认时输入 yes
• 显示 Welcome 表示成功
• 显示 Permission denied 说明公钥配置有问题

六、克隆仓库

git clone ssh://git@11.11.11.11:40086/TaroApp.git

问题排查汇总

Git 推送问题

问题主要集中在用户名配置和 SSH 密钥路径上。

OpenClaw 问题

问题描述：SSH 默认查找路径 /home/trim.openclaw/.ssh/，但实际密钥位于 ~/.ssh/（即 /vol2/@apphome/trim.openclaw/data/home/.ssh/）。

解决方案：显式指定密钥路径：

ssh -i ~/.ssh/id_ed25519 git@server

Hermes-Agent 问题

问题分析：

问题	原因	解决方案
仓库地址缺少用户名	地址格式为 git@one-dev.cszy.top:TaroApp.git	改为 git@one-dev.cszy.top:cs/TaroApp.git
SSH 端口不对	Git 服务器 SSH 使用非默认端口 40086	使用 ssh://git@11.11.11.11:40086/TaroApp.git 格式
SSH 密钥路径问题	Docker 环境中默认查找 /opt/data/.ssh/，实际在 /opt/data/home/.ssh/	创建 SSH config 文件

SSH Config 配置：

Host 11.11.11.11
    HostName 11.11.11.11
    Port 40086
    User git
    IdentityFile /opt/data/home/.ssh/id_ed25519
    IdentitiesOnly yes

推送命令：

GIT_SSH_COMMAND="ssh -F /opt/data/home/.ssh/config" git push origin main

关键配置汇总：

配置项	值
服务器地址	11.11.11.11
SSH 端口	40086（非默认）
Git 用户名	cs
密钥位置	/opt/data/home/.ssh/id_ed25519