⏳ This skill is pending AI review.

Scores will appear once the review pipeline completes.

v1.0.0

feishu-skills-installer

hashstacs-global@hashstacs-global⭐ 1 stars· last commit 7mo ago· 1 open issues

|

Choose how to use this skill

You do not need every option. Choose the path your AI client supports. The stable page stays the same; versioned files are immutable.

1. Native installer

This listing has no registered native installer command. Use the complete package or source fallback below, depending on what your client supports.

Do not guess an installer command or replace an existing version without reviewing the diff.

2. Complete package recommended

Download the ZIP when available. It includes SKILL.md plus the references, security notes and version metadata.

No complete ProSkills package is published for this listing yet.

3. Prompt-only

Copy the prompt above when the agent can read the stable page or when you want to adopt the workflow without installing a skill.

Need only the instruction file?

Download SKILL.md only if your client requires a single file. The complete ZIP is safer for a full installation because it preserves the references and release context.

No path installs or executes anything by itself. Your agent still needs access to the project files. Before updating, compare the installed version and review the diff.

—/10

// RATINGS

⭐GitHub Stars
⭐ 1 on GitHubGitHub ↗

New / niche

🟢ProSkills Score
—
📍

Not yet listed on ClawHub or SkillsMP

// README

中文 | English

feishu-skills

A complete set of Feishu (Lark / 飞书) integration skills for OpenClaw and EnClaws.

Enables AI agents to read/write Feishu documents, send messages, manage calendars, tasks, and multi-dimensional tables — all authenticated with per-user OAuth tokens (not bot-owner tokens).


30-Second Feishu Setup

No more manual app creation. Scan a QR code with Feishu, and your bot is ready.

After installation, just tell your agent:

Help me set up the Feishu plugin

The agent will generate a QR code link → you scan it with the Feishu app → bot credentials are automatically saved to your OpenClaw config. Done.

See feishu-quick-setup for details.


Installation

git clone https://github.com/hashSTACS-Global/feishu-skills.git
cd feishu-skills
node install.js

Skills Included

SkillDescription
feishu-quick-setupOne-click Feishu bot creation via QR code scan. Automatically writes credentials to OpenClaw config.
feishu-authOAuth Device Flow auth hub. Shared by all other skills.
feishu-create-docCreate Feishu Docs with Markdown content
feishu-fetch-docRead Feishu Docs / Wiki pages
feishu-search-docSearch cloud docs, wiki spaces/nodes, and filter drive folder entries by name
feishu-update-docUpdate Feishu Docs (append or overwrite blocks)
feishu-im-readRead Feishu IM chat history
feishu-chatSearch group chats, get chat details, list members
feishu-calendarCreate / query / update calendar events
feishu-taskCreate / query / update tasks and task lists
feishu-bitableFull CRUD on Bitable apps, tables, fields, records, and views
feishu-docx-downloadDownload file attachments from Feishu Wiki and extract text content (docx/pdf/pptx/xlsx/xls/html/rtf/epub/txt/csv, etc.)
feishu-driveFeishu Drive folder operations (currently: list folder items, create folder)
feishu-image-ocrImage OCR via Feishu API. Chinese/English, pure Node.js, zero extra deps.
feishu-search-userSearch users by keyword, get current user profile, or look up a user by user_id / union_id
feishu-sheetRead/write Feishu Spreadsheets (Sheets) — info, read, write, append, find, create, export
feishu-wikiFeishu Wiki space and node management — list/get/create spaces; list/get/create/move/copy nodes

Requirements

  • Node.js ≥ 18 (uses built-in fetch)
  • OpenClaw or EnClaws installed
  • A Feishu app with the following permissions (see Configuration):
    • docs:doc, wiki:wiki:readonly, drive:drive
    • im:message, im:message:readonly
    • calendar:calendar
    • task:task
    • bitable:app

Configuration

OpenClaw

Your ~/.openclaw/openclaw.json must have a channels.feishu section with your app credentials:

