---
title: 企微智能机器人
description: 将 CowAgent 接入企业微信智能机器人（长连接模式）
---

> 通过企业微信智能机器人接入CowAgent，支持企业内部单聊和内部群聊，无需公网 IP，使用 WebSocket 长连接模式，支持Markdown渲染和流式输出。

<Note>
  智能机器人与企业微信自建应用是两种不同的接入方式。智能机器人使用 WebSocket 长连接，无需服务器公网 IP 和域名，配置更简单。
</Note>

## 一、创建智能机器人

1. 打开企业微信客户端，进入工作台，点击**智能机器人**：

<img src="https://cdn.link-ai.tech/doc/20260316180959.png" width="800"/>

2. 点击创建机器人 - 手动创建：

<img src="https://cdn.link-ai.tech/doc/20260316181118.png" width="800"/>

3. 右侧窗口拖到最下方，选择**API模式创建**：

<img src="https://cdn.link-ai.tech/doc/20260316181215.png" width="800"/>

4. 设置机器人名称、头像、可见范围，并选择**长连接模式**，记录下 **Bot ID** 和 **Secret** 信息后点击保存。

## 二、配置和运行

### 方式一：Web 控制台接入

启动Cow项目后打开 Web 控制台 (本地链接为: http://127.0.0.1:9899/ )，选择 **通道** 菜单，点击 **接入通道**，选择 **企微智能机器人**，填写上一步保存的 Bot ID 和 Secret，点击接入即可。

<img src="https://cdn.link-ai.tech/doc/20260316181711.png" width="800"/>

### 方式二：配置文件接入

在 `config.json` 中添加以下配置：

```json
{
  "channel_type": "wecom_bot",
  "wecom_bot_id": "YOUR_BOT_ID",
  "wecom_bot_secret": "YOUR_SECRET"
}
```

| 参数 | 说明 |
| --- | --- |
| `wecom_bot_id` | 智能机器人的 BotID |
| `wecom_bot_secret` | 智能机器人的 Secret |

配置完成后启动程序，日志显示 `[WecomBot] Subscribe success` 即表示连接成功。

## 三、功能说明

| 功能 | 支持情况 |
| --- | --- |
| 单聊 | ✅ |
| 群聊（@机器人） | ✅ |
| 文本消息 | ✅ 收发 |
| 图片消息 | ✅ 收发 |
| 文件消息 | ✅ 收发 |
| 流式回复 | ✅ |
| 定时任务主动推送 | ✅ |

## 四、使用

在企业微信中搜索创建的机器人名称，即可开始单聊对话。

如需在企微内部群聊中使用，将机器人添加到群中，@机器人发送消息即可。

<img src="https://cdn.link-ai.tech/doc/20260316182902.png" width="800"/>
