# 企业微信自建应用配置指南

本指南帮助你在企业微信中创建自建应用，并配置 OpenClaw 接入。

<div align="center">

  <p>
    <strong>⭐ 如果这个项目对你有帮助，请给我们一个Star！⭐</strong><br>
    <em>您的支持是我们持续改进的动力</em>
  </p>

</div>

> **⚠️ 重要提示**：WeCom App 插件专注于**私聊场景**，不支持群聊功能。如需群聊支持，请考虑使用其他方案。

## 自建应用 vs 智能机器人

| 功能            | 智能机器人 (wecom) | 自建应用 (wecom-app) |
| :-------------- | :----------------: | :------------------: |
| 被动回复消息    |         ✅         |          ✅          |
| 主动发送消息    |         ✅         |          ✅          |
| 支持群聊        |         ✅         |          ❌          |
| 需要企业认证    |         ❌         |          ❌          |
| 需要 corpSecret |         ❌         |          ✅          |
| 需要 IP 白名单  |         ❌         |          ✅          |
| 图片/文件 | 出站文件不支持 | 出站任意类型；入站允许图片、音视频、定位、语音 |
| 配置复杂度      |        简单        |         中等         |

**推荐使用自建应用的场景**：

- 需要主动推送消息给用户
- 需要更灵活的消息发送能力
- 需要调用企业微信 API
- **只需要私聊功能**（不支持群聊）

## 效果展示

<div align="center">

### 微信入口

<img src="image/configuration/1770106970867.png" width="48%" />
<img src="image/configuration/1770106983366.png" width="48%" />

---

### 对话效果

<img src="image/configuration/1770107297696.png" width="48%" />
<img src="image/configuration/1770273261225.png" width="48%" />

</div>

---

## 前置条件

1. 一个企业微信账号（可使用个人注册的企业）
2. 公网可访问的服务器（用于接收回调）
3. OpenClaw 已安装并运行
4. Node.js 和 pnpm（用于构建插件）

### 步骤零. 注册并登录企业微信

访问 <https://work.weixin.qq.com/>，按页面提示注册并进入管理后台。

教程可参考此文档的【注册并登录企业微信】：https://github.com/BytePioneer-AI/openclaw-china/blob/main/doc/guides/wecom/configuration.md

### 步骤一：安装 wecom-app 插件

支持两种安装方式，按需选择：

### 方式一：从 npm 安装（推荐）

> ⚠️ **Windows 用户注意**：若遇到 `spawn npm ENOENT` 错误，请改用方式二（源码安装）。
>
> 原贡献者仓库：https://github.com/RainbowRain9/openclaw-china.git

**安装聚合包（包含所有渠道插件）**

```bash
openclaw plugins install @openclaw-china/channels
openclaw china setup
openclaw config set gateway.bind lan
```

**或 仅安装 wecom-app 插件**

```bash
openclaw plugins install @openclaw-china/wecom-app
openclaw china setup
openclaw config set gateway.bind lan
```

### 方式二：从源码安装（适合开发调试 / Windows 兼容）

1. 克隆仓库

> 原贡献者仓库：https://github.com/RainbowRain9/openclaw-china.git
> BytePioneer-AI/openclaw-china 版本较新，建议用。

```bash
git clone https://github.com/BytePioneer-AI/openclaw-china.git
cd openclaw-china
pnpm install
pnpm build
openclaw plugins install -l ./packages/channels
openclaw china setup
openclaw config set gateway.bind lan
```

更新源码（后续升级）：

```bash
git pull origin main
pnpm install
pnpm build
```

> 必须执行 `openclaw config set gateway.bind lan` 否则后续可能会出现 回调地址不通过 的错误

---

## 步骤一：创建自建应用

请注意，我们一共需要下面这些数据：

```
"webhookPath": "/wecom-app", # 回调路径，默认即可
"token": "xxx",
"encodingAESKey": "xxx",
"corpId": "xxx",  # 企业 ID
"corpSecret": "xxx",
"agentId": xxx
```

### 1. 登录企业微信管理后台

