最新案例动态，请查阅码道助阵：Hermes本地部署轻松搞定小伙伴们快来进行实操吧！

案例简介：本案例采用华为云码道AI IDE，结合WSL（Windows Subsystem for Linux）技术，在Windows本地环境快速部署Hermes开源AI智能体。实现Hermes Agent本地化部署场景，让开发者在Windows环境下快速拥有自己的AI智能助手，开启AI Agent本地开发新时代。

一、概述

1.1 案例介绍

在AI Agent快速发展的今天，越来越多的开发者希望在自己的本地环境中部署和使用AI Agent，用于自动化任务执行、智能问答、数据分析等场景。然而，AI Agent的本地部署往往面临诸多挑战：依赖环境配置复杂、大模型API调用成本高、跨平台兼容性差、会话记忆难以持久化等问题，让许多开发者望而却步。特别是在Windows环境下，AI Agent的安装和配置更是困难重重，需要处理Linux子系统、Python环境、网络代理等一系列技术细节。本案例旨在通过华为云码道和WSL技术，为开发者提供一条从零到一快速部署AI Agent的完整路径，让AI Agent本地部署不再是难题。

本案例采用华为云码道（CodeArts）代码智能体作为核心开发工具，结合WSL（Windows Subsystem for Linux）技术，在Windows本地环境快速部署Hermes Agent这一开源AI智能体。通过华为云MaaS平台提供的DeepSeek V3.2大模型，实现成本可控的AI能力调用。让开发者能够在熟悉的Windows环境中体验AI Agent的强大功能，体验跨会话记忆、Skill自动生成、多平台会话等Hermes特性。

案例技术选型：

• 华为云码道（CodeArts）代码智能体：集代码大模型、AI IDE、Code Agent为一体的智能编码产品。提供强大的代码编辑、终端操作和文件管理能力，支持Windows本地开发环境的完整配置。本案例中作为核心开发工具，提供AI IDE环境，辅助完成WSL安装、Hermes部署和飞书配置等全流程操作。
• WSL（Windows Subsystem for Linux）：Windows系统内置的Linux子系统。无需虚拟机即可在Windows中运行原生Linux环境，支持Ubuntu、Debian等主流发行版，文件系统互通、性能接近原生。本案例中作为Hermes Agent的运行环境，提供Ubuntu 24.04系统，解决Windows下AI Agent部署的兼容性问题。
• Hermes Agent：开源的AI智能体框架。支持长期记忆、跨会话任务追踪、Skill自动生成与沉淀、多平台消息接入等先进特性，可连接任意大模型API，提供CLI、飞书、微信等多种交互方式。本案例中作为核心AI Agent，实现跨会话记忆任务、Skill生成与决策应用、飞书会话平台接入等功能。
• 华为云MaaS平台 DeepSeek-V3.2大模型：华为云提供的MaaS模型即服务平台集成的先进大语言模型。具备强大的自然语言理解和生成能力，支持OpenAI兼容接口，成本低廉（千万Tokens仅需1元）。本案例中作为Hermes Agent的AI推理引擎，提供对话生成、任务理解、代码生成等AI能力。

1.2 适用对象

• 个人开发者
• 高校学生
• 企业开发者

1.3 案例时间

本案例总时长预计90分钟。

1.4 案例流程

说明：

1. AI IDE华为云码道（CodeArts）代码智能体安装部署；
2. 本地安装WSL，配置华为云码道登录WSL Ubuntu虚拟环境；
3. 安装部署Hermes，领取华为云MaaS平台大模型Tokens福利，配置大模型API；
4. Hermes功能体验（跨会话记忆、Skill生成等）；
5. 配置飞书会话平台，实现多端交互。

1.5 资源总览

本案例预计花费0或1元。

注意：此处标注的金额仅限体验一遍案例，如持续使用MaaS平台模型则会进行持续扣费，本案例按DeepSeek V3.2示例。

资源名称	规格	单价（元）
华为云码道（CodeArts）代码智能体	系统标配	免费
华为开发者空间 - DeepSeek-R1/V3.2千万Tokens代金券	DeepSeekV3.2	1.00
ModelArts Studio大模型（DS/K2/Q3等）通用代金券	DeepSeekV3.2	0.00

二、环境和资源准备

2.1 领取华为云MaaS平台大模型Tokens福利

方式一： 登录华为开发者空间，参考案例《华为开发者空间 - ModelArts Studio大模型通用代金券领取使用指导》中的“二、 开通MaaS平台大模型”章节内容领取代金券，获取到模型的API地址、模型名称和API Key。

