name: wechat-get-contact-detail

description: 根据 wxid 批量获取联系人详情（昵称、头像、地区、签名等）。

wechat-get-contact-detail

根据 wxid 数组批量查询联系人信息。支持批量，一次可以传多个 wxid。

触发场景

知道 wxid 想看昵称/头像
从 wechat-get-contact-list 拿到 wxid 列表后，查昵称做展示
用户问："xxx 是谁？"（先从通讯录里找到对应 wxid 再查详情）

执行步骤

Step 1：从用户输入或上游技能结果里拿到要查的 wxid 列表。

Step 2：构造请求，注意 wxids 必须是 JSON 数组：

API_BASE=$(node -e "console.log(JSON.parse(require('fs').readFileSync(require('path').join(require('os').homedir(),'.openclaw','wechat-credentials.json'),'utf8')).wechatApiBase)")
curl -s --max-time 15 -X POST "$API_BASE/contacts/detail" \
  -H "Content-Type: application/json" \
  -d '{"wxids":["wxid_abc123","wxid_def456"]}'

批量单个：{"wxids":["wxid_abc123"]}

响应字段

{
  "ret": 200,
  "data": [
    {
      "userName": "wxid_abc123",
      "nickName": "张三",
      "alias": "zhangsan",
      "sex": 1,
      "signature": "Stay hungry",
      "province": "Beijing",
      "city": "Beijing",
      "bigHeadImgUrl": "http://..."
    }
  ]
}

userName = wxid（对应请求里的每个元素）
sex: 1=男 2=女
alias: 用户设置的微信号（非 wxid，可能为空）

重要提示

一次最多建议 50 个 wxid，多了拆分批次
群聊 ID (xxx@chatroom) 也能查，返回的是群信息
公众号 (gh_xxx) 能查，返回的是公众号信息