Hermes Agent 必须通过内置 hermes gateway 统一接入多平台，禁止单独部署；需安装 Python 3.10+、pip upgrade、克隆仓库并带[all]选项安装依赖；初始化网关后按序配置 Telegram、Discord、微信（仅个人号）及飞书/钉钉/企微；最后启用并重启网关实现跨平台上下文共享。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
要让 Hermes Agent 同时在 Telegram、Discord、微信、飞书、钉钉、企业微信等多个平台收发消息并共享上下文，必须通过其内置的 hermes gateway 统一接入，不能为每个平台单独部署服务，否则会触发端口冲突、记忆断裂和会话隔离失效。
准备基础运行环境
确认系统已安装 Python 3.10 或更高版本：python --version。若未安装，请先升级系统 Python 或使用 pyenv 管理多版本。
执行 pip install --upgrade pip 更新包管理器，避免依赖解析失败。
克隆官方仓库并进入项目目录：git clone https://github.com/nousresearch/hermes-agent.git && cd hermes-agent。
安装核心依赖时【必须带上 [all] 选项】：pip install -e ".[all]"。漏掉该标记会导致 Telegram/Discord/飞书等适配器模块缺失，后续 gateway 启动时报 “no adapter found for telegram”。
初始化并启动网关服务
执行 hermes gateway init，生成默认配置目录 ~/.hermes/gateway/。
运行 hermes gateway start 启动服务，终端应输出 Gateway listening on http://127.0.0.1:8000 —— 这是网关就绪标志。
【不要修改 8000 端口】，因为微信扫码绑定流程硬编码依赖该端口回调；若提示 Failed to bind port 8000，请先执行 lsof -i :8000 | grep LISTEN 查杀占用进程，再重试。
逐平台接入配置
第一步：接入 Telegram
访问 BotFather 创建新 Bot → 获取 Token → 执行 hermes gateway setup telegram --token YOUR_TELEGRAM_BOT_TOKEN。
第二步：接入 Discord
前往 Discord Developer Portal 创建应用 → 新建 Bot → 开启 MESSAGE CONTENT INTENT → 复制 Token 和 Client ID → 运行 hermes gateway setup discord --token YOUR_DISCORD_BOT_TOKEN --client-id YOUR_DISCORD_CLIENT_ID。
第三步：接入微信（仅支持个人号）
执行 hermes gateway setup wechat，终端生成二维码 → 用任意个人微信客户端扫码 → 绑定成功后，该账号即成为「主控入口」，所有跨平台消息均路由至此调度。
注意：企业微信、微信工作台、公众号后台均不支持，否则会卡在 waiting for scan 超过 90 秒后自动退出。
扩展接入飞书/钉钉/企微
方法一：交互式命令行（推荐新手）
执行 hermes gateway setup → 依次选择 feishu / dingtalk / wechatwork → 输入对应平台的 App ID、App Secret、Verification Token 等凭证 → Domain 字段保持默认（feishu / dingtalk / wechatwork）→ Connection mode 选 websocket。
方法二：手动编辑 YAML 配置（适合批量或精细控制）
打开 config/gateway.yaml → 在 adapters: 下新增平台区块 → 填入 app_key、app_secret、encrypt_key、verification_token 四项必填字段 → 为每个平台指定唯一 webhook_path（如 /webhook/feishu）→ 保存后执行 hermes gateway reload 生效。
方法三：Docker 环境变量注入（适用于容器化部署）
在 docker run 命令中添加 -e HERMES_GATEWAY_FEISHU_APP_ID=xxx -e HERMES_GATEWAY_FEISHU_APP_SECRET=yyy → 启动时自动注入配置，无需手动编辑文件。
验证与启用多平台
执行 hermes gateway list，确认 telegram、wechat、feishu 等平台状态均为 enabled。
若某平台显示 disabled，需显式启用：hermes gateway enable telegram wechat feishu。
重启网关使全部配置生效：hermes gateway restart。
此时所有已配置平台的消息将统一进入 Hermes Agent 核心处理流，共享同一套记忆系统与工具调用上下文。