方式二： 登录华为开发者空间，参考案例《华为云MaaS平台大模型Tokens领取使用指导》中的“二、 领取MaaS平台大模型Tokens”章节内容，领取MaaS平台DeepSeek V3系列大模型Tokens代金券，购买ModelArts Studio DeepSeek Tokens套餐包，开通模型服务，最后获取到模型的API地址、模型名称和API Key。

注意：需选择OpenAI兼容接口

注意：需选择OpenAI兼容接口，记录API Key、API地址以及模型名称留作后面步骤使用。

2.2 AI IDE华为云码道安装部署

参考案例《AI IDE华为云码道（CodeArts）代码智能体安装部署》完成Windows版AI IDE华为云码道（CodeArts）代码智能体安装部署。

2.3 本地安装WSL与码道配置

参考案例《WSL子系统极速体验卡：华为云码道已就位，请上车！》中的“三、WSL使用实战”，完成Windows WSL的本地安装以及华为云码道AI IDE的配置。

2.4 Hermes安装与部署

2.4.1 官方脚本安装Hermes

1. 打开码道AI IDE终端，执行以下命令，更新系统包。

sudo apt update && sudo apt upgrade -y

2. 继续执行Hermes官方一键安装脚本

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

执行命令后会依次安装如下：

1. 安装 uv (超快的 Python 包安装器和虚拟环境管理器)；
2. 安装 Python 3.11+；
3. 克隆 Hermes Agent 仓库；
4. 创建并激活虚拟环境；
5. 安装所有依赖。

注：观察Hermes脚本安装过程，若执行过程中python安装失败，可进行手动安装一下，安装好后再执行官方安装脚本。

apt update
apt install -y python3-venv python3-pip

注：安装Hermes Agent仓库步骤时，常因为国内网络问题下载失败，可多尝试几次或者在具备一定优质的网络环境进行下载。

2.4.2 国内镜像安装Hermes（推荐）

若网络环境一般，推荐使用Hermes国内镜像版本（速度快）。

1. 切换国内镜像源

sudo sed -i 's/archive.ubuntu.com/mirrors.aliyun.com/g' /etc/apt/sources.list
sudo apt update && sudo apt upgrade -y

2. 执行安装 Hermes Agent 安装脚本

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

Hermes Agent 安装成功后，自动启动设置向导。

2.4.3 设置Hermes

1. 选择默认项：快速设置 - 提供商、型号和消息（推荐）。

2. 选择手动输入供应商模型URL，然后根据提示输入API base URL和API Key。

本案例以DeepSeek-V3.2为例，依次输出以下参数：

• API base URL：即“2.1 领取华为云MaaS平台大模型Tokens福利”中获取到模型的API地址（注意需选择OpenAI兼容接口地址）。
• API key：即“2.1 领取华为云MaaS平台大模型Tokens福利”中获取到模型的API Key，注意在命令行内不可见，输入/粘贴完毕后回车确认即可。
• 选择模型：本案例中使用的是deepseek-v3.2。

• Context length in tokens：即模型上下文，不可少于64000。
• Display name：名称，方便下次无需配置直接进入，默认或自定义即可，例：wsl-hermes。

3. 选择Hermes运行shell命令和代码的位置，直接回车选择默认当前的本地运行。

4. Hermes配置工具询问：是否要现在连接一个消息平台（比如 Telegram、Discord 等），我们先选择选项2，跳过。

• 选项 1：现在设置消息平台（推荐），选择后安装程序会引导你连接 Telegram、Discord 等平台，方便直接通过聊天工具与你的 agent 交互。
• 选项 2：跳过，以后可以通过hermes setup gateway 命令再设置。

5. 回车后，系统自动加载配置，安装脚本执行结束。

2.4.4 安装验证与启动网关

经过以上步骤，Hermes已经被成功安装到WSL，执行如下命令可进行安装验证。

source ~/.bashrc	# 重新加载shell
hermes --version	# 查询hermes版本，验证安装成功

启动网关服务。

hermes gateway run	# 前台启动网关
nohup hermes gateway run > ~/.hermes/logs/gateway.log 2>&1 &	# 后台启动网关

输入hermes指令启动Hermes CLI，并对话：“你好，请帮我查询一下南京今天及未来两天的天气情况”。查询结果符合预期。

2.5 Hermes体验

2.5.1 跨会话记忆任务

测试Hermes长期记忆与上下文回溯能力：Hermes能否在全新的CLI会话中，通过内置的记忆检索系统，主动应用上一个会话中用户明确要求记住的偏好。

前置任务，会话A：

