需配置本地服务监听所有ip、获取局域网ip直连、用ngrok实现外网穿透、配置微信消息网关，或通过termux调用api，以实现手机远程访问hermes agent。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您已在本地电脑部署 Hermes Agent，但希望通过手机远程访问并与其交互，则需解决网络可达性、服务暴露方式与移动端接入路径三方面问题。以下是实现该目标的具体操作步骤：
一、启用本地服务并配置监听地址
默认情况下，Hermes Agent 启动时仅绑定 127.0.0.1（本地回环），导致手机无法通过局域网访问。需修改其启动参数，使其监听所有网络接口，同时确保防火墙允许外部连接。
1、停止当前运行的 Hermes Agent 进程（如已启动）。
2、进入 Hermes Agent 项目根目录，执行以下命令启动服务并监听全部 IP：
3、确认端口已正确监听：运行 netstat -tuln | grep :8000（Linux/macOS）或 netstat -ano | findstr :8000（Windows），观察是否出现 0.0.0.0:8000 或 :::8000 条目。
4、在 Windows 系统中，打开“高级安全 Windows 防火墙”，新建入站规则，允许 TCP 端口 8000 的连接。
二、通过局域网 IP 直接访问 Web UI
此方法适用于手机与电脑处于同一 Wi-Fi 网络环境，无需公网暴露，安全性高且延迟低。关键在于获取电脑在局域网中的 IPv4 地址，并在手机浏览器中输入完整地址访问。
1、在电脑终端执行 ipconfig（Windows）或 ifconfig | grep "inet "（macOS/Linux），查找以 192.168.x.x 或 10.x.x.x 开头的 IPv4 地址。
2、记下该地址，例如 192.168.1.105。
3、在手机浏览器地址栏输入 http://192.168.1.105:8000，加载 Hermes Agent 的 Web 界面。
4、若页面空白或连接失败，检查手机与电脑是否在同一子网（如手机 IP 为 192.168.1.102，电脑为 192.168.1.105，掩码均为 255.255.255.0，则符合）。
三、使用 ngrok 实现外网穿透（无公网 IP 场景）
当手机使用移动数据或跨网络访问时，需借助反向代理工具将本地 8000 端口映射至公共 URL。ngrok 可生成临时 HTTPS 隧道，无需配置路由器，适合测试与临时使用。
1、访问 https://ngrok.com/download 下载对应系统客户端，解压后置于 Hermes Agent 项目目录下。
2、注册 ngrok 账号并获取 authtoken，执行命令完成登录：./ngrok config add-authtoken YOUR_AUTHTOKEN。
3、启动隧道：运行 ./ngrok http 8000，终端将显示类似 https://abcd-1234-5678-90ef.ngrok-free.app 的转发地址。
4、在手机浏览器中直接访问该 HTTPS 地址，即可与本地 Hermes Agent 交互。
5、注意：免费版 ngrok 每次重启会更换域名，且存在连接时长与带宽限制；如需固定域名，须升级至付费计划。
四、配置微信消息网关实现免浏览器交互
Hermes Agent 原生支持微信接入，通过统一消息网关将 Web 服务封装为微信聊天界面，用户扫码绑定后即可在微信中收发指令，无需手动输入地址或安装额外 App。
1、确保本地已配置有效的大模型 API KEY（如阿里云百炼、Qwen3-Max 等），并在 .env 文件中设置 LLM_PROVIDER=baichuan 及对应密钥字段。
2、在项目根目录下创建 wechat_config.yaml，填入企业微信/个人微信扫码登录所需参数（含 CORPID、SECRET、AGENT_ID 等，若使用个人微信则启用 wxpusher 模式）。
3、启动服务时启用微信插件：执行 hermes --enable-wechat。
4、终端输出二维码后，使用微信“扫一扫”功能扫描，完成绑定即刻开始对话。
5、此后所有指令均通过微信发送，响应自动返回，完全脱离浏览器依赖。
五、使用 Termux 在安卓设备上直连本地服务
对于熟悉命令行的用户，可在安卓手机安装 Termux，通过 SSH 或 curl 直接调用本地 Hermes Agent 的 REST API，实现轻量级、低资源占用的交互方式。
1、在安卓手机安装 Termux 应用（Google Play 或 F-Droid）。
2、执行 pkg install curl openssh 安装必要工具。
3、确认电脑局域网 IP（如 192.168.1.105），在 Termux 中运行：curl -X POST http://192.168.1.105:8000/api/chat -H "Content-Type: application/json" -d '{"message":"你好"}'。
4、查看返回 JSON 中的 reply 字段，即为 Hermes Agent 的响应内容。
5、可将常用请求保存为 Termux 别名或脚本，例如 alias hermes='curl -X POST http://192.168.1.105:8000/api/chat -H "Content-Type: application/json" -d'。
