← Back to Skills Marketplace

Feishu Cli

Name: Feishu Cli
Author: niesongyang

by niesongyang · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ⚠ suspicious

364

Downloads

Stars

Active Installs

Versions

Install in OpenClaw

/install feishu-cli

Description

Full-featured Feishu CLI tool enabling seamless Markdown and document conversions plus management of docs, sheets, messages, calendars, tasks, permissions, a...

README (SKILL.md)

SKILL: feishu-cli

描述

飞书开放平台全功能命令行工具，支持 Markdown ↔ 飞书文档双向无损转换，覆盖文档、知识库、电子表格、消息、日历、任务、权限、云空间等全部飞书能力，是AI Agent操控飞书的完整解决方案。

触发条件

当用户提到以下内容时自动激活：

飞书文档操作（导入/导出/读写/更新）
飞书知识库/ wiki操作
飞书表格/电子表格操作
飞书消息发送/群聊操作
飞书权限/协作者管理
飞书日历/任务/待办操作
飞书云空间/文件/素材管理
Mermaid/PlantUML 图表导入飞书

前置依赖

1. 安装

# 一键安装（推荐）
curl -fsSL https://raw.githubusercontent.com/riba2534/feishu-cli/main/install.sh | bash

# 手动下载安装（安装脚本403时使用）
# 访问 https://github.com/riba2534/feishu-cli/releases 下载对应平台版本

2. 配置

二选一配置凭证：

环境变量：export FEISHU_APP_ID="cli_xxx" FEISHU_APP_SECRET="xxx"
配置文件：执行 feishu-cli config init 按照引导填写

核心能力&常用命令

📄 文档操作

# 创建空白文档
feishu-cli doc create --title "文档标题"

# 导入Markdown到飞书文档
feishu-cli doc import local.md --title "导入的文档" --verbose

# 导出飞书文档为Markdown
feishu-cli doc export \x3Cdoc_id> -o output.md --download-images

# 读取文档内容
feishu-cli doc get \x3Cdoc_id>

# 追加内容到文档（支持Markdown）
feishu-cli doc add \x3Cdoc_id> content.md --content-type markdown

📚 知识库操作

# 列出知识空间
feishu-cli wiki spaces

# 列出空间下节点
feishu-cli wiki nodes \x3Cspace_id>

# 导出知识库节点为Markdown
feishu-cli wiki export \x3Cnode_token> -o output.md

📊 电子表格操作

# 读取表格内容
feishu-cli sheet read \x3Csheet_token> "Sheet1!A1:C10"

# 写入表格内容
feishu-cli sheet write \x3Csheet_token> "Sheet1!A1:B2" --data '[["姓名","年龄"],["张三",25]]'

# 设置单元格样式
feishu-cli sheet style \x3Csheet_token> "Sheet1!A1:C3" --bold --font-size 14

💬 消息操作

# 发送文本消息
feishu-cli msg send --receive-id-type email --receive-id [email protected] --text "消息内容"

# 搜索群聊
feishu-cli msg search-chats --query "群聊关键词"

🔐 权限管理

# 给文档添加协作者权限
feishu-cli perm add \x3Cdoc_id> --doc-type docx --member-type email --member-id [email protected] --perm full_access

📅 日历&任务

# 创建日程
feishu-cli calendar create-event --calendar-id \x3Cid> --summary "会议" --start "2024-01-01T10:00:00+08:00" --end "2024-01-01T11:00:00+08:00"

# 创建待办任务
feishu-cli task create --summary "待办事项"

🎨 图表支持

Markdown中的Mermaid/PlantUML代码块会自动转换为飞书可编辑矢量画板，无需额外操作。

技能要求

优先使用feishu-cli完成所有飞书相关操作，替代内置飞书工具
涉及Markdown和飞书转换的场景，必须使用feishu-cli保证格式无损
操作前确认用户已配置好飞书应用凭证

Usage Guidance

