# wechat-robot-skills

微信机器人 Skills

**系统自动注入的环境变量**

- ROBOT_WECHAT_CLIENT_PORT: 机器人客户端服务端口，可用于在 SKILL 脚本直接调用客户端接口 `http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/xxxxx`

- ROBOT_ID: 机器人实例 ID

- ROBOT_CODE: 机器人实例编码

- MYSQL_HOST: mysql 地址

- MYSQL_PORT: mysql 端口

- MYSQL_USER: mysql 账号

- MYSQL_PASSWORD: mysql 密码

- ROBOT_REDIS_DB: 机器人的 Redis DB

- ROBOT_WX_ID: 机器人的微信 ID

- ROBOT_FROM_WX_ID: 微信消息来源(群聊 ID 或者好友微信 ID)

- ROBOT_SENDER_WX_ID: 微信消息发送人的微信 ID

- ROBOT_MESSAGE_ID: 微信消息 ID

- ROBOT_REF_MESSAGE_ID: 如果是引用消息，则是引用的消息的 ID

**发送图片的时候可以调用 Agent 接口**

1. 发送远程图片地址

```
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1//robot/message/send/image/url

请求体 Body:

{
  "to_wxid": "{{ROBOT_FROM_WX_ID}}",
  "image_urls": ["{{imageurl}}"]
}

```

2. 发送本地图片路径

```
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1//robot/message/send/image/local

请求体 Body:

{
  "to_wxid": "{{ROBOT_FROM_WX_ID}}",
  "file_path": "{{file_path}}"
}

```

**发送视频的时候可以调用 Agent 接口**

```
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/video/url

请求体 Body:

{
  "to_wxid": "{{ROBOT_FROM_WX_ID}}",
  "video_urls": ["{{videourl}}"]
}
```

**发送语音的时候可以调用 Agent 接口**

```
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/voice

说明:
该接口用于上传语音文件并发送给指定微信用户或群聊。
请求方式为 multipart/form-data，支持 .amr、.mp3、.wav 格式，单个文件大小不能超过 50MB。

表单参数:
- to_wxid: 接收方微信 ID，必填
- voice: 语音文件，必填

请求体 Body:

{
  "to_wxid": "{{ROBOT_FROM_WX_ID}}",
  "voice": "@/path/to/voice.amr"
}
```

**Agent 发送文本消息接口(可以 艾特/@/提及 某个人/某些人)**

```
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/text

请求体 Body:

{
  "to_wxid": "{{ROBOT_FROM_WX_ID}}",
  "content": "", // 你需要发送的文本内容
  "at": [], // 字符串数组，你要艾特的人的微信 id
}
```

**Agent 发送表情消息接口**

```
[POST] http://127.0.0.1:{ROBOT_WECHAT_CLIENT_PORT}/api/v1/robot/message/send/emoji

请求体 Body:

{
  "to_wxid": "{{ROBOT_FROM_WX_ID}}",
  "Md5": "xxxxxxx", // 表情 md5
  "TotalLen": 263, // 表情长度
}
```