hermes agent真正可用需选对部署方式：本地部署须解压至全英文路径、双击start.bat启动、访问localhost:8000；云端推荐阿里云轻量服务器（镜像市场选择预装版，api key地域须一致）或腾讯云lighthouse（ubuntu+docker一键安装）；模型配置本地需手动编辑.env文件确保url无多余斜杠，云端则通过webui可视化配置并自动校验。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
想让 Hermes Agent 真正可用，不是装上就能跑，而是得选对部署方式——本地装完一关机就断连，云端配错地域直接403报错，路径含中文会触发编码异常，安全软件可能拦截启动进程。
本地部署：三步能跑，但四类问题必踩
第一步：下载官方一键包（45.8MB），解压到【全英文、无空格、无中文的路径】，例如 C:\hermes-agent\；若放在“文档”“桌面”或含“测试”“新建文件夹”等中文名目录下，启动时大概率报 UnicodeDecodeError。
第二步：双击 start.bat 启动服务；不要右键→“以管理员身份运行”，这会导致环境变量加载异常，反而无法识别内置 Python 解释器。
第三步：打开浏览器访问 http://localhost:8000；首次加载可能需 15–30 秒，页面空白超过 45 秒未响应，说明端口被占用——检查是否已有其他程序（如 VS Code Live Server、Docker Desktop）占用了 8000 端口。
云端部署：选对平台，配置一步到位
方法一：阿里云轻量应用服务器（推荐）
① 登录阿里云控制台 → 轻量应用服务器 → 镜像市场 → 搜索“Hermes Agent 官方预装镜像” → 选择对应地域（百炼 API Key 所属地域必须一致，如 Key 在华东1，则选杭州）；
② 实例创建后，进入“应用详情页”，点击“配置 Hermes”，在弹窗中【务必从下拉菜单选取已开通的 Coding Plan API Key】，手动粘贴 Key 极易因末尾换行符或隐藏空格导致验证失败；
③ 点击“安全代理访问”，获取带有效期的 WebUI 地址——该地址自带反向代理与 HTTPS，无需额外配置 Nginx 或证书。
方法二：腾讯云 Lighthouse（Windows 用户首选）
直接跳过 WSL2 安装步骤；在 Lighthouse 控制台选择 Ubuntu 22.04 镜像 → 一键启用 Docker → 执行官方安装脚本：curl -fsSL https://raw.githubusercontent.com/NousResearch/Hermes-Agent/main/install.sh | sh；
注意：Ubuntu 系统默认使用 apt 包管理器，若执行脚本时报 command not found: pip，先运行 sudo apt update && sudo apt install python3-pip 再重试。
模型对接：本地和云端配置差异极大
本地部署必须手动编辑 .env 文件：填入 LLM_PROVIDER=qwen + DASHSCOPE_API_KEY=sk-xxx + DASHSCOPE_BASE_URL=https://dashscope.aliyuncs.com/api/v1；【BASE_URL 末尾不能有多余斜杠】，否则请求会被截断，返回 404。
云端部署（阿里云/腾讯云）则通过可视化界面配置：进入 WebUI → Settings → Model Provider → 选择“Qwen via DashScope” → 粘贴 Key → 自动填充 URL；系统会校验 Key 格式与地域匹配性，错误时直接标红提示，不写入配置文件。
本地若用 Ollama 模型，需额外安装 Ollama 并执行 ollama pull qwen2.5:7b；云端不支持 Ollama，仅对接百炼、MiniMax、OpenRouter 等 API 类模型。
