## 概述

云上 Hermes Agent 如何接入微信？腾讯云 Lighthouse 提供可视化配置面板，仅需扫码即可极简接入。

如果你还不了解 Hermes Agent，或尚未在 Lighthouse 中部署 Hermes Agent，建议先参考 [《玩转 Hermes Agent｜使用 Lighthouse 快速部署云上 Hermes Agent》](https://cloud.tencent.com/developer/article/2653159) 完成部署。本文聚焦"部署完成后如何把微信接进来"。

---

## 前置准备

在开始之前，请依次确认以下事项：

- 你的微信 App 已升级至较新版本（iOS：8.0.70 及以上；Android：8.0.69 及以上）
    
- 你已在腾讯云 Lighthouse 中部署 Hermes Agent。如果尚未部署，参考 [《使用 Lighthouse 快速部署云上 Hermes Agent》](https://cloud.tencent.com/developer/article/2653159)
    
- 你已在 Hermes Agent 配置面板中完成**模型（Models）**配置（否则机器人收到消息也无法生成回复）。若尚未配置，参考总教程的 [「步骤二：配置模型」](https://cloud.tencent.com/developer/article/2653159)
    

> 云上 Hermes Agent 接入微信场景推荐使用国内地域的 Lighthouse 实例与国内模型服务。

---

## 接入微信

微信通道采用扫码接入方式，是所有通道中配置最简单的一种，整个流程通常 1 分钟内完成。

### 1. 进入 Hermes Agent 配置面板

登录 [腾讯云 Lighthouse 控制台](https://console.cloud.tencent.com/lighthouse)，找到已部署 Hermes Agent 的实例，单击实例卡片任意空白处进入实例详情页，在顶部导航中切换到**应用管理**页。

此时你会看到 Hermes Agent 配置面板，从左到右依次是：模型（Models）、通道（Channels）、技能（Skills）三个卡片。

> ⚠️ 如果应用管理页展示的只是"应用内软件信息"（Hermes Agent 版本号、官方文档链接），说明当前应用模板版本较旧，未集成可视化配置面板。需要通过"重装系统"选择最新的 Hermes Agent 应用模板升级，具体参考总教程的 [「方式二：重装一台现有的 Lighthouse」](https://cloud.tencent.com/developer/article/2653159)。重装会清空服务器内数据，如有重要内容请先备份。

### 2. 选择微信通道

在**通道（Channels）**卡片的下拉框中选择「微信」，下方显示微信通道介绍与「查看详情」链接。

### 3. 点击「授权接入」

卡片中弹出微信扫码二维码。
![Clipboard_Screenshot_1777118395.png](https://developer.qcloudimg.com/http-save/yehe-11556714/fb242e36d717f8c28ebbf88a2591a432.png)

> ⚠️ **二维码有时效**
>
> 二维码几分钟后会自动失效。若已过期，关闭弹窗重新单击「授权接入」即可生成新二维码。

### 4. 使用手机微信扫码

1. 打开手机微信
    
2. 点击右上角「+」→「扫一扫」
    
3. 对准电脑屏幕上的二维码扫描
    
4. 手机微信弹出授权页面，在页面底部单击「继续连接」
    

> ℹ️ **微信只能与一个 Agent 建立连接**
>
> 如果你的微信此前已经授权过另一个 Agent（例如 OpenClaw），授权页会提示"当前微信已连接一个 OpenClaw，继续连接将解除原有的连接"，单击「继续连接」会覆盖掉原来的授权。

### 5. 在微信中查找 Hermes Agent

扫码成功后：

- 扫码弹窗自动关闭，配置面板的**「已接入通道」**列表中新增一条"微信"记录
    
- 手机微信的联系人中自动添加一个机器人账号
    

进入该机器人的聊天界面，发送测试消息：

```
你好，请做一下自我介绍
```

![Clipboard_Screenshot_1777118494.png](https://developer.qcloudimg.com/http-save/yehe-11556714/30a26db3c7686909be947a675060abee.png)

如果一切正常，几秒内即可收到 Hermes Agent 的回复，说明微信通道已经接入成功。

---

## 成功状态

- Hermes Agent 配置面板的「已接入通道」列表中出现"微信"记录
    
- 微信联系人中能找到对应的机器人账号
    
- 发送消息后能收到 AI 方式的回复
    

---

## 支持的消息类型

接入成功后，微信机器人除了能够接收、回复基础文本信息外，还支持更多消息类型，详情如下：

| 微信机器人支持的消息类型 | 是否支持 |
| --- | --- |
| 接收文本信息 | ✅ 已支持 |
| 接收图片、视频 | ✅ 已支持 |
| 接收文件 | ✅ 已支持 |
| 接收语音消息 | ✅ 已支持 |
| 回复文本信息 | ✅ 已支持 |
| 回复图片、视频 | ✅ 已支持 |
| 回复文件 | ✅ 已支持 |
| 主动发送消息（如定时发送提醒） | ✅ 已支持 |

> ℹ️ **实际处理能力取决于模型**
>
> 上表仅代表微信机器人在消息通道层面支持接收、回复的类型。能否实际完成处理图片、文件、语音等任务，还取决于 Hermes Agent 所接入的大语言模型是否具备对应的处理能力。例如要让 Hermes Agent 分析图片，需要配置支持图片理解的多模态模型。

---

## 通道说明

- **消息类型**：支持文本、图片、视频、文件、语音等多种类型，详见上方「支持的消息类型」
    
- **群聊支持**：当前不支持群聊，仅支持 1 对 1 对话
    
- **连接中断**：长时间无响应可能为授权被撤销，回到配置面板重新单击「授权接入」完成绑定即可
    

---

## 常见问题

| 现象 | 可能原因 | 处理方式 |
| --- | --- | --- |
| 扫码后微信提示"无效二维码" | 二维码已过期 | 关闭弹窗，重新单击「授权接入」 |
| 扫码完成后配置面板无响应 | 网络延迟或授权未完成 | 刷新应用管理页确认状态；若未接入成功则重新操作一次 |
| 微信中找不到机器人联系人 | 消息被折叠至"服务通知"中 | 在微信顶部搜索框中搜索机器人名称 |
| 发送消息后无回复 | 模型未配置或模型服务账户余额不足 | 进入配置面板「模型」卡片，检查「当前模型」状态；登录模型服务商控制台确认余额 |
| 如何解除绑定 | — | 在「已接入通道」列表中删除"微信"记录，或在微信端解除对机器人的授权 |
| 如何更换接入的微信号 | — | 先在当前微信解除授权，再回到配置面板重新单击「授权接入」，用新的微信扫码 |

---

## 更多教程

更多云上 Hermes Agent 实践教程，如一键部署 Hermes Agent、配置模型、接入 QQ/飞书、安装并使用技能（Skills）等，欢迎查看 [Hermes Agent 部署总教程](https://cloud.tencent.com/developer/article/2653159)。

云上 Hermes Agent 如何接入微信？腾讯云 Lighthouse 提供可视化配置面板，仅需扫码即可极简接入。

玩转 Hermes Agent｜云上 Hermes Agent 快速接入微信指南

云计算

人工智能

客户端

腾讯云Lighthouse极简接入微信机器人HermesAgent，扫码1分钟完成配置。支持文本、图片、视频、文件等消息类型，需提前部署HermesAgent并配置模型服务。国内地域实例推荐，详细操作指南助您快速实现AI对话功能。

4核4G3M云服务器 新用户低至38元/年！

lighthouse

2026采购季 | AI焕新·智启新局

文章

问答

视频

教程

学习中心

腾讯云实验室

直播

竞赛

腾讯云代码分析专区

腾讯iOA零信任安全管理系统专区

腾讯云架构师技术同盟交流圈

腾讯云数据库专区

腾讯云智能顾问专区

腾讯云原生专区

腾讯混元专区

腾讯云TCE专区

腾讯云Lighthouse专区

腾讯云HAI专区

腾讯云Edgeone专区

腾讯云存储专区

腾讯云智能专区

腾讯轻联专区 

腾讯云开发专区

TAPD专区

腾讯轻量云游戏服专区

腾讯云最具价值专家

腾讯云架构师技术同盟

腾讯云创作之星

腾讯云开发者先锋

腾讯云AI代码助手

云原生构建

TAPD 敏捷项目管理

Cloud Studio

SDK中心

API中心

命令行工具

功能1上新10个字符

功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符功能2描述100个字符。

功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符功能2上新100个字符。

功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符功能5描述100个字符

功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符功能5上新100个字符

功能4上新

文章&问答评论现已支持表情

全新交互，全新视觉，新增快捷键、悬浮工具栏、高亮块等功能并同时优化现有功能，全面提升创作效率和体验

社区富文本编辑器全新改版！诚邀体验～ 

精选全网热门MCP server，让你的AI更好用 🚀

💥开发者 MCP广场重磅上线！

涵盖代码开发、场景应用、自动测试全流程，助你从零构建专属AI助手

一站式MCP教程库，解锁AI应用新玩法

聚焦“写作效率、视觉美观与运行性能”三方面进行全面升级，为您提供更高效、稳定的创作环境

社区富文本&Markdown编辑器全新改版上线，欢迎大家体验!

诚挚邀请您参与本次调研，分享您的真实使用感受与建议。您的反馈至关重要，感谢您的支持与参与！

社区新版编辑器体验调研

玩转 Hermes Agent｜云上 Hermes Agent 快速接入微信指南-腾讯云开发者社区-腾讯云

玩转 Hermes Agent｜云上 Hermes Agent 快速接入微信指南

玩转 Hermes Agent｜云上 Hermes Agent 快速接入微信指南

社区

活动

圈层

关于

腾讯云开发者

热门产品

热门推荐

更多推荐