虚拟机中运行Hermes Agent需启用嵌套虚拟化、使用Ubuntu 22.04 LTS、限制WSL2资源、采用离线安装、释放8000/8001端口，并配置Ollama等本地模型后端。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您尝试在虚拟机中运行Hermes Agent，但启动失败或模型加载异常，则可能是由于虚拟化嵌套未启用、资源分配不足或Linux发行版兼容性不匹配所致。以下是适配虚拟机环境的配置步骤：
一、启用嵌套虚拟化并验证底层支持
WSL2在虚拟机中运行需宿主虚拟机开启嵌套虚拟化，否则无法加载Linux内核，导致hermes命令不可用或报错0x80370102。该步骤必须在虚拟机管理程序层面完成，而非Guest OS内部操作。
1、关闭虚拟机电源，进入虚拟机设置界面；
2、在处理器/CPUs选项中，勾选Intel VT-x/EPT 或 AMD-V/RVI（依宿主CPU型号而定）；
3、若使用VMware Workstation Pro，还需在“虚拟机设置→选项→高级”中启用“启用虚拟化Intel VT-x/EPT或AMD-V/RVI”；
4、若使用VirtualBox，需在“系统→加速”中同时勾选“启用VT-x/AMD-V”和“启用嵌套分页”；
5、启动虚拟机后，在终端执行lscpu | grep -i virtualization，确认输出包含"VT-x"或"AMD-V"且状态为enabled。
二、部署兼容的Linux发行版并约束资源上限
虚拟机内存与I/O性能波动大，Ubuntu 22.04 LTS经官方测试矩阵验证为唯一稳定支持Hermes Agent的发行版；默认资源策略易触发OOM Killer，必须通过.wslconfig强制限制。
1、在虚拟机中安装Ubuntu 22.04 LTS（非Server版亦可，但需确保桌面环境未占用过多内存）；
2、安装完成后重启，以普通用户登录并打开终端；
3、执行sudo apt update && sudo apt install -y build-essential python3.12 python3.12-venv python3.12-dev git curl wget；
4、在用户主目录创建文件.wslconfig（注意开头为点号），写入以下内容：
[wsl2]
memory=6GB
swap=2GB
localhostForwarding=true
5、执行wsl --shutdown后重新启动WSL2实例，再运行free -h确认可用内存为约6GB。
三、采用离线安装模式规避网络不稳定问题
虚拟机常因NAT或代理策略导致GitHub直连超时，一键脚本失败率高；离线安装可绕过网络依赖，确保依赖版本一致性。
1、在宿主机（Windows/macOS）上下载完整源码包：curl -L https://github.com/NousResearch/hermes-agent/archive/refs/tags/v0.8.1.tar.gz -o hermes-agent-v0.8.1.tar.gz；
商业LOGO设计技能：依据用户描述，使用阿里云百炼千问图像模型(qwen‑image‑2.0‑pro)生成专业商业LOGO图片。适用场景：设计公司/品牌LOGO、生成商业标识图标、创建品牌视觉符号、按描述生成logo图片。支持自定义尺寸、风格、负面提示词等。
2、将压缩包复制至虚拟机Ubuntu的/home/$USER/Downloads/目录；
3、在虚拟机终端中执行：tar -xzf ~/Downloads/hermes-agent-v0.8.1.tar.gz -C ~ && mv ~/hermes-agent-0.8.1 ~/hermes-agent；
4、进入项目目录：cd ~/hermes-agent；
5、运行离线初始化脚本：bash scripts/install-offline.sh（该脚本已预置uv、Python wheel及llama-cpp-python二进制）；
6、验证安装：source ~/.bashrc && hermes --version，输出hermes 0.8.1即成功。
四、禁用冲突服务并校验端口占用
Hermes Agent默认监听8000和8001端口，虚拟机中常有snapd、lxd或Apache等服务默认占用，需提前释放。
1、检查端口占用：sudo ss -tuln | grep ':800[01]'；
2、若发现占用进程，记录其PID并终止：sudo kill -9 PID；
3、永久禁用snapd（非必要服务）：sudo systemctl disable --now snapd.socket snapd.service；
4、禁用lxd（除非主动使用容器）：sudo systemctl disable --now lxd；
5、再次执行ss -tuln | grep ':800[01]'，确认无输出。
五、配置模型后端为本地或可信代理地址
虚拟机网络策略常拦截HTTPS请求或DNS解析，直接调用OpenAI/Kimi等API易超时；应优先配置本地Ollama服务或硅基流动等国内可用代理。
1、在虚拟机中安装Ollama：curl -fsSL https://ollama.com/install.sh | sh；
2、拉取轻量模型：ollama run qwen2:0.5b（首次运行会自动下载）；
3、执行hermes setup，在模型提供商选项中选择"Custom Endpoint"；
4、输入Endpoint URL：http://localhost:11434；
5、API Key留空（Ollama无需密钥），模型名填入qwen2:0.5b；
6、保存后执行hermes model list，确认返回包含该模型标识。
