← Back to Skills Marketplace
hashstacs-hk

feishu-skills

by HashSTACS-HK · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
95
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install feishu-skills
Description
Feishu (Lark) skill pack installer. Downloads and installs all Feishu integration skills for OpenClaw / EnClaws — including bot setup, docs, calendar, tasks,...
README (SKILL.md)

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

node {extracted_dir}/install.mjs

If you get an ESM-related error, use the CommonJS version instead:

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.
Usage Guidance
What to consider before installing: - Review credentials & backups: The code expects FEISHU_APP_ID/FEISHU_APP_SECRET or an OpenClaw config (~/.openclaw/openclaw.json). Back up your OpenClaw config before installing because some scripts (quick-setup) claim to write credentials there. - Inspect code that writes files: The installer will copy skill directories into ~/.openclaw or ~/.enclaws tenant paths and will persist per-user OAuth tokens under the installed feishu-auth/.tokens. If you don't want persistent tokens on the host, avoid installing or run in an isolated environment. - Be cautious about automatic auth flow: Several SKILL.md files instruct the agent to automatically execute auth commands and to not ask the user before sending auth links. Decide whether you trust the agent to perform these actions automatically. - Avoid accidental deletion: The installer removes the source repoDir on exit and deletes non-skill files in in-place mode. Run the installer from a disposable/extracted directory or use node install.js --target <explicit-path> so you control where files are copied and to avoid unintentional deletion of your working directory. - Test in a sandbox: If possible, run the installer in a VM or container first to verify behavior (where it writes files, what it modifies) before installing on a production machine. - Audit sensitive modules: If you plan to use these skills, review feishu-auth/token-utils.* and feishu-quick-setup code to confirm how tokens and credentials are stored/updated and ensure there are no unexpected network endpoints or telemetry. If you want, I can extract and summarise the parts of feishu-auth/token-utils and feishu-quick-setup to show precisely where credentials are read/written and what files they modify.
Capability Analysis
Type: OpenClaw Skill Name: feishu-skills Version: 1.0.0 The skill bundle is a comprehensive and well-architected Feishu (Lark) integration for OpenClaw. It implements secure OAuth Device Flow for per-user authorization, with tokens stored locally using AES-256-GCM encryption (feishu-auth/token-utils.js). A significant security feature is the use of 'DATA_WARNING' prefixes in text extraction and OCR outputs (extract.js, ocr.js) to prevent the AI agent from interpreting document content as system instructions (indirect prompt injection). While the extraction utility dynamically installs npm dependencies via execSync, the package names are hardcoded, and the behavior is consistent with the stated goal of providing a zero-config installation experience. All network communication is directed to official Feishu/Lark domains (feishu.cn, larksuite.com).
Capability Tags
cryptorequires-oauth-token
Capability Assessment
Purpose & Capability
The code and README match the stated purpose: a bundle of Feishu/Lark integration skills plus an installer that copies skill directories into an OpenClaw/EnClaws skills directory. Files shown implement Feishu APIs and per-user OAuth flows as advertised.
Instruction Scope
SKILL.md and sub-SKILL.md files instruct the agent to execute the provided Node installer and many per-skill scripts directly (via exec). Some skill docs explicitly tell the agent to 'do not ask the user' and to automatically run auth/polling commands when auth is required — this grants the agent broad discretion to send auth links and perform operations without asking the user. Several SKILL.md entries also instruct the agent to execute without checking the environment, increasing the chance of unintended side effects.
Install Mechanism
There is no external network download; the installer simply copies included files into the detected target skills directory. That is low-risk in itself. However, after successful install the script attempts to remove the source (repoDir) via a recursive delete on exit. If the installer is run from an important directory or a directory the user expected to keep, this cleanup could delete files unexpectedly. The installer also has an in-place mode that deletes non-skill files (README.md, SKILL.md, etc.) from the source directory.
Credentials
The skill metadata declares no required environment variables or config paths, but the code and README clearly rely on environment variables (FEISHU_APP_ID, FEISHU_APP_SECRET), OpenClaw config (~/.openclaw/openclaw.json), and the ENCLAWS_USER_WORKSPACE env var for detection. Additionally, some included skills (e.g., quick-setup) document writing credentials into the OpenClaw config and storing per-user tokens under feishu-auth/.tokens — these are plausible for the feature set but were not declared in the package metadata and grant persistent access to sensitive credentials.
Persistence & Privilege
The installer writes skill directories into the user's skills area (~/.openclaw or ~/.enclaws/tenants/...), and included scripts will persist OAuth tokens and (per README) may write Feishu app credentials into ~/.openclaw/openclaw.json. The package is not marked always:true, and it does not appear to modify other skills' configurations automatically, but it does instruct the user/agent to change OpenClaw's top-level 'tools' settings to ensure these skills are used instead of built-in tools — which modifies agent behavior beyond simply adding files.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install feishu-skills
  3. After installation, invoke the skill by name or use /feishu-skills
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of Feishu Skills Installer. - Provides a one-command installer to set up all Feishu integration skills for OpenClaw and EnClaws. - Supports bot setup, document management, calendar, tasks, bitable, chat, and more. - Scripts available in both `.mjs` (preferred) and `.js` for compatibility. - Automatic environment detection and file placement; outputs results as single-line JSON. - Installation logic fully automated—no manual copying required.
Metadata
Slug feishu-skills
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is feishu-skills?

Feishu (Lark) skill pack installer. Downloads and installs all Feishu integration skills for OpenClaw / EnClaws — including bot setup, docs, calendar, tasks,... It is an AI Agent Skill for Claude Code / OpenClaw, with 95 downloads so far.

How do I install feishu-skills?

Run "/install feishu-skills" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is feishu-skills free?

Yes, feishu-skills is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does feishu-skills support?

feishu-skills is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created feishu-skills?

It is built and maintained by HashSTACS-HK (@hashstacs-hk); the current version is v1.0.0.

💬 Comments