/install feishu-bitable-tasker
飞书任务管理 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.json、team-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。
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install feishu-bitable-tasker - 安装完成后,直接呼叫该 Skill 的名称或使用
/feishu-bitable-tasker触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
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。