访问 [企业微信管理后台](https://work.weixin.qq.com/wework_admin/frame) 并登录。

### 2. 获取企业 ID

1. 点击左侧菜单「我的企业」
2. 在「企业信息」页面底部找到「企业 ID」
3. 记录这个 ID（这就是 `corpId`）

<img src="image/configuration/1770105784942.png" />

### 3. 创建应用

1. 点击左侧菜单「应用管理」
2. 在「自建」区域点击「创建应用」

   <img src="image/configuration/1770105395578.png" />
3. 填写应用信息：

   - **应用名称**：例如 "AI 助手"
   - **应用 logo**：上传一个图标
   - **可见范围**：选择可以使用该应用的部门/成员

<img src="image/configuration/1770105469298.png" />

4. 点击「创建应用」

### 4. 获取应用凭证

创建成功后，进入应用详情页，记录以下信息：

- **AgentId**：应用的唯一标识（如 `1000002`）
- **Secret**：点击查看获取（这就是 `corpSecret`）

<img src="image/configuration/1770105739884.png" />



---

## 步骤二：配置接收消息服务器

### 1. 填写服务器配置

- **URL**：OpenClaw Gateway 的公网访问地址（企业微信会向这个地址发送消息回调）

  **格式**：`<协议>://<域名或IP>:<端口>/<路径>`

  **示例**：

  - 使用域名：`https://your.domain.com/wecom-app`
  - 使用 IP 地址（推荐，最简单）：`http://123.45.67.89:18789/wecom-app`

  **说明**：

  - **域名/IP**：填写你服务器的公网域名或公网 IP 地址
  - **端口**：填写 OpenClaw Gateway 监听的端口（默认 `18789`）
  - **路径**：必须与配置文件中的 `webhookPath` 一致（默认 `/wecom-app`）
  
  > 💡 **如何获取公网 IP**：在服务器上运行 `curl ifconfig.me` 或访问 [ifconfig.me](https://ifconfig.me)
  >

<img src="image/configuration/1770106232112.png" />

> **⚠️ 重要：在这里你可以暂停并开始【步骤三】**
>
> 1. 回调必须先将Wecom-app的OpenClaw配置完毕，并且 OpenClaw处于运行状态。
>
> 2. 必须执行 `openclaw config set gateway.bind lan` 否则后续可能会出现 回调地址不通过 的错误

<img src="image/configuration/1770106267509.png" />

### 2. 配置 IP 白名单

在应用详情页的「企业可信 IP」设置中，添加你服务器的公网 IP 地址。

<img src="image/configuration/1770106297408.png" />

> 💡 如果不知道服务器 IP，可以先尝试发送消息，查看错误日志获取 IP。

---

## 步骤三：配置 OpenClaw

### 使用命令行配置

**Linux/macOS**：

推荐：优先通过「配置向导」`openclaw china setup` 完成配置；下方命令用于手动配置。

```bash
openclaw config set channels.wecom-app '{
  "enabled": true,
  "webhookPath": "/wecom-app",
  "token": "your-random-token",
  "encodingAESKey": "your-43-char-encoding-aes-key",
  "corpId": "your-corp-id",
  "corpSecret": "your-app-secret",
  "agentId": 1000002,
  "apiBaseUrl": "https://wecom-proxy.example.com"
}' --json
openclaw config set gateway.bind lan
```

**Windows CMD**：

```cmd
openclaw config set channels.wecom-app.enabled true
openclaw config set channels.wecom-app.webhookPath /wecom-app
openclaw config set channels.wecom-app.token your-random-token
openclaw config set channels.wecom-app.encodingAESKey your-43-char-encoding-aes-key
openclaw config set channels.wecom-app.corpId your-corp-id
openclaw config set channels.wecom-app.corpSecret your-app-secret
openclaw config set channels.wecom-app.agentId 1000002
openclaw config set channels.wecom-app.apiBaseUrl https://wecom-proxy.example.com
openclaw config set gateway.bind lan

```

### 或直接编辑配置文件

编辑 `~/.openclaw/openclaw.json`：

```json
{
  "channels": {
    "wecom-app": {
      "enabled": true,
      "webhookPath": "/wecom-app",
      "token": "your-random-token",
      "encodingAESKey": "your-43-char-encoding-aes-key",
      "corpId": "your-corp-id",
      "corpSecret": "your-app-secret",
      "agentId": 1000002,
      "apiBaseUrl": "https://wecom-proxy.example.com",
      "asr": {
        "enabled": true,
        "appId": "your-tencent-app-id",
        "secretId": "your-tencent-secret-id",
        "secretKey": "your-tencent-secret-key"
      },
      "inboundMedia": {
        "enabled": true,
        "maxBytes": 10485760,
        "keepDays": 7
      }
    }
  }
}
```

### 配置说明

| 字段                      | 必填 | 说明                                                                    |
| :------------------------ | :--: | :---------------------------------------------------------------------- |
| `enabled`               |  ✅  | 是否启用该渠道                                                          |
| `webhookPath`           |  ✅  | 回调路径，需与企业微信后台配置一致                                      |
| `token`                 |  ✅  | 消息校验 Token，需与企业微信后台配置一致                                |
| `encodingAESKey`        |  ✅  | 消息加密密钥（43 位），需与企业微信后台配置一致                         |
| `corpId`                |  ✅  | 企业 ID                                                                 |
| `corpSecret`            |  ✅  | 应用的 Secret                                                           |
| `agentId`               |  ✅  | 应用的 AgentId                                                          |
| `apiBaseUrl`            |  ❌  | 企业微信 API 基础地址；默认 `https://qyapi.weixin.qq.com`，可改为 VPS 代理地址 |
| `welcomeText`           |  ❌  | 用户首次进入时的欢迎语                                                  |
| `asr.enabled`           |  ❌  | 是否启用语音转文本（腾讯云 Flash ASR）                                  |
| `asr.appId`             |  ❌  | 腾讯云 ASR AppID                                                        |
| `asr.secretId`          |  ❌  | 腾讯云 ASR SecretId                                                     |
| `asr.secretKey`         |  ❌  | 腾讯云 ASR SecretKey                                                    |
| `asr.engineType`        |  ❌  | ASR 引擎类型，默认 `16k_zh`                                             |
| `asr.timeoutMs`         |  ❌  | ASR 请求超时（毫秒），默认 `30000`                                      |
| `inboundMedia.enabled`  |  ❌  | 是否启用入站媒体落盘（默认启用）                                        |
| `inboundMedia.dir`      |  ❌  | 入站媒体归档目录（跨平台默认：`~/.openclaw/media/wecom-app/inbound`） |
| `inboundMedia.maxBytes` |  ❌  | 单个入站媒体最大字节数（默认 10MB）                                     |
| `inboundMedia.keepDays` |  ❌  | 入站媒体保留天数（默认 7 天；用于自动清理）                             |

### （可选）家庭局域网 + VPS 代理企微 API

当 OpenClaw 跑在家庭网络，但企业微信后台可信 IP 配置在 VPS 时，可以把 `apiBaseUrl` 指向你的 VPS 代理地址（例如 `https://wecom-proxy.example.com`）。

- 插件会在该地址后自动拼接 `/cgi-bin/...` 路径
- 不配置时默认使用 `https://qyapi.weixin.qq.com`
- 默认账号也可通过环境变量 `WECOM_APP_API_BASE_URL` 覆盖

---

## 步骤四：重启 Gateway

```bash
openclaw gateway restart
```

---

## 步骤五：验证配置

### 1. 回到企业微信后台保存配置

现在 OpenClaw 已启动，回到企业微信后台的「接收消息」设置，点击「保存」。

如果配置正确，会提示保存成功。

### 2. 测试消息收发

1. 在企业微信 App 中打开你创建的应用
2. 发送一条消息
3. 查看 OpenClaw 日志确认消息接收
4. 等待 AI 回复

### 3. 验证 `/verbose on` 实时输出（可选）

如果你经常使用工具调用、文件读取或命令执行，建议顺手验证一下 verbose 输出是否正常：

1. 先在企业微信会话里发送 `/verbose on`
2. 再发送一个会触发多步执行的请求，例如“读取几个文件后总结差异”
3. 正常情况下，verbose 日志会**按段陆续发送**
4. 不会等全部任务完成后，再把所有日志合并成一条消息统一发出

> 提示：
> - 这个能力依赖 `corpId`、`corpSecret`、`agentId` 已正确配置，且企业微信 IP 白名单允许当前出口 IP。
> - 如果你刚升级插件，请记得执行一次 `openclaw gateway restart`。

---

## 步骤六：在个人微信使用

### 1.回到企业微信后台

回到企业微信后台的「我的企业」设置下的微信插件

![微信插件](image/configuration/1770110656555.png)

用个人微信扫码「邀请关注」的二维码就可以在个人微信上打开入口

---

## 步骤七（可选）：开启语音转文本（ASR）

如果你希望企业微信语音消息自动转文字后再交给 Agent 处理，可按下面步骤配置腾讯云 ASR（录音文件识别极速版）。

> [!IMPORTANT]
> 当前 QQ 渠道的腾讯云 ASR 仅支持国内网络下启用。

### 1. 开通 ASR 服务

访问腾讯云语音识别产品页并点击“立即使用”：  
https://cloud.tencent.com/product/asr

说明：腾讯云 ASR 提供每月免费额度（以腾讯云控制台最新计费规则为准），额度如下：
- 录音文件识别极速版（`asr/flash/v1`）：5 小时/月

![qq-asr-free-quota](../../images/qq-asr-free-quota.png)

### 2. 创建 API 密钥

进入腾讯云控制台语音识别页（或对应 API 密钥管理页）创建密钥，获取：
- `appId`
- `secretId`
- `secretKey`

控制台入口：  
https://console.cloud.tencent.com/asr

![qq-asr-console-entry](../../images/qq-asr-console-entry.png)

![qq-asr-api-keys](../../images/qq-asr-api-keys.png)

### 3. 在 OpenClaw 中配置

默认账号：

```bash
openclaw config set channels.wecom-app.asr.enabled true
openclaw config set channels.wecom-app.asr.appId your-tencent-app-id
openclaw config set channels.wecom-app.asr.secretId your-tencent-secret-id
openclaw config set channels.wecom-app.asr.secretKey your-tencent-secret-key
```

多账号（示例：`app1`）：

```bash
openclaw config set channels.wecom-app.accounts.app1.asr.enabled true
openclaw config set channels.wecom-app.accounts.app1.asr.appId your-tencent-app-id
openclaw config set channels.wecom-app.accounts.app1.asr.secretId your-tencent-secret-id
openclaw config set channels.wecom-app.accounts.app1.asr.secretKey your-tencent-secret-key
```


### 4. 计费文档

请仔细查看腾讯云计费文档。

https://cloud.tencent.com/document/product/1093/35686?from=console_document_search#58abe873-a924-4b4d-b056-59510b66c4d3

![qq-asr-pricing-doc](../../images/qq-asr-pricing-doc.png)

---

## 入站媒体（图片/语音/文件）落盘说明

为了支持图片 OCR、回发原图、以及排查问题，wecom-app 会把入站媒体文件落盘保存。

- 文件会被归档到：`inboundMedia.dir/YYYY-MM-DD/`
- 消息正文里会显示：`[image] saved:<本地路径>`（该路径为稳定归档路径，便于后续处理）
- 自动清理由 `inboundMedia.keepDays` 控制（默认 7 天）

**为什么还会用 tmp 中转？**

内部会先下载到系统临时目录，再原子移动到归档目录，以避免“半文件/下载失败”污染归档目录。

**跨平台默认路径**

- Linux/macOS：`~/.openclaw/media/wecom-app/inbound`
- Windows：`%USERPROFILE%\.openclaw\media\wecom-app\inbound`

如需自定义，请设置：`channels.wecom-app.inboundMedia.dir`

---

## 常见问题

### Q: Unknown target "xxx" / Action send requires a target？

这类问题通常不是“权限问题”，而是 **target 写法不正确** 或 OpenClaw 无法解析。

#### ⚠️ 重要：target 不是"显示名/备注名"

在 wecom-app 通道中，**target 不是"显示名/备注名"**，而是插件能解析的"地址格式"。

**错误示例**：

```bash
# ❌ 错误：直接写用户名
send CaiHongYu 你好
# 报错：Unknown target "CaiHongYu"
```

**原因**：插件会把 `CaiHongYu` 当成一个"可解析的收件人标识"去查，但通讯录里并没有叫这个 key 的条目，所以报 **Unknown target**。

**正确示例**：

```bash
# ✅ 正确：使用 user: 前缀
send user:CaiHongYu 你好
# 成功发送（插件会归一化为 user:caihongyu）
```

#### Target 语法规则

**必须带类型前缀**，才能命中解析规则：

- **私聊用户**：`user:<UserId>`（例如：`user:CaiHongYu`）

**为什么需要前缀？**

- 带 `user:` 前缀，插件才能把它归一化成内部可投递标识
- 单独一个名字通常无法唯一定位收件人
- 插件会自动做大小写归一化（`user:CaiHongYu` → `user:caihongyu`）

#### 排查步骤

1. **确认前缀**：确认你用的是 `user:` 前缀，而不是"显示名/昵称"。
2. **获取真实 UserId**：如果你只有显示名，优先去企业微信后台/通讯录确认真实 `UserId`。
3. **查看日志**：查看 Gateway 日志中 wecom-app 的目录解析输出（关键词一般为 `wecom-app` / `directory` / `target`）。

> 💡 经验：显示名在不同租户/同名用户/大小写场景下会导致解析失败；用 `user:<UserId>` 基本不会错。

### Q: 为什么 SVG 发出去不是图片？

企业微信自建应用对 **图片消息** 的支持通常偏向 `png/jpg`。`svg` 经常会被客户端当作“文件”，或者走图片通道失败。

- 建议：发送 `png/jpg`。
- 如果你必须发 `svg`：把它当 **文件** 发（本插件已对 `.svg` 强制按文件发送，避免误判）。

### Q: 为什么 WAV/MP3 语音发不出去（ok=false）？

企业微信的“语音消息(voice)”通常要求 `amr/speex` 等格式；`wav/mp3` 很常见会导致上传/发送失败，或无法按语音气泡展示。

**推荐方案（自动兜底）**

当前默认就会启用自动转码；只有显式配置 `voiceTranscode.enabled=false` 时才会关闭。

- 常见音频（如 `wav/mp3/ogg/m4a/aac/flac/wma`）会优先转成 `.amr` 再发送 `voice`
- 插件会优先使用内置 `ffmpeg-static`；本地开发或特殊环境下再回退到系统 `ffmpeg`
- 如果转码后的 `voice` 上传/发送失败，会自动降级为 `file` 发送，保证尽量可达

配置示例（openclaw.json）：

```jsonc
{
  "channels": {
    "wecom-app": {
      "voiceTranscode": {
        "enabled": true,
        "prefer": "amr"
      }
    }
  }
}
```

**手动转码（ffmpeg）**

```bash
ffmpeg -i in.wav -ar 8000 -ac 1 -c:a amr_nb out.amr
```

### Q: 保存配置时提示验证失败？

1. 检查 OpenClaw 是否已启动并监听正确端口
2. 确认 `webhookPath` 与后台 URL 路径一致
3. 确认 `token` 和 `encodingAESKey` 与后台配置完全一致
4. 确认服务器公网可访问（可用 `curl` 测试）
5. `openclaw config set gateway.bind lan`

### Q: 消息接收成功但发送失败？

1. 检查 `corpId`、`corpSecret`、`agentId` 是否正确
2. 检查是否已配置 IP 白名单
3. 查看 OpenClaw 日志获取详细错误信息

### Q: 开启 `/verbose on` 后，日志还是等全部结束才一起发？

正常情况下，`wecom-app` 会把 verbose 输出按 chunk 逐段主动发送，而不是等任务结束后整包合并发送。

如果你仍然看到“最后一次性发完”，按下面顺序排查：

1. **确认插件已升级到最新代码**

   如果你是源码安装，请执行：

   ```bash
   git pull origin main
   pnpm install
   pnpm build
   openclaw gateway restart
   ```

2. **确认主动发送能力完整可用**

   以下字段必须正确：

   - `corpId`
   - `corpSecret`
   - `agentId`

   同时要确认企业微信后台的 **可信 IP / IP 白名单** 已包含当前 OpenClaw 出口 IP。

3. **确认当前运行的是新进程**

   如果你使用的是守护进程或后台运行方式，只改代码不重启不会生效。建议执行：

   ```bash
   openclaw gateway restart
   ```

4. **重新做一次最小验证**

   - 先发 `/verbose on`
   - 再发一个会触发多步执行的请求
   - 观察日志是否分多条陆续到达

> 说明：
> - 企业微信客户端本身可能有轻微展示延迟，但正常表现仍应是“逐段陆续出现”，而不是“最后只来一大条”。
> - 如果主动发送能力不可用，插件会回退到已有的 stream 占位/刷新路径，但不会有同样的实时逐段推送体验。

---

## 高级配置

### 访问控制

```json
{
  "channels": {
    "wecom-app": {
      "enabled": true,
      "dmPolicy": "open",
      "allowFrom": []
    }
  }
}
```

| 字段               | 说明                                                                        |
| :----------------- | :-------------------------------------------------------------------------- |
| `dmPolicy`       | 私聊策略：`open`（任何人）/ `pairing`（配对）/ `allowlist`（白名单）/ `disabled`（禁用） |
| `allowFrom`      | 私聊白名单用户 ID 列表（当 `dmPolicy` 为 `allowlist` 时生效）               |

### 多账户配置

如需配置多个自建应用，可以使用 accounts 对象（键为账户 ID）：

```json
{
  "channels": {
    "wecom-app": {
      "enabled": true,
      "accounts": {
        "app1": {
          "webhookPath": "/wecom-app-1",
          "token": "token-1",
          "encodingAESKey": "key-1",
          "corpId": "corp-id",
          "corpSecret": "secret-1",
          "agentId": 1000002
        },
        "app2": {
          "webhookPath": "/wecom-app-2",
          "token": "token-2",
          "encodingAESKey": "key-2",
          "corpId": "corp-id",
          "corpSecret": "secret-2",
          "agentId": 1000003
        }
      }
    }
  }
}
```

> 提示：
> - 多账号共用同一路径/Token 时，系统会优先按入站消息里的 `AgentID` 匹配账号 `agentId`。
> - 若仍存在多候选，会记录告警并回退第一个匹配账号。
> - 为减少歧义，建议每个账号使用独立的 `webhookPath` / `token` / `encodingAESKey`。

多 agent 分流（bindings）示例：
```json
{
  "bindings": [
    { "agentId": "main", "match": { "channel": "wecom-app", "accountId": "app" } },
    { "agentId": "work", "match": { "channel": "wecom-app", "accountId": "app1" } }
  ]
}
```
> 说明：如果只用默认 `main`，可以不配置 `bindings`；多账号分流到不同 agent 时必须配置。

开发验证：
```bash
pnpm -C extensions/wecom-app test
```

---

## （可选）安装 wecom-app 运维/使用 Skill

本仓库提供本地技能包：`extensions/wecom-app/skills/wecom-app-ops`，用于指导 wecom-app 常见操作（如何获取/规范化 target、如何回发图片/录音/文件、如何使用 saved 路径做 OCR、常见报错排障等）。

**安装到全局**

```bash
mkdir -p ~/.openclaw/skills
cp -a ~/.openclaw/extensions/openclaw-china/extensions/wecom-app/skills/wecom-app-ops ~/.openclaw/skills/
```

复制后一般无需重启网关；**如果你希望立刻出现在“可触发 skills 列表”里**，建议重启一次 Gateway 以刷新 skills 索引。

---

## wecom-app 已实现功能清单（Feature List）

本插件当前已实现/覆盖：

### 入站（接收消息）

- Webhook 接收回调
- 签名校验 + 解密/加密回包
- 支持 **JSON + XML** 两种入站格式
- 长文本分片（企业微信单条约 2048 bytes 限制）
- stream 占位/刷新（为适配企业微信 5 秒响应限制）
- 开启 `/verbose on` 时，工具日志与中间回复支持按 chunk 逐段主动发送，而不是结束后整包合并

### 入站媒体（产品级留存）

**Why / 设计动机**

- 产品化目标是“消息里的 `saved:` 路径可长期复用”，而不是依赖 `/tmp` 这类易被清理的短期目录。
- 这样 OCR/MCP、二次回发、归档/审计等流程才不会因为文件丢失而不稳定。
- 支持 `image` / `voice` / `file` / `mixed`
- 优先通过 `MediaId` 下载媒体；必要时回退 URL（如图片 PicUrl）
- 媒体落盘：先 tmp 中转，再归档到 `inboundMedia.dir/YYYY-MM-DD/`
- 消息体注入稳定路径：`[image] saved:/...` / `[voice] saved:/...` / `[file] saved:/...`
- 过期清理：按 `inboundMedia.keepDays` 延迟清理（避免“回复后立刻删”导致 OCR/回发失败）
- 大小限制：按 `inboundMedia.maxBytes` 限制单文件大小

### 出站（主动发送）

- 支持主动发送文本
- 主动发送文本会自动按企业微信单条长度限制分片
- 支持主动发送媒体（按 MIME/扩展名识别 image/voice/file）
- Markdown 降级：`stripMarkdown()` 将 Markdown 转为企业微信可显示的纯文本

### 目标解析与路由

- 支持多种 target 输入格式：
  - `wecom-app:user:<id>`
  - `user:<id>`
  - 裸 id（默认当 user）
  - `xxx@accountId`（带账号选择）
- **自动回复到当前会话**：
  - 私聊消息：`message.send({ text: "..." })` 自动回复到发送者
  - 无需每次指定 `target` 参数
  - 仍可通过 `target` 参数显式指定其他接收者

### 多账号与策略

- 支持 `defaultAccount` + `accounts` 多账号
- DM 策略：`dmPolicy`（open/pairing/allowlist/disabled）
- allowlist：`allowFrom`
- 入站媒体配置：`inboundMedia.enabled/dir/maxBytes/keepDays`

---

## 相关链接

- [企业微信开发文档](https://developer.work.weixin.qq.com/document/)
- [企业微信管理后台](https://work.weixin.qq.com/wework_admin/frame)
- [OpenClaw 文档](https://github.com/OpenClawAI/OpenClaw)