这里说的「机器人」，通常不是微信里那个官方群机器人插件，而是：用 API 驱动已登录的个人微信节点，让业务系统能发、能收、能管好友和群。个人微信没有企业级官方会话开放接口可填；个人微信API二次开发文档里，能力是分模块的，可以按落地频率记一张清单。
很多人把「机器人」理解成一个 method。实际是：登录保活一条线，消息收发一条线，联系人与群一条线，朋友圈等能力按需再叠。通道不稳，上面叠什么都会像玄学。
消息（最先打通）
发文本postText；群 @ 配ats（content里还要有@昵称）。图片、文件、链接、视频有各自接口，别往文本里硬塞。收消息走 Webhook，大约 3 秒内返回；超时可能丢。接口发出去的内容一般不回调；手机端发出的会。
curl -X POST http://api.geweapi.com/gewe/v2/api/message/postText \ -H "X-GEWE-TOKEN: YOUR_TOKEN" \ -H "Content-Type: application/json" \ -d '{ "appId": "设备ID", "toWxid": "目标会话", "content": "机器人能力连通测试" }'主动推（业务事件驱动）和自动回（回调驱动）可以共用发送接口，幂等键建议拆开。
联系人
通讯录fetchContactsList（好友、已存通讯录的群、公众号等）；搜索 +addContacts加好友或同意申请；备注、标签。标签更新是全量覆盖，只传新标签会删旧的，合并后再提交。
列表没有的群：未存通讯录的，常常要靠群消息回调再补入库。加好友链路是搜索拿v3/v4，再添加；option区分添加、同意、拒绝。
群
createChatroom（至少两个好友 wxid）、inviteMember、removeMember、改群名/群备注（备注往往仅自己可见）。群会话 ID 形态是xxx@chatroom，和私聊 wxid 不是一类。
朋友圈与登录
文字发圈等朋友圈接口；新设备常见有一段时间限制，以文档为准。登录取码、检查状态；appId成功后固定，掉线优先恢复，别动不动新建把业务映射作废。二维码大约 150 秒，过期重取。
建议落地顺序
登录固定 appId → 发一条文本 → 回调能入队 → 关键词自动回 → 再加好友 / 群管理 / AI实名、控频、业务驱动；接口能做，不代表适合做骚扰式营销。多号时 Token 下挂多个appId，回调和发送都要路由对。机器人能力拼的是映射和纪律，不是把文档模块全调一遍。
API 文档：GeWe API - GeWe API｜微信 API 开发文档
