Hermes Agent 完全上手指南：从零部署到飞书接入的实战教程

国内首个原生支持中文的 AI Agent 平台，一条命令完成安装，5分钟接入飞书

前言：为什么选 Hermes Agent？

在 AI 工具百花齐放的 2026 年，开发者们面临一个尴尬的局面：

• OpenClaw 系列（QClaw、WorkBuddy、ArkClaw）功能强大，但配置复杂，中文支持不完善
• Claude Code、Cursor 等国外工具网络不稳定，API 成本高
• 自建方案需要折腾 Docker、反向代理、Webhook，门槛太高

Hermes Agent 的出现改变了这个局面：

✅ 原生中文：完整的中文文档和中文社区支持
✅ 一键安装：一条命令完成安装，无需配置环境
✅ 多平台接入：飞书、微信、钉钉、Telegram、Discord 开箱即用
✅ 模型自由：支持 OpenAI、Claude、DeepSeek、Kimi、GLM 等 20+ 模型
✅ 安全可靠：内置沙箱终端、危险命令审批、密钥脱敏

本文将手把手带你完成：安装 → 配置模型 → 接入飞书 → 高级玩法，全程避坑。

一、安装 Hermes Agent

1.1 系统要求

硬件要求： - CPU：任意现代处理器 - 内存：4GB+（推荐 8GB） - 磁盘：2GB 可用空间 - 网络：能访问 GitHub 和模型 API

1.2 Linux / macOS / WSL2 安装

打开终端，执行一条命令：

curl -fsSL https://res1.hermesagent.org.cn/install.sh | bash

安装完成后，加载环境变量：

source ~/.bashrc  # 或 source ~/.zshrc

验证安装：

hermes --version

1.3 Windows 安装（PowerShell）

如果你不想用 WSL2，可以直接在 PowerShell 安装：

irm https://res1.hermesagent.org.cn/install.ps1 | iex

⚠️ 注意：Windows 原生安装可能遇到依赖问题，建议优先使用 WSL2

1.4 安装常见问题

Q: 安装时提示 "curl: command not found"

# Ubuntu/Debian
sudo apt-get update && sudo apt-get install -y curl

# CentOS/RHEL
sudo yum install -y curl

# macOS
brew install curl

Q: 安装完成后 hermes 命令找不到

# 重新加载 shell 配置
source ~/.bashrc

# 或手动添加 PATH
export PATH="$HOME/.local/bin:$PATH"

二、配置大模型

Hermes 支持 20+ 模型提供商：

2.1 交互式配置

运行配置向导：

hermes model

按提示选择： 1. 选择提供商（如 DeepSeek、Kimi） 2. 输入 API Key 3. 选择具体模型

2.2 手动配置

编辑 ~/.hermes/.env：

# DeepSeek
DEEPSEEK_API_KEY=sk-xxxxxxxxxxxxxxxx

# Kimi
KIMI_API_KEY=sk-xxxxxxxxxxxxxxxx

# OpenRouter
OPENROUTER_API_KEY=sk-or-xxxxxxxxxxxxxxxx

2.3 测试模型

hermes

输入测试消息：

你好，请介绍一下自己

三、接入飞书（详细步骤）

3.1 创建飞书应用

步骤 1：访问飞书开放平台 - 国内版：https://open.feishu.cn/ - 国际版：https://open.larksuite.com/

步骤 2：创建企业自建应用 1. 点击「创建企业自建应用」 2. 填写应用名称（如 "Hermes助手"） 3. 选择「企业内部应用」

步骤 3：获取凭证 1. 进入「凭证与基础信息」 2. 复制 App ID 和 App Secret

步骤 4：启用机器人能力 1. 左侧菜单点击「机器人」 2. 开启「机器人能力」 3. 设置机器人名称和描述

步骤 5：配置权限 进入「权限管理」，申请以下权限：

- im:chat:readonly（读取群信息）
- im:message（发送消息）
- im:message.group（发送群消息）
- im:resource（访问资源）

步骤 6：发布应用 1. 进入「版本管理与发布」 2. 点击「创建版本」 3. 保存并发布

3.2 配置 Hermes 网关

编辑 ~/.hermes/.env：

# 飞书配置
FEISHU_APP_ID=cli_xxxxxxxxxxxxxxxx
FEISHU_APP_SECRET=xxxxxxxxxxxxxxxx
FEISHU_DOMAIN=feishu  # feishu=国内版, lark=国际版
FEISHU_CONNECTION_MODE=websocket

# 安全设置
FEISHU_ALLOWED_USERS=ou_xxx,ou_yyy
FEISHU_GROUP_POLICY=allowlist

安装依赖：

pip install lark-oapi websockets

3.3 启动网关

hermes gateway run -vv

3.4 测试机器人

私聊测试： 1. 在飞书搜索机器人名称 2. 发送消息测试

群聊测试： 1. 将机器人添加到群聊 2. @机器人发送消息

四、核心功能实战

4.1 终端命令执行

帮我查看当前目录下的文件，并找出最大的 5 个

4.2 文件操作

读取 README.md 文件，帮我总结一下项目内容

4.3 网络搜索

搜索一下最新的 Python 3.13 新特性

4.4 代码执行

用 Python 画一个正弦波图表

4.5 定时任务

每天早上 9 点检查服务器 CPU 和内存使用情况，发送到飞书

五、高级配置

5.1 Docker 沙箱

hermes config set terminal.backend docker

5.2 切换模型

# 切换到 DeepSeek
hermes config set model deepseek/deepseek-chat

# 切换到 Kimi
hermes config set model kimi/kimi-latest

5.3 自定义系统提示

编辑 ~/.hermes/SOUL.md：

# SOUL.md

你是 Hermes 助手，一个专业的技术助手。

## 特点
- 擅长 Linux 系统管理、Docker、Kubernetes
- 熟悉 Python、Go、Node.js 开发
- 回答简洁，直接给出代码和命令

5.4 安装技能

hermes skills search kubernetes
hermes skills install official/security/1password

六、故障排除

七、总结

Hermes Agent 是目前国内最完善的中文 AI Agent 平台：

✅ 安装简单：一条命令完成
✅ 模型丰富：支持 20+ 提供商
✅ 平台全面：飞书、微信、钉钉、Telegram 等
✅ 功能强大：终端、文件、搜索、代码、浏览器
✅ 安全可靠：沙箱、审批、脱敏

下一步： - 加入中文社区：https://hermesagent.org.cn/community - 查看完整文档：https://hermesagent.org.cn/docs - 探索更多技能：hermes skills search

本文基于 Hermes Agent 官方文档整理，如有更新请以官方文档为准。

📚 相关文章推荐

你可能还想看：

1. 飞牛NAS部署OpenClaw教程：XXOS大佬一键应用轻松对接QQ机器人
2. QQ小龙虾机器人接入OpenClaw保姆级教程
3. Open-XiaoAI Bridge：让小爱音箱接入你的 AI Agent
4. 飞牛NAS安装CoPaw教程：国产AI Agent平台平替OpenClaw部署指南
5. OpenClaw + Claude Code 教程：独立开发者搭建AI Agent系统实现94次/日代码提交