{
  "channels": {
    "feishu": {
      "appId": "cli_xxxxxxxxxxxxxxxx",
      "appSecret": "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
    }
  },
  "tools": {
    "deny": [
      "feishu_doc",
      "feishu_create_doc",
      "feishu_fetch_doc",
      "feishu_update_doc",
      "feishu_wiki",
      "feishu_wiki_*",
      "feishu_drive_*",
      "feishu_search_doc_wiki",
      "feishu_chat",
      "feishu_chat_members",
      "feishu_im_*",
      "feishu_bitable_*",
      "feishu_calendar_*",
      "feishu_task_*",
      "feishu_pre_auth"
    ],
    "exec": {
      "security": "full",
      "ask": "off"
    }
  }
}

⚠️ IMPORTANT: tools must be at the top level, NOT inside channels.feishu. OpenClaw's channels.feishu.tools uses a different schema (boolean flags only) — placing deny there will be silently ignored and the built-in plugin tools will remain active, causing the agent to bypass these skills entirely.

Why tools.deny? OpenClaw has built-in Feishu plugin tools (feishu_doc, etc.). These skills replace them with richer, per-user OAuth versions. Denying the built-in tools ensures the agent uses these skills instead.

Why tools.exec? These skills rely on the exec tool to run Node.js scripts. Without "security": "full" and "ask": "off", the exec tool may be restricted or require manual confirmation for each invocation.

EnClaws

Credentials are injected automatically via environment variables (FEISHU_APP_ID, FEISHU_APP_SECRET). No manual configuration needed.


How Authentication Works

These skills use Feishu OAuth Device Flow — each user authorizes once via a link, and their token is stored locally in feishu-auth/.tokens/<open_id>/.

First use flow:

  1. User asks the agent to do something (e.g., create a doc)
  2. Script returns {"error": "auth_required"} with an auth URL
  3. Agent presents an authorization card/link to the user
  4. User clicks and authorizes in Feishu
  5. Agent automatically retries the original operation
  6. Token is saved; future calls are transparent

Token lifecycle:

  • Access tokens auto-refresh via refresh token (no re-auth needed)
  • Tokens are stored per user (open_id) per app (appId)
  • Re-auth only needed if refresh token expires (~30 days of inactivity)

Credential Resolution Order

Scripts resolve app credentials in this order:

  1. Environment variables FEISHU_APP_ID + FEISHU_APP_SECRET ← EnClaws injects these
  2. feishu-auth/config.json ← manual single-app setup
  3. ~/.openclaw/openclaw.json → channels.feishu.appId/appSecret ← OpenClaw standard

Usage Examples

Once installed, just talk to your agent naturally:

Create a Feishu doc titled "Q1 OKR" with the following content...
Read this Feishu doc: https://xxx.feishu.cn/docx/...
Show me my calendar events for today
Create a task: submit the report by 3 PM tomorrow
Add a new record to this Bitable: ...

Project Structure

feishu-skills/
├── feishu-auth/          # Auth hub (shared by all skills)
│   ├── SKILL.md
│   ├── auth.js           # Device Flow initiation + polling
│   └── token-utils.js    # Token read/write/refresh utilities
├── feishu-create-doc/
│   ├── SKILL.md
│   └── create-doc.js
├── feishu-fetch-doc/
│   ├── SKILL.md
│   └── fetch-doc.js
├── feishu-search-doc/
│   ├── SKILL.md
│   └── search-doc.js
├── feishu-update-doc/
│   ├── SKILL.md
│   └── update-doc.js
├── feishu-im-read/
│   ├── SKILL.md
│   └── im-read.js
├── feishu-chat/
│   ├── SKILL.md
│   └── chat.js
├── feishu-calendar/
│   ├── SKILL.md
│   └── calendar.js
├── feishu-task/
│   ├── SKILL.md
│   └── task.js
├── feishu-bitable/
│   ├── SKILL.md
│   └── bitables.js
├── feishu-docx-download/
│   ├── SKILL.md
│   ├── download-doc.js
│   └── extract.js
├── feishu-drive/
│   ├── SKILL.md
│   └── drive.js
├── feishu-image-ocr/
│   ├── SKILL.md
│   └── ocr.js            # Feishu OCR API caller
├── feishu-search-user/
│   ├── SKILL.md
│   └── search-user.js    # Search Feishu users by name
├── feishu-sheet/
│   ├── SKILL.md
│   └── sheet.js          # Spreadsheet read/write/find/create/export
├── feishu-wiki/
│   ├── SKILL.md
│   └── wiki.js           # Wiki space & node management
└── install.js            # Cross-platform installer

