龙虾 OpenClaw 微信发送小程序：miniprogram类型
要通过龙虾 OpenClaw 平台向微信用户发送小程序卡片消息，需要将消息类型设置为 miniprogram。这种消息类型能在聊天界面直接展示小程序的标题、封面图，点击即可跳转至指定页面，适用于服务通知、营销推广等场景。
准备工作
在编写代码前，需准备好以下核心参数：
- 获取小程序的
AppID（以wx开头的一串字符串）。 - 确定小程序页面的具体路径，例如
pages/index/index。 - 上传小程序封面图至微信素材库，获取
thumb_media_id。
构建消息体
构建符合 OpenClaw 规范的 JSON 数据结构。设置 msgtype 字段为 miniprogram，并在 miniprogram 对象中填充具体信息。
{
"touser": "OPENID",
"msgtype": "miniprogram",
"miniprogram": {
"title": "我的小程序标题",
"appid": "wx1234567890abcdef",
"pagepath": "pages/index/index?id=123",
"thumb_media_id": "MEDIA_ID_HERE"
}
}参数说明
下表详细列出了 miniprogram 对象中各字段的含义与填写要求。
| 字段名 | 类型 | 必填 | 说明 |
|---|---|---|---|
title |
String | 是 | 小程序卡片的标题，最多 128 字节 |
appid |
String | 是 | 小程序 AppID |
pagepath |
String | 是 | 小程序页面路径，参数可拼接在 URL 后 |
thumb_media_id |
String | 是 | 小程序卡片封面的素材 ID |
发送流程
执行以下步骤完成消息的发送：
- 组装上述 JSON 数据，替换
touser为目标用户的 OpenID。 - 调用 OpenClaw 的消息发送接口，将 JSON 作为请求体 Body 发送。
- 检查返回结果中的
errcode。若值为0，则表示发送成功。
为了更直观地理解数据流向与处理逻辑，请参考以下流程图：
graph TD
A["Start: Prepare Data"] --> B["Get AppID & PagePath"]
B --> C["Upload Image -> Get MediaID"]
C --> D["Build JSON Payload"]
D --> E["Call OpenClaw API"]
E --> F{"Check Result"}
F -- "errcode = 0" --> G[Success]
F -- "errcode != 0" --> H[Fail: Check Error Message]
常见错误排查
若发送失败，请重点检查以下两项：
- 确认
pagepath必须是已发布的小程序页面路径，且该小程序必须已关联到公众号。 - 验证
thumb_media_id是否有效，且图片尺寸建议为 564 * 314 像素，以保证显示效果最佳。
暂无评论，快来抢沙发吧！