119 lines
2.7 KiB
Markdown
119 lines
2.7 KiB
Markdown
# 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
|
||
|
||
**需要发送图片的时候可以在控制台输出如下内容**
|
||
|
||
```
|
||
<wechat-robot-image-url>图片URL1</wechat-robot-image-url>
|
||
<wechat-robot-image-url>图片URL2</wechat-robot-image-url>
|
||
<wechat-robot-image-url>图片URL3</wechat-robot-image-url>
|
||
<wechat-robot-image-url>图片URL4</wechat-robot-image-url>
|
||
```
|
||
|
||
**需要发送视频的时候可以在控制台输出如下内容**
|
||
|
||
```
|
||
<wechat-robot-video-url>视频URL1</wechat-robot-video-url>
|
||
<wechat-robot-video-url>视频URL2</wechat-robot-video-url>
|
||
```
|
||
|
||
**需要发语音的时候可以在控制台输出如下内容**
|
||
|
||
```
|
||
<wechat-robot-voice-url>语音URL1</wechat-robot-voice-url>
|
||
<wechat-robot-voice-url>语音URL2</wechat-robot-voice-url>
|
||
```
|
||
|
||
**发送图片的时候也可以调用 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"
|
||
}
|
||
```
|