Compatibility

EnvironmentStatus
OpenClaw (original)✅ Fully supported
EnClaws✅ Fully supported
macOS✅
Linux✅
Windows✅

// HOW IT'S BUILT

// FILES

2 files shipped with this skill. Inline text is the catalog copy. The upstream link is the source repository.

  • SKILL.md2.4 KBupstream ↗
    ---
    name: feishu-skills-installer
    description: |
      Feishu (Lark) skill pack installer. Downloads and installs all Feishu integration skills
      for OpenClaw / EnClaws — including bot setup, docs, calendar, tasks, bitable, and more.
      Trigger when the user wants to install Feishu skills or says "安装飞书技能", "install feishu", etc.
    ---
    
    # Feishu Skills Installer
    
    > **Module compatibility**: Scripts are provided in both `.js` and `.mjs`. Prefer `.mjs`; if you get a module error, fall back to `.js`.
    
    Install the full Feishu skill pack by executing the commands below. All script output is single-line JSON.
    
    ## Included skills
    
    | Skill | Description |
    |-------|-------------|
    | `feishu-quick-setup` | One-click Feishu bot creation via Device Flow |
    | `feishu-auth` | User-level OAuth authorization |
    | `feishu-create-doc` | Create Feishu documents |
    | `feishu-fetch-doc` | Fetch document content |
    | `feishu-search-doc` | Search documents |
    | `feishu-update-doc` | Update document content |
    | `feishu-im-read` | Read messages from chats |
    | `feishu-chat` | Group/chat management |
    | `feishu-calendar` | Calendar events |
    | `feishu-task` | Task management |
    | `feishu-bitable` | Bitable (multi-dimensional tables) |
    | `feishu-docx-download` | Export documents as files |
    | `feishu-drive` | Drive file management |
    | `feishu-image-ocr` | Image OCR |
    | `feishu-search-user` | Search users |
    | `feishu-sheet` | Spreadsheet operations |
    | `feishu-wiki` | Wiki / knowledge base |
    
    ## Installation steps
    
    After downloading and extracting the skill pack, run the installer script.
    
    ### Run installer
    
    ```bash
    node {extracted_dir}/install.mjs
    ```
    
    If you get an ESM-related error, use the CommonJS version instead:
    
    ```bash
    node {extracted_dir}/install.js
    ```
    
    The installer auto-detects the environment (EnClaws or OpenClaw) and copies skill directories to the correct location.
    
    ## Handling the result
    
    The installer outputs JSON. Check the `success` field:
    
    | Result | Action |
    |--------|--------|
    | `success: true` | Show the `reply` field to the user |
    | `success: false` | Show the `message` field to the user |
    
    ## Notes
    
    - Always run `install.mjs` (or `install.js`) to complete the installation; do not copy skill directories manually.
    - The installer handles environment detection, file placement, and cleanup automatically.
    - This skill only installs files. It does not perform Feishu authorization or permission checks.
    - Execute each step rather than describing it to the user.
    
  • README.mdupstream ↗

    Contents are not inlined in the catalog. Open the upstream file.

Plain-text copy, no login: /skill-bundles/hashstacs-global-feishu-skills.md

// REPO STATS

1 stars
1 open issues
Last commit: 7mo ago