OpenClaw

feishu-contacts

Search Feishu contacts by name/pinyin/department. Use when you need to find a person's open_id, email, or department info before sending messages or emails.

guyun940 来源安装数☆ 0 仓库 Starsv1.2.0

查看来源 ↗安装与使用 SKILL.md ↗

安装与使用

请根据来源仓库和你的 AI 工具说明安装此技能。先阅读技能文件和依赖要求，再添加到工作流。

SkillHub CLI

skillhub install guyun94/feishu-contacts

打开来源仓库，查看说明和兼容环境后，按来源提供的命令或步骤安装。

将来源链接提供给你的 Agent，让它先读取说明、核对依赖，并向你说明将执行的安装步骤。

查看来源 ↗使用指南

技能说明

Feishu Contacts Search

飞书通讯录本地缓存搜索。支持中文名、拼音、拼音首字母、英文名模糊匹配。

Setup (first time only)

确保 ~/.openclaw/openclaw.json 中已配置飞书应用凭据：

{
  "channels": {
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx"
    }
  }
}

飞书应用需要以下权限：

contact:user:read — 读取用户信息
contact:user:read_v2 — 读取用户详细信息
contact:department:read — 读取部门信息

安装后首次使用前，执行同步：

python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py sync

Script Location

~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py

Commands

同步通讯录（定期执行，新入职的人需要 sync 才能搜到）

python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py sync

搜索用户

python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py search <人名>

支持：中文名、拼音（zhangsan）、拼音首字母（zs）、英文名、同音字模糊匹配。

搜索部门

python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py search-dept <部门名>

列出部门所有成员

python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py list-dept <dept_id>

获取用户详情（实时 API 调用）

python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py get <open_id>

查看缓存信息

python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py info

CRITICAL: 人员定位规则

任何涉及"给某人做某事"的操作（发消息、发邮件、创建任务等），必须先通过本工具定位到具体的人。

强制流程

IF 目标是人名:
  1. 执行: search <姓名>
  2. 获取: open_id（飞书消息）/ email（邮件，需 get <open_id>）
  3. 结果唯一 → 直接使用
  4. 结果多个 → 列出候选让用户选择
  5. 结果为空 → 报告找不到，让用户提供更多信息

IF 目标是部门:
  1. 执行: search-dept <部门名>
  2. 获取: dept_id
  3. 执行: list-dept <dept_id>
  4. 获取: 所有成员的 open_id

禁止行为

❌ 不准说"找不到这个人"而...

来源信息

Source: github
Repository: openclaw/skills
Path: skills/guyun94/feishu-contacts
Version: 1.2.0
Commit: 5228479d54bb66718c62ed7aaa3286bf520d111f
分类来源: rules
状态: active
可见性: public

这些信息来自收录时的来源分析，可能滞后；使用前请核对最新来源文件。

来源内容

SKILL.md

# Feishu Contacts Search

飞书通讯录本地缓存搜索。支持中文名、拼音、拼音首字母、英文名模糊匹配。

## Setup (first time only)

确保 `~/.openclaw/openclaw.json` 中已配置飞书应用凭据：

```json
{
  "channels": {
    "feishu": {
      "appId": "cli_xxx",
      "appSecret": "xxx"
    }
  }
}
```

飞书应用需要以下权限：
- `contact:user:read` — 读取用户信息
- `contact:user:read_v2` — 读取用户详细信息
- `contact:department:read` — 读取部门信息

安装后首次使用前，执行同步：

```bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py sync
```

## Script Location

`~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py`

## Commands

### 同步通讯录（定期执行，新入职的人需要 sync 才能搜到）

```bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py sync
```

### 搜索用户

```bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py search <人名>
```

支持：中文名、拼音（zhangsan）、拼音首字母（zs）、英文名、同音字模糊匹配。

### 搜索部门

```bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py search-dept <部门名>
```

### 列出部门所有成员

```bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py list-dept <dept_id>
```

### 获取用户详情（实时 API 调用）

```bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py get <open_id>
```

### 查看缓存信息

```bash
python3 ~/.openclaw/skills/feishu-contacts/scripts/feishu-contacts.py info
```

## CRITICAL: 人员定位规则

任何涉及"给某人做某事"的操作（发消息、发邮件、创建任务等），**必须先通过本工具定位到具体的人**。

### 强制流程

```
IF 目标是人名:
  1. 执行: search <姓名>
  2. 获取: open_id（飞书消息）/ email（邮件，需 get <open_id>）
  3. 结果唯一 → 直接使用
  4. 结果多个 → 列出候选让用户选择
  5. 结果为空 → 报告找不到，让用户提供更多信息

IF 目标是部门:
  1. 执行: search-dept <部门名>
  2. 获取: dept_id
  3. 执行: list-dept <dept_id>
  4. 获取: 所有成员的 open_id
```

### 禁止行为

- ❌ 不准说"找不到这个人"而...

搜索