本案例采用华为云码道AI IDE结合WSLWindows 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代码智能体作为核心开发工具结合WSLWindows 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部署和飞书配置等全流程操作。WSLWindows Subsystem for LinuxWindows系统内置的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 案例流程说明AI IDE华为云码道CodeArts代码智能体安装部署本地安装WSL配置华为云码道登录WSL Ubuntu虚拟环境安装部署Hermes领取华为云MaaS平台大模型Tokens福利配置大模型APIHermes功能体验跨会话记忆、Skill生成等配置飞书会话平台实现多端交互。1.5 资源总览本案例预计花费0或1元。注意此处标注的金额仅限体验一遍案例如持续使用MaaS平台模型则会进行持续扣费本案例按DeepSeek V3.2示例。资源名称规格单价元华为云码道CodeArts代码智能体系统标配免费华为开发者空间 - DeepSeek-R1/V3.2千万Tokens代金券DeepSeekV3.21.00ModelArts Studio大模型DS/K2/Q3等通用代金券DeepSeekV3.20.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打开码道AI IDE终端执行以下命令更新系统包。shell复制代码sudo apt update sudo apt upgrade -y继续执行Hermes官方一键安装脚本shell复制代码curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash执行命令后会依次安装如下安装 uv (超快的 Python 包安装器和虚拟环境管理器)安装 Python 3.11克隆 Hermes Agent 仓库创建并激活虚拟环境安装所有依赖。注观察Hermes脚本安装过程若执行过程中python安装失败可进行手动安装一下安装好后再执行官方安装脚本。shell复制代码apt update apt install -y python3-venv python3-pip注安装Hermes Agent仓库步骤时常因为国内网络问题下载失败可多尝试几次或者在具备一定优质的网络环境进行下载。2.4.2 国内镜像安装Hermes推荐若网络环境一般推荐使用Hermes国内镜像版本速度快。切换国内镜像源shell复制代码sudo sed -i s/archive.ubuntu.com/mirrors.aliyun.com/g /etc/apt/sources.list sudo apt update sudo apt upgrade -y执行安装 Hermes Agent 安装脚本shell复制代码curl -fsSL https://res1.hermesagent.org.cn/install.sh | bashHermes Agent 安装成功后自动启动设置向导。2.4.3 设置Hermes选择默认项快速设置 - 提供商、型号和消息推荐。选择手动输入供应商模型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。选择Hermes运行shell命令和代码的位置直接回车选择默认当前的本地运行。Hermes配置工具询问是否要现在连接一个消息平台比如 Telegram、Discord 等我们先选择选项2跳过。选项 1现在设置消息平台推荐选择后安装程序会引导你连接 Telegram、Discord 等平台方便直接通过聊天工具与你的 agent 交互。选项 2跳过以后可以通过hermes setup gateway命令再设置。回车后系统自动加载配置安装脚本执行结束。2.4.4 安装验证与启动网关经过以上步骤Hermes已经被成功安装到WSL执行如下命令可进行安装验证。bash复制代码source ~/.bashrc # 重新加载shell hermes --version # 查询hermes版本验证安装成功启动网关服务。shell复制代码hermes gateway run # 前台启动网关 nohup hermes gateway run gt; ~/.hermes/logs/gateway.log 2gt;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配置界面shell复制代码hermes setup gateway在配置界面可通过键盘↑ ↓键移动光标指向Feishu / Larknot configured通过空格按键选中然后回车确认。直接回车保持默认选项扫描二维码自动创建一个新的机器人最简单推荐。由于系统中没有安装依赖二维码未生成但系统提供了跳转链接。Ctrl 左键点击上图中的链接自动打开浏览器跳转Hermes Agent飞书应用创建页面。注册登录飞书平台然后编辑机器人名称点立即创建。返回码道AI IDE选择默认配置使用 DM 配对批准推荐。选择该选项后用户第一次给机器人发私信时需要先发送一个配对码或者经过你的批准才能正常对话。这是最安全的方式可以避免陌生人随意和机器人聊天。直接回车在群组中被时进行回复。直接回车不设置Home chat ID。用于为定时任务、系统通知等设置默认对话ID回复Y将gateway设置为系统服务每次系统启动后自动启动机器人并将其设置为用户服务。回复Y立刻启动gateway启动成功并提示。此时直接在飞书的应用界面对话机器人没有回复。通过如下命令重新启动shell复制代码hermes gateway stop # 关闭Hermes的网关 hermes gateway # 不加 start 命令直接启动gateway会在前台运行所有的消息都会直接打印在屏幕上。日志提示缺少飞书lark-oapi和凭据。通过如下命令进行安装bash复制代码/root/.hermes/hermes-agent/venv/bin/pip install lark-oapi安装结束后重启gateway。shell复制代码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开源AI智能体在Windows本地环境的快速部署。通过华为云码道AI IDE作为开发工具、WSL提供Linux运行环境、华为云MaaS平台提供低成本大模型服务有效解决了AI Agent本地部署中环境配置复杂、依赖安装困难、跨平台兼容性差、调用成本高等痛点问题。Hermes Agent支持多种会话平台接入实现多端统一对话体验国内平台CLI模式开发者快速调试和深度体验的首选支持终端命令执行、文件操作、代码生成等高级功能飞书企业级协作平台支持单聊与群聊触发提供DM配对批准安全机制适合企业内部AI助手部署。本案例已完成飞书平台配置验证微信国民级社交平台支持公众号、小程序接入适合面向C端用户的AI服务场景。国际平台Telegram轻量级即时通讯配置简单适合海外用户场景Discord游戏社区主流平台支持频道多人交互适合技术社区AI助手。更多平台配置请参考官方文档。终端CLI中配置的偏好和生成的Skill会自动同步至飞书等平台一次配置即可全平台复用随时随地无缝继续对话显著提升使用效率和协作便利性。这充分展现了AI Agent在提升工作效率、降低重复劳动、实现多平台协同方面的巨大潜力。至此码道助阵Hermes本地部署轻松搞定案例结束各位小伙伴快来下载华为云码道CodeArts代码智能体部署体验Hermes吧