后期我会让你帮我生成任何城市/时间段的二手房市场分析报告，报告必须包含如下几部分内容，请记住这条偏好，并为其命名为 `report_style`：
1. 城市宏观背景与全市市场概览：涵盖本地经济/人口/政策/规划，以及全市成交量、价、库存、去化周期；
2. 区域板块分化与轮动分析：对比各行政区及热点板块，揭示板块轮动与领涨/滞涨区域；
3. 供需博弈与交易行为特征：包括挂牌量、调价比例、带看量、议价空间，以及成交结构变化；
4. 市场预判与行动策略建议：短期走势判断，以及针对刚需、置换、售房业主的具体建议。

执行该对话后，Hermes调用session.remember，将偏好存入持久化存储，并回复确认。

Ctrl + C退出会话A，并输入指令hermes，启动会话B，向Hermes发送指令：“请联网检索南京市2025年二手房数据，帮我生成南京市2025年二手房市场分析报告，保存为 nanjing_2025.md”。

Hermes 自动联网搜索南京市2025年的二手房数据，并根据记忆功能，按照我的要求生成了对应报告。

2.5.2 Skill生成与决策应用

对话Hermes：“很好，请分析刚才任务执行的轨迹，并将其沉淀为一个skill。下次我将直接告诉你我所需要的城市和年份，你直接帮我生成对应的报告。”。

继续对话Hermes：“请帮我生成2025年苏州市的二手房市场分析报告，并增加内容：典型成交案例与中介竞争格局（热销小区排行、真实成交案例、本地中介市占率及新兴模式）”。

Hermes自动调用上一个对话中生成的city-real-estate-report skill，并生成苏州市2025年二手房市场分析报告与摘要。

三、配置Hermes - 飞书会话平台

此前，我们已在 Windows WSL 的 Ubuntu 24.04 环境下完成 Hermes 的部署与配置，使用 Hermes CLI 模式进行了深度体验。Hermes 除 CLI 模式外，还支持飞书、微信等多种会话平台。本节将重点讲解如何配置飞书作为会话平台，实现Hermes多平台对话。

3.1 配置飞书会话平台

重新打开一个码道AI IDE终端窗口，输入如下指令，打开Hermes Gateway配置界面：

hermes setup gateway

在配置界面可通过键盘↑ ↓键，移动光标指向Feishu / Lark（not configured），通过空格按键选中，然后回车确认。

直接回车，保持默认选项：扫描二维码自动创建一个新的机器人（最简单，推荐）。

由于系统中没有安装依赖，二维码未生成，但系统提供了跳转链接。

Ctrl + 左键点击上图中的链接，自动打开浏览器，跳转Hermes Agent飞书应用创建页面。

注册登录飞书平台，然后编辑机器人名称，点立即创建。返回码道AI IDE，选择默认配置：使用 DM 配对批准（推荐）。

选择该选项后用户第一次给机器人发私信时，需要先发送一个配对码或者经过你的批准，才能正常对话。这是最安全的方式，可以避免陌生人随意和机器人聊天。

直接回车，在群组中被@时，进行回复。

直接回车，不设置Home chat ID。（用于为定时任务、系统通知等设置默认对话ID）

回复Y，将gateway设置为系统服务，每次系统启动后，自动启动机器人，并将其设置为用户服务。

回复Y，立刻启动gateway，启动成功并提示。

此时，直接在飞书的应用界面对话，机器人没有回复。通过如下命令重新启动

hermes gateway stop	# 关闭Hermes的网关
hermes gateway	# 不加 start 命令直接启动，gateway会在前台运行，所有的消息都会直接打印在屏幕上。

日志提示缺少飞书lark-oapi 和凭据。通过如下命令进行安装：

/root/.hermes/hermes-agent/venv/bin/pip install lark-oapi

安装结束后，重启gateway。

hermes gateway restart

在飞书的机器人对话框中输入对话信息：“你好”。机器人答复，并为我们提供了一个配对码。

返回码道 AI IDE界面，在命令行中输入机器人提供的带有配对码的指令。

再次对话飞书机器人：“你好，请介绍一下你自己”。

机器人提示我输入/sethome设置Home Chat（仅首次需要设置）。输入指令后，机器人正常回复自我介绍。

3.2 对话飞书Hermes Agent

对话飞书Hermes Agent：“我之前让你生成了2025年南京市二手房市场分析报告，请继续帮我分析一下2026年南京二手房市场情况”。

Agent查询了nanjing_2025并调用了city-real-estate-report skill的偏好模板，生成了市场分析及摘要报告。

至此，码道助阵：Hermes本地部署轻松搞定案例结束，各位小伙伴快来下载华为云码道（CodeArts）代码智能体部署体验Hermes吧！

反馈改进建议

如您在案例实操过程中遇到问题或有改进建议，可以到论坛帖评论区反馈即可，我们会及时响应处理，谢谢！