← Back to Skills Marketplace
29
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install lark-contact
Description
飞书 / Lark 通讯录,用于按姓名 / 邮箱把员工解析成 open_id,以及按 open_id 反查员工的姓名 / 部门 / 邮箱 / 联系方式。当用户说出某人姓名而下一步需要发消息 / 加群 / 排日程时,先用本 skill 把姓名换成 ID;当输出里出现 open_id 需要展示成姓名给用户看,或用户直...
README (SKILL.md)
lark-contact
选哪个命令
统一以 user 身份运行,按下表选命令:
| 想做什么 | 命令 |
|---|---|
| 按姓名 / 邮箱搜员工拿 open_id | +search-user |
| 已知 open_id 取他人资料 | +search-user --user-ids \x3Cid> |
| 查看自己 | +get-user 或 +search-user --user-ids me |
已知 open_id 只是想发消息 / 排日程,不必经过 contact —— 直接 lark-im / lark-calendar。
典型场景
# 找张三给他发消息:先搜,确认 open_id,再发
lark-cli contact +search-user --query "张三" --has-chatted --as user
lark-cli im +messages-send --user-id ou_xxx --text "Hi!"
搜索命中多条且后续操作有副作用(发消息、邀请会议等),把候选列给用户挑;不要擅自选第一条。
注意事项
- 41050 / Permission denied 受当前身份的可见范围限制(两条命令都可能遇到)。让管理员调整可见范围,或根据错误响应中的
console_url引导用户解决。 - 跨租户用户(
is_cross_tenant=true)多数业务字段为空字符串,这是飞书可见性规则,下游做空值兜底。 - ID 类型:默认
open_id。+get-user可改--user-id-type union_id|user_id;+search-user只接受open_id。
不在本 skill 范围
- 发消息 / 查聊天记录 →
lark-im - 排日程 / 邀请会议 →
lark-calendar - 部门树 / 按部门列员工 / 组织架构 ,通过
lark-openapi-explorer查找原生接口
Usage Guidance
Install this only in environments where lark-cli is already configured for the intended Lark tenant and users are allowed to look up colleague contact details. Treat returned names, emails, departments, and chat IDs as workplace directory data, and confirm ambiguous matches before using an ID to send messages, invite people, or schedule meetings.
Capability Assessment
Purpose & Capability
The stated purpose is to resolve Lark names, emails, and open_id values and to fetch visible profile fields; the artifacts only document contact lookup commands aligned with that purpose.
Instruction Scope
Instructions are scoped to user-initiated lookups, include limits such as not handling department traversal, and tell agents to ask the user before choosing among ambiguous people for side-effecting follow-up actions.
Install Mechanism
The package contains markdown guidance only and declares a dependency on an existing lark-cli binary; there are no executable scripts, install hooks, or bundled binaries.
Credentials
The skill uses Lark contact permissions and may expose coworker profile data visible to the current user, which is expected for a contact lookup skill and bounded by Lark visibility and the contact:user:search scope.
Persistence & Privilege
No persistence, credential capture, privilege escalation, background workers, or local indexing behavior is described or present in the artifacts.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install lark-contact - After installation, invoke the skill by name or use
/lark-contact - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release of lark-contact:
- Provides lookup between Lark/Lark 飞书 user names, emails, and open_id.
- Supports retrieving user information (name, department, email, contact) by open_id.
- Enables name/email to open_id lookup for message sending, group adding, or scheduling scenarios.
- Does not support department tree traversal or listing users by department—use native OpenAPI for these.
- Includes CLI guidance and typical usage examples.
- Explains permission and visibility considerations, and outlines boundaries with related skills.
Metadata
Frequently Asked Questions
What is lark-contact?
飞书 / Lark 通讯录,用于按姓名 / 邮箱把员工解析成 open_id,以及按 open_id 反查员工的姓名 / 部门 / 邮箱 / 联系方式。当用户说出某人姓名而下一步需要发消息 / 加群 / 排日程时,先用本 skill 把姓名换成 ID;当输出里出现 open_id 需要展示成姓名给用户看,或用户直... It is an AI Agent Skill for Claude Code / OpenClaw, with 29 downloads so far.
How do I install lark-contact?
Run "/install lark-contact" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is lark-contact free?
Yes, lark-contact is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does lark-contact support?
lark-contact is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created lark-contact?
It is built and maintained by Qing WETH (@gu2003li); the current version is v1.0.0.
More Skills