← 返回 Skills 市场
niesongyang

Feishu Cli

作者 niesongyang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ⚠ suspicious
364
总下载
0
收藏
1
当前安装
1
版本数
在 OpenClaw 中安装
/install feishu-cli
功能描述
Full-featured Feishu CLI tool enabling seamless Markdown and document conversions plus management of docs, sheets, messages, calendars, tasks, permissions, a...
使用说明 (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保证格式无损
  • 操作前确认用户已配置好飞书应用凭证
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-cli
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-cli 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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.
元数据
Slug feishu-cli
版本 1.0.0
许可证 MIT-0
累计安装 1
当前安装数 1
历史版本数 1
常见问题

Feishu Cli 是什么?

Full-featured Feishu CLI tool enabling seamless Markdown and document conversions plus management of docs, sheets, messages, calendars, tasks, permissions, a... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 364 次。

如何安装 Feishu Cli?

在 OpenClaw 或 Claude Code 对话框中运行命令「/install feishu-cli」即可一键安装,无需额外配置。

Feishu Cli 是免费的吗?

是的,Feishu Cli 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。

Feishu Cli 支持哪些平台?

Feishu Cli 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。

谁开发了 Feishu Cli?

由 niesongyang(@niesongyang)开发并维护,当前版本 v1.0.0。

💬 留言讨论