下面是一版专门针对Ubuntu 22.04 / Ubuntu Server 22.04的 Hermes Agent 连接个人微信指南。这里说的是Weixin / 个人微信，不是企业微信 WeCom。Hermes 的微信适配器使用腾讯iLink Bot API，扫码后连接的是一个独立的 iLink Bot 身份，不是把你的普通微信号变成可完全控制的机器人；私聊最可靠，普通微信群通常不稳定或不可用。(Hermes Agent)0. 准备条件你需要：Ubuntu 22.04 一个可扫码登录的个人微信账号 一个可用的大模型提供商，例如 Nous Portal、OpenRouter、OpenAI、Anthropic、Qwen、DeepSeek、本地模型等 服务器能访问微信 iLink API 和微信 CDNHermes 官方安装器在 Linux 上主要需要git、curl、xz-utils；Python 3.11、Node.js v22、ripgrep、ffmpeg、uv 等会由安装器处理，不需要你手动安装。(Hermes Agent)先安装基础依赖：sudoaptupdatesudoaptinstall-ygitcurlxz-utils ca-certificates如果你是在桌面版 Ubuntu 上还想用 Hermes Desktop 或需要编译原生模块，可以额外装：sudoaptinstall-ybuild-essential1. 安装 Hermes Agent在 Ubuntu 22.04 终端执行：curl-fsSLhttps://hermes-agent.nousresearch.com/install.sh|bash安装完成后重新加载 shell：source~/.bashrc验证命令是否可用：hermes--version官方 Linux / macOS / WSL2 的 CLI 安装命令就是这个install.sh，安装后建议重新加载 shell。(Hermes Agent)如果hermes仍然提示找不到命令，检查 PATH：echo$PATHls-la~/.local/bin也可以临时执行：exportPATH="$HOME/.local/bin:$PATH"2. 先配置大模型，不要急着接微信微信只是消息入口，Hermes 本身必须先能正常和模型对话。官方也建议：如果普通 CLI 对话都不能正常工作，不要先叠加 Gateway、cron、skills 等功能。(Hermes Agent)推荐方式一：使用 Nous Portal 快速配置：hermes setup--portal推荐方式二：自己选择模型提供商：hermes model或者运行完整向导：hermes setup配置完成后测试：hermes输入：只回复：HERMES_OK如果能正常返回HERMES_OK，再继续配置微信。配置文件位置主要是：~/.hermes/config.yaml ~/.hermes/.env官方说明中，普通配置存放在~/.hermes/config.yaml，密钥和 token 等敏感信息放在~/.hermes/.env。(Hermes Agent)3. 安装微信适配器依赖Hermes 的 Weixin 适配器需要：aiohttp cryptography其中cryptography用于微信图片、视频、文件等媒体的 CDN 加解密。官方 Weixin 文档列出的依赖就是这两个包，并说明终端二维码显示依赖 messaging extra。(