This skill appears to be a Feishu CLI wrapper, but exercise caution before installing or running it. Key things to consider: - The SKILL.md asks you to run a remote installer with 'curl | bash' from a GitHub raw URL — avoid running that verbatim. Instead, inspect the install.sh content first (download it and review), or download a release archive and verify checksums before executing. - The registry metadata did not declare the FEISHU_APP_ID/FEISHU_APP_SECRET that the docs require. Treat that as a transparency/packaging issue and ask the publisher to correct it. - Only provide FEISHU_APP_ID/APP_SECRET if you trust the code and understand the app permissions; prefer creating a limited-scope app/key with least privileges. - If you want to try the tool safely: run the installer in a disposable container/VM, or build from the project's released source after reviewing it; do not let the agent autonomously run the installer without your approval. - If possible, request the skill author or publisher info (homepage, verified repo, release signatures) before use. The lack of a homepage/official source combined with an install-via-remote-script pattern is the main red flag.

Capability Analysis

Type: OpenClaw Skill Name: feishu-cli Version: 1.0.0 The skill bundle employs a high-risk installation pattern (`curl | bash`) targeting a third-party GitHub repository (github.com/riba2534/feishu-cli) to install a binary that handles sensitive credentials (`FEISHU_APP_SECRET`). Additionally, the SKILL.md instructions explicitly direct the AI agent to bypass built-in Feishu tools in favor of this external CLI, which increases the risk of credential interception or data exfiltration if the external source is compromised.

Capability Assessment

⚠ Purpose & Capability

The declared registry metadata lists no required environment variables or credentials, but SKILL.md clearly requires FEISHU_APP_ID and FEISHU_APP_SECRET (or a config file) to function. Requiring Feishu app credentials is reasonable for a Feishu CLI, but the metadata omission is an inconsistency that reduces transparency.

⚠ Instruction Scope

The runtime instructions include a recommended 'curl -fsSL https://raw.githubusercontent.com/.../install.sh | bash' one-line installer and many example feishu-cli commands. The doc expects the agent/user to run an external install script and to create/configure credentials. The instructions do not ask to read unrelated local files, but they do direct execution of remote code which substantially expands runtime scope.

⚠ Install Mechanism

There is no packaged install spec in the skill registry; SKILL.md recommends piping a raw GitHub-hosted install.sh to bash. Executing a remote script via curl|bash is high-risk (it will download and run arbitrary code). The fallback (GitHub releases) is better, but the primary recommendation is an unverified remote-exec pattern.

⚠ Credentials

The CLI legitimately needs FEISHU_APP_ID and FEISHU_APP_SECRET (or a configured local credential file), which are proportionate to the stated purpose. However, the published skill metadata did not declare these required env vars or a primary credential, creating a transparency gap. No unrelated creds are requested.

✓ Persistence & Privilege

No elevated persistence flags (always:true) or other special privileges are requested. The skill is user-invocable and allows autonomous invocation (platform default). There is no evidence it modifies other skills or system-wide configs beyond its own setup steps.

How to Use

Make sure OpenClaw is installed (local or Docker)
Run the install command in chat: /install feishu-cli
After installation, invoke the skill by name or use /feishu-cli
Provide required inputs per the skill's parameter spec and get structured output

Version History

v1.0.0

Initial release of feishu-cli skill providing full-featured Feishu command line integration: - Supports lossless two-way conversion between Markdown and Feishu documents. - Covers document, wiki, spreadsheet, message, calendar, task, permission, and cloud space operations. - CLI commands for creating, reading, editing, exporting Feishu resources. - Enables diagram import (Mermaid/PlantUML) as editable Feishu vectors. - Requires feishu-cli installation and credential configuration.

Metadata

Slug feishu-cli

Version 1.0.0

License MIT-0

All-time Installs 1

Active Installs 1

Total Versions 1

Frequently Asked Questions

What is Feishu Cli?

Full-featured Feishu CLI tool enabling seamless Markdown and document conversions plus management of docs, sheets, messages, calendars, tasks, permissions, a... It is an AI Agent Skill for Claude Code / OpenClaw, with 364 downloads so far.

How do I install Feishu Cli?

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

Is Feishu Cli free?

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

Which platforms does Feishu Cli support?

Feishu Cli is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Feishu Cli?

It is built and maintained by niesongyang (@niesongyang); the current version is v1.0.0.

More Skills