← 返回 Skills 市场
kwokkwok

Feishu Bitable Tasker

作者 KwokKwok · GitHub ↗ · v0.1.0 · MIT-0
cross-platform ✓ 安全检测通过
145
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install feishu-bitable-tasker
功能描述
基于飞书知识库多维表格和文档能力的任务管理技能。提供创建任务、创建任务关联文档、修改任务状态等功能,可与外部工具灵活集成。
使用说明 (SKILL.md)

飞书任务管理 Skill

路径约定

所有命令路径均相对于本 skill 目录。 执行命令前必须先 cd 到 skill 所在目录。

确定 skill 目录:从当前工作目录查找 .agents/skills/feishu-bitable-tasker/.claude/skills/feishu-bitable-tasker/,以该目录为基准执行所有命令。

调用流程

1. 检查配置

cd \x3CSKILL_DIR> && ls config/credentials.json config/.configured
  • 两个文件都存在 → 跳到「可用命令」
  • 不存在 → 进入「首次配置」

多应用支持: config/ 下可存放多个凭证文件(如 team-a.jsonteam-b.json)。检查配置时,如果默认的 credentials.json 不存在但有其他凭证文件,列出可用文件让用户选择。所有命令中的 config/credentials.json 均可替换为其他凭证文件路径。

2. 首次配置

注意: 本 skill 纯 Node.js 原生模块实现,无需运行 npm install

用一次 AskUserQuestion 收集以下信息(跳过已有有效值的部分)。每个问题直接要求用户输入数据,不要提供"有/没有"之类的选择项。引导提示放在问题描述中即可:

  • 飞书应用凭证 — 要求输入 App ID 和 App Secret(用空格或逗号分隔)。问题中提示:如果还没有飞书应用,请先到飞书开放平台创建企业自建应用。
  • 知识库多维表格链接 — 要求粘贴知识库中的多维表格 URL,格式 https://xxx.feishu.cn/wiki/\x3Cnode_token>。问题中提示:必须是知识库中的多维表格链接(/wiki/ 格式),不支持独立的多维表格(/base/ 格式)。如果还没有,请先在飞书知识库中创建多维表格。
  • 数据表名称(可选) — 在多维表格中创建的数据表名称。问题中提示:留空则使用多维表格自身的名称作为默认值。
  • 凭证文件名(可选) — 如果用户需要管理多个飞书应用,可指定凭证文件名(如 team-a)。问题中提示:留空则使用默认的 credentials。最终写入 config/\x3C名称>.json

提醒用户:需要在知识库中的多维表格上添加应用("..." → "更多" → "添加文档应用"),并将权限设置为**"可管理"**(默认"可编辑"权限不足)

收集完成后,写入 config/credentials.json(如果用户指定了凭证文件名,则写入 config/\x3C用户指定的名称>.json),然后执行配置:

执行配置

cd \x3CSKILL_DIR> && node scripts/admin.js config-from-links config/credentials.json "\x3C知识库多维表格链接>" ["\x3C数据表名称>"]

成功后自动创建数据表、添加字段、创建任务文档根节点、写入配置。

如果报权限错误(permission denied / RolePermNotAllow),提示用户去多维表格中添加应用权限后重试。

第三步:验证

cd \x3CSKILL_DIR> && echo "n" | node scripts/validate.js config/credentials.json

全部通过即配置完成。

可用命令

以下所有命令均需先 cd \x3CSKILL_DIR>

创建任务

node scripts/task-manager.js config/credentials.json create "\x3C标题>" [type=值] [status=值] [url=值]
  • 所有参数均为可选,调用者按需指定
  • 创建后返回 record_id,可用于后续创建文档

创建文档

node scripts/task-manager.js config/credentials.json create-doc "\x3Crecord_id>"

在知识库中按「{表名}-任务文档 → 年月 → 日期 → 任务名」层级创建文档,自动复用已有的月/日节点。

查看统计

node scripts/task-manager.js config/credentials.json list

验证配置

echo "n" | node scripts/validate.js config/credentials.json

管理命令

# 列出表格字段
node scripts/admin.js list-fields config/credentials.json

# 检查权限
node scripts/admin.js check-permissions config/credentials.json

故障排查

遇到错误时先查阅 FAQ.md,其中记录了实际调试中验证过的解决方案。

快速参考:

错误 原因 解决
认证失败 app_id/app_secret 错误 检查凭证,确认是企业自建应用
permission denied / RolePermNotAllow 应用未添加到多维表格或权限不足 在知识库的多维表格中添加应用,权限设为"可管理"
NOTEXIST (91402) app_token 或 table_id 无效 重新运行 config-from-links
链接格式不正确 提供了独立多维表格链接 必须使用知识库中的多维表格链接(/wiki/ 格式)

更多问题详见 FAQ.md。

安全使用建议
This skill appears to do what it says: it needs a Feishu App ID and App Secret so it can call the official Feishu APIs to create records and wiki/doc nodes. Before installing or using it: 1) Verify the source — registry metadata shows 'Source: unknown'; inspect the included scripts yourself or install only from a trusted repository. 2) Be prepared to grant the Feishu application 'manage' permissions on the specific knowledge-base table as documented — that is necessary for creating child documents but is elevated, so add the app only to the intended table/node. 3) The skill will store App ID/App Secret in config/credentials.json under the skill directory; do not commit that file to version control and restrict filesystem access. 4) The validator will create test records and wiki nodes in your Feishu space during setup — expect test data and remove it manually if desired. 5) If you need higher assurance, review the full scripts (feishu-client.js, task-manager.js, admin.js, validate.js) to confirm there are no network destinations beyond open.feishu.cn / feishu.cn and that logging behavior is acceptable.
功能分析
Type: OpenClaw Skill Name: feishu-bitable-tasker Version: 0.1.0 The skill bundle provides a legitimate integration for managing tasks using Feishu (Lark) Bitable and Wiki. It uses native Node.js modules (https) to interact exclusively with the official Feishu API (open.feishu.cn). While it handles sensitive credentials (App ID/Secret), they are stored locally in a config directory and used only for authenticated requests to Feishu. No evidence of data exfiltration, malicious execution, or prompt injection was found across the scripts (admin.js, feishu-client.js, task-manager.js) or documentation.
能力评估
Purpose & Capability
Name/description claim a Feishu multi-dimensional table (Bitable) + wiki/doc integration. The included scripts implement exactly that (Feishu API client, table/field management, task creation, wiki node creation). No unrelated services, binaries, or credentials are requested.
Instruction Scope
SKILL.md confines actions to the skill directory, instructs to create/read config/*.json, and to run the provided node scripts. The runtime instructions ask the agent to collect App ID/App Secret from the user and write them into config files — this is appropriate for authenticating to Feishu. The instructions do not direct the agent to read unrelated host files or send data to external endpoints besides official Feishu endpoints (open.feishu.cn / feishu.cn).
Install Mechanism
No install spec / downloads are present and the repository is instruction+script only. All code uses Node.js built-ins (https, fs) and there is no external package install or remote archive download. Risk from installation is low; scripts run locally.
Credentials
The skill requires Feishu app credentials (App ID + App Secret) obtained from the user and stored in config/*.json under the skill directory — this is proportional to the stated purpose. Note: credentials are stored on disk in plain JSON and the validator prints a partial token to stdout; protect config files and avoid committing them to VCS.
Persistence & Privilege
always:false and normal autonomous invocation settings. The skill only writes/reads its own config/ files and does not modify other skills or system-wide agent settings.
如何使用
  1. 确保已安装 OpenClaw(本地或 Docker 部署)
  2. 在对话框中输入安装命令:/install feishu-bitable-tasker
  3. 安装完成后,直接呼叫该 Skill 的名称或使用 /feishu-bitable-tasker 触发
  4. 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v0.1.0
Initial release of 飞书多维表格任务管理技能: - 提供基于飞书知识库多维表格的任务管理功能,包括任务创建、文档关联、状态修改等。 - 支持多应用凭证文件,便于管理多个飞书应用。 - 配置流程无需 npm install,仅依赖 Node.js 原生模块。 - 详细的首次配置与使用命令说明,支持表格字段管理与权限检查。 - FAQ 故障排查表覆盖常见错误和解决方案。
元数据
Slug feishu-bitable-tasker
版本 0.1.0
许可证 MIT-0
累计安装 0
当前安装数 0
历史版本数 1
常见问题

Feishu Bitable Tasker 是什么?

基于飞书知识库多维表格和文档能力的任务管理技能。提供创建任务、创建任务关联文档、修改任务状态等功能,可与外部工具灵活集成。 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 145 次。

如何安装 Feishu Bitable Tasker?

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

Feishu Bitable Tasker 是免费的吗?

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

Feishu Bitable Tasker 支持哪些平台?

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

谁开发了 Feishu Bitable Tasker?

由 KwokKwok(@kwokkwok)开发并维护,当前版本 v0.1.0。

💬 留言讨论