# 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
**需要发送图片的时候可以在控制台输出如下内容**
```
图片URL1
图片URL2
图片URL3
图片URL4
```
**需要发送视频的时候可以在控制台输出如下内容**
```
视频URL1
视频URL2
```
**需要发语音的时候可以在控制台输出如下内容**
```
语音URL1
语音URL2
```
**发送图片的时候也可以调用 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"
}
```