wecomcli-contact

Search WeCom contacts by name, pinyin, or alias to retrieve userids and departments.

287|46|Updated Feb 5, 2026
One-click install
npx skills add https://github.com/YanHaidao/wecom --skill wecomcli-contact-yanhaidao
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: wecomcli-contact
Source: https://github.com/YanHaidao/wecom/tree/main/skills/wecomcli-contact
Command: npx skills add https://github.com/YanHaidao/wecom --skill wecomcli-contact-yanhaidao

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Finding the right person in a large WeCom (Enterprise WeChat) directory is slow when you only know a name, pinyin, or alias, and duplicate names make it hard to identify the correct userid for messaging or API calls. ## Core Features & Use Cases - Fuzzy Contact Search: Search up to 10 keywords at once matching name, pinyin, English name, or alias, returning userid, department, position, and email. - Duplicate Name Disambiguation: Distinguish people sharing the same name via department and position info, with a full-list mode for enumerating all matches. - Use Case: Before sending a WeCom message to "张伟", search the directory to find all matching users, confirm the right one by department, and obtain their userid for the send operation. ## Quick Start Ask the assistant to search the WeCom directory for a colleague by name and return their userid and department.

Frequently Asked Questions about wecomcli-contact

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I search for a person in the WeCom directory by name?

Call the wecom-cli tool with contact users search and pass a JSON argument containing a keywords array. Keywords match name, pinyin, English name, or alias, and results include userid, department, and position.

How to find a WeCom userid when multiple people share the same name?

Search by the shared name and compare the returned department paths and positions to identify the right person. If more than five candidates match, ask to view more or request the full list mode.

Can I search WeCom contacts by pinyin or English name?

Yes, the search matches name, pinyin, English name, and alias fields, not just Chinese names. You can pass up to 10 keywords in one call, combined with OR logic.

Why does the WeCom contact search only show partial results?

When matches exceed display limits, only the top five candidates per keyword are shown and a hint field explains the restriction. Pass search_mode set to list to retrieve the complete set of matches.

What is required before using wecom-cli for contact search?

The wecom-cli tool must be whitelisted in the OpenClaw plugin configuration first. Run the wecomcli-preflight skill checks before the first call, and never invoke wecom-cli through shell or terminal commands.