@m1heng-clawd/feishu 0.1.9 → 0.1.10

package/README.md

@@ -3,6 +3,8 @@
 Feishu/Lark (飞书) channel plugin for [OpenClaw](https://github.com/openclaw/openclaw).
 
 > **中文社区资料** - 配置教程、常见问题、使用技巧：[Wiki](https://github.com/m1heng/clawdbot-feishu/wiki)
+>
+> **Contributing / 贡献指南**: [CONTRIBUTING.md](./CONTRIBUTING.md)
 
 [English](#english) | [中文](#中文)
 
@@ -16,6 +18,19 @@ Feishu/Lark (飞书) channel plugin for [OpenClaw](https://github.com/openclaw/o
 openclaw plugins install @m1heng-clawd/feishu
 ```
 
+> [!IMPORTANT]
+> **Windows Troubleshooting (`spawn npm ENOENT`)**
+>
+> If `openclaw plugins install` fails, install manually:
+>
+> ```bash
+> # 1. Download the package
+> curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
+>
+> # 2. Install from local file
+> openclaw plugins install ./feishu-0.1.3.tgz
+> ```
+
 ### Upgrade
 
 ```bash
@@ -61,6 +76,7 @@ openclaw plugins update feishu
 | `drive:drive:readonly` | `feishu_drive` | List folders, get file info |
 | `wiki:wiki:readonly` | `feishu_wiki` | List spaces, list nodes, get node info, search |
 | `bitable:app:readonly` | `feishu_bitable` | Read bitable records and fields |
+| `task:task:read` | `feishu_task_get` | Get task details |
 
 **Read-write** (optional, for create/edit/delete operations):
 
@@ -70,7 +86,10 @@ openclaw plugins update feishu
 | `docx:document.block:convert` | `feishu_doc` | Markdown to blocks conversion (required for write/append) |
 | `drive:drive` | `feishu_doc`, `feishu_drive` | Upload images to documents, create folders, move/delete files |
 | `wiki:wiki` | `feishu_wiki` | Create/move/rename wiki nodes |
-| `bitable:app` | `feishu_bitable` | Create/update bitable records |
+| `bitable:app` | `feishu_bitable` | Create/update/delete bitable records and manage fields |
+| `task:task:write` | `feishu_task_create`, `feishu_task_update`, `feishu_task_delete` | Create/update/delete tasks |
+
+> Task scope names may vary slightly in Feishu console UI. If needed, search for Task-related permissions and grant read/write accordingly.
 
 #### Drive Access ⚠️
 
@@ -260,7 +279,8 @@ session:
 - **Document tools**: Read, create, and write Feishu documents with markdown (tables not supported due to API limitations)
 - **Wiki tools**: Navigate knowledge bases, list spaces, get node details, search, create/move/rename nodes
 - **Drive tools**: List folders, get file info, create folders, move/delete files
-- **Bitable tools**: Read/write bitable (多维表格) records, supports both `/base/` and `/wiki/` URLs
+- **Bitable tools**: Manage bitable (多维表格) fields and records (read/create/update/delete), supports both `/base/` and `/wiki/` URLs
+- **Task tools**: Create, get details, update, and delete tasks via Feishu Task v2 API
 - **@mention forwarding**: When you @mention someone in your message, the bot's reply will automatically @mention them too
 - **Permission error notification**: When the bot encounters a Feishu API permission error, it automatically notifies the user with the permission grant URL
 - **Dynamic agent creation**: Each DM user can have their own isolated agent instance with dedicated workspace (optional)
@@ -299,18 +319,6 @@ Send `/new` command in the chat.
 
 Feishu API has rate limits. Streaming updates can easily trigger throttling. We use complete-then-send approach for stability.
 
-#### Windows install error `spawn npm ENOENT`
-
-If `openclaw plugins install` fails, install manually:
-
-```bash
-# 1. Download the package
-curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
-
-# 2. Install from local file
-openclaw plugins install ./feishu-0.1.3.tgz
-```
-
 #### Cannot find the bot in Feishu
 
 1. Ensure the app is published (at least to test version)
@@ -327,6 +335,19 @@ openclaw plugins install ./feishu-0.1.3.tgz
 openclaw plugins install @m1heng-clawd/feishu
 ```
 
+> [!IMPORTANT]
+> **Windows 排错（`spawn npm ENOENT`）**
+>
+> 如果 `openclaw plugins install` 失败，可以手动安装：
+>
+> ```bash
+> # 1. 下载插件包
+> curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
+>
+> # 2. 从本地安装
+> openclaw plugins install ./feishu-0.1.3.tgz
+> ```
+
 ### 升级
 
 ```bash
@@ -372,6 +393,7 @@ openclaw plugins update feishu
 | `drive:drive:readonly` | `feishu_drive` | 列出文件夹、获取文件信息 |
 | `wiki:wiki:readonly` | `feishu_wiki` | 列出空间、列出节点、获取节点详情、搜索 |
 | `bitable:app:readonly` | `feishu_bitable` | 读取多维表格记录和字段 |
+| `task:task:read` | `feishu_task_get` | 获取任务详情 |
 
 **读写权限**（可选，用于创建/编辑/删除操作）：
 
@@ -381,7 +403,10 @@ openclaw plugins update feishu
 | `docx:document.block:convert` | `feishu_doc` | Markdown 转 blocks（write/append 必需） |
 | `drive:drive` | `feishu_doc`, `feishu_drive` | 上传图片到文档、创建文件夹、移动/删除文件 |
 | `wiki:wiki` | `feishu_wiki` | 创建/移动/重命名知识库节点 |
-| `bitable:app` | `feishu_bitable` | 创建/更新多维表格记录 |
+| `bitable:app` | `feishu_bitable` | 创建/更新/删除多维表格记录并管理字段 |
+| `task:task:write` | `feishu_task_create`, `feishu_task_update`, `feishu_task_delete` | 创建/更新/删除任务 |
+
+> 飞书控制台中任务权限的显示名称可能略有差异，必要时可按关键字 `task` 搜索并授予对应读写权限。
 
 #### 云空间访问权限 ⚠️
 
@@ -571,7 +596,8 @@ session:
 - **文档工具**：读取、创建、用 Markdown 写入飞书文档（表格因 API 限制不支持）
 - **知识库工具**：浏览知识库、列出空间、获取节点详情、搜索、创建/移动/重命名节点
 - **云空间工具**：列出文件夹、获取文件信息、创建文件夹、移动/删除文件
-- **多维表格工具**：读写多维表格记录，支持 `/base/` 和 `/wiki/` 两种链接格式
+- **多维表格工具**：支持多维表格字段与记录的读取/创建/更新/删除，支持 `/base/` 和 `/wiki/` 两种链接格式
+- **任务工具**：基于 Task v2 API 支持任务创建、获取详情、更新和删除
 - **@ 转发功能**：在消息中 @ 某人，机器人的回复会自动 @ 该用户
 - **权限错误提示**：当机器人遇到飞书 API 权限错误时，会自动通知用户并提供权限授权链接
 - **动态 Agent 创建**：每个私聊用户可拥有独立的 agent 实例和专属 workspace（可选）
@@ -610,18 +636,6 @@ session:
 
 飞书 API 有请求频率限制，流式更新消息很容易触发限流。当前采用完整回复后一次性发送的方式，以保证稳定性。
 
-#### Windows 安装报错 `spawn npm ENOENT`
-
-如果 `openclaw plugins install` 失败，可以手动安装：
-
-```bash
-# 1. 下载插件包
-curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz
-
-# 2. 从本地安装
-openclaw plugins install ./feishu-0.1.3.tgz
-```
-
 #### 在飞书里找不到机器人
 
 1. 确保应用已发布（至少发布到测试版本）

package/index.ts

@@ -7,6 +7,7 @@ import { registerFeishuWikiTools } from "./src/wiki.js";
 import { registerFeishuDriveTools } from "./src/drive.js";
 import { registerFeishuPermTools } from "./src/perm.js";
 import { registerFeishuBitableTools } from "./src/bitable.js";
+import { registerFeishuTaskTools } from "./src/task.js";
 
 export { monitorFeishuProvider } from "./src/monitor.js";
 export {
@@ -23,7 +24,7 @@ export {
   sendFileFeishu,
   sendMediaFeishu,
 } from "./src/media.js";
-export { probeFeishu } from "./src/probe.js";
+export { probeFeishu, clearProbeCache } from "./src/probe.js";
 export {
   addReactionFeishu,
   removeReactionFeishu,
@@ -57,6 +58,7 @@ const plugin = {
     registerFeishuDriveTools(api);
     registerFeishuPermTools(api);
     registerFeishuBitableTools(api);
+    registerFeishuTaskTools(api);
   },
 };
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@m1heng-clawd/feishu",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "type": "module",
   "description": "OpenClaw Feishu/Lark channel plugin",
   "license": "MIT",
@@ -46,17 +46,17 @@
     }
   },
   "dependencies": {
-    "@larksuiteoapi/node-sdk": "^1.58.0",
+    "@larksuiteoapi/node-sdk": "^1.59.0",
     "@sinclair/typebox": "0.34.48",
     "zod": "^4.3.6"
   },
   "devDependencies": {
     "@types/node": "^25.0.10",
-    "openclaw": "2026.1.29",
+    "openclaw": "2026.2.13",
     "tsx": "^4.21.0",
     "typescript": "^5.7.0"
   },
   "peerDependencies": {
-    "openclaw": ">=2026.1.29"
+    "openclaw": ">=2026.2.13"
   }
 }

package/src/bitable-tools/actions.ts

@@ -0,0 +1,199 @@
+import type {
+  BitableClient,
+  BitableFieldCreateData,
+  BitableFieldUpdateData,
+} from "./common.js";
+import { formatField, runBitableApiCall } from "./common.js";
+
+// -------- Field operations --------
+
+export async function listFields(client: BitableClient, appToken: string, tableId: string) {
+  const res = await runBitableApiCall("bitable.appTableField.list", () =>
+    client.bitable.appTableField.list({
+      path: { app_token: appToken, table_id: tableId },
+    }),
+  );
+
+  const fields = res.data?.items ?? [];
+  return {
+    fields: fields.map((f) => formatField(f)),
+    total: fields.length,
+  };
+}
+
+export async function createField(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  field: BitableFieldCreateData,
+) {
+  const res = await runBitableApiCall("bitable.appTableField.create", () =>
+    client.bitable.appTableField.create({
+      path: { app_token: appToken, table_id: tableId },
+      data: field,
+    }),
+  );
+
+  return {
+    field: res.data?.field ? formatField(res.data.field) : undefined,
+  };
+}
+
+export async function updateField(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  fieldId: string,
+  field: BitableFieldUpdateData,
+) {
+  const res = await runBitableApiCall("bitable.appTableField.update", () =>
+    client.bitable.appTableField.update({
+      path: { app_token: appToken, table_id: tableId, field_id: fieldId },
+      data: field,
+    }),
+  );
+
+  return {
+    field: res.data?.field ? formatField(res.data.field) : undefined,
+  };
+}
+
+export async function deleteField(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  fieldId: string,
+) {
+  const res = await runBitableApiCall("bitable.appTableField.delete", () =>
+    client.bitable.appTableField.delete({
+      path: { app_token: appToken, table_id: tableId, field_id: fieldId },
+    }),
+  );
+
+  return {
+    success: res.data?.deleted ?? true,
+    field_id: res.data?.field_id ?? fieldId,
+    deleted: res.data?.deleted ?? true,
+  };
+}
+
+// -------- Record operations --------
+
+export async function listRecords(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  pageSize?: number,
+  pageToken?: string,
+) {
+  const res = await runBitableApiCall("bitable.appTableRecord.list", () =>
+    client.bitable.appTableRecord.list({
+      path: { app_token: appToken, table_id: tableId },
+      params: {
+        page_size: pageSize ?? 100,
+        ...(pageToken && { page_token: pageToken }),
+      },
+    }),
+  );
+
+  return {
+    records: res.data?.items ?? [],
+    has_more: res.data?.has_more ?? false,
+    page_token: res.data?.page_token,
+    total: res.data?.total,
+  };
+}
+
+export async function getRecord(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  recordId: string,
+) {
+  const res = await runBitableApiCall("bitable.appTableRecord.get", () =>
+    client.bitable.appTableRecord.get({
+      path: { app_token: appToken, table_id: tableId, record_id: recordId },
+    }),
+  );
+
+  return {
+    record: res.data?.record,
+  };
+}
+
+export async function createRecord(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  fields: Record<string, unknown>,
+) {
+  const res = await runBitableApiCall("bitable.appTableRecord.create", () =>
+    client.bitable.appTableRecord.create({
+      path: { app_token: appToken, table_id: tableId },
+      data: { fields },
+    }),
+  );
+
+  return {
+    record: res.data?.record,
+  };
+}
+
+export async function updateRecord(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  recordId: string,
+  fields: Record<string, unknown>,
+) {
+  const res = await runBitableApiCall("bitable.appTableRecord.update", () =>
+    client.bitable.appTableRecord.update({
+      path: { app_token: appToken, table_id: tableId, record_id: recordId },
+      data: { fields },
+    }),
+  );
+
+  return {
+    record: res.data?.record,
+  };
+}
+
+export async function deleteRecord(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  recordId: string,
+) {
+  const res = await runBitableApiCall("bitable.appTableRecord.delete", () =>
+    client.bitable.appTableRecord.delete({
+      path: { app_token: appToken, table_id: tableId, record_id: recordId },
+    }),
+  );
+
+  return {
+    success: res.data?.deleted ?? true,
+    record_id: res.data?.record_id ?? recordId,
+    deleted: res.data?.deleted ?? true,
+  };
+}
+
+export async function batchDeleteRecords(
+  client: BitableClient,
+  appToken: string,
+  tableId: string,
+  recordIds: string[],
+) {
+  const res = await runBitableApiCall("bitable.appTableRecord.batchDelete", () =>
+    client.bitable.appTableRecord.batchDelete({
+      path: { app_token: appToken, table_id: tableId },
+      data: { records: recordIds },
+    }),
+  );
+
+  const results = res.data?.records ?? [];
+  return {
+    results,
+    requested: recordIds.length,
+    deleted: results.filter((r) => r.deleted).length,
+  };
+}

package/src/bitable-tools/common.ts

@@ -0,0 +1,90 @@
+import { createFeishuClient } from "../client.js";
+import {
+  errorResult,
+  json,
+  runFeishuApiCall,
+  type FeishuApiResponse,
+} from "../tools-common/feishu-api.js";
+
+export type BitableClient = ReturnType<typeof createFeishuClient>;
+
+// SDK-derived payload types keep tool input strongly typed and aligned with upstream API changes.
+type AppTableFieldCreatePayload = NonNullable<
+  Parameters<BitableClient["bitable"]["appTableField"]["create"]>[0]
+>;
+type AppTableFieldUpdatePayload = NonNullable<
+  Parameters<BitableClient["bitable"]["appTableField"]["update"]>[0]
+>;
+
+export type BitableFieldCreateData = AppTableFieldCreatePayload["data"];
+export type BitableFieldUpdateData = AppTableFieldUpdatePayload["data"];
+export type BitableFieldDescription = NonNullable<BitableFieldCreateData["description"]>;
+
+export { json, errorResult };
+
+const RETRYABLE_BITABLE_ERROR_CODES = new Set<number>([
+  1254607, // Data not ready
+  1255040, // Request timeout
+  1254290, // Too many requests
+  1254291, // Write conflict
+]);
+
+const RETRY_BACKOFF_MS = [350, 900, 1800];
+
+export async function runBitableApiCall<T extends FeishuApiResponse>(
+  context: string,
+  fn: () => Promise<T>,
+): Promise<T> {
+  // Bitable APIs can briefly return "Data not ready" after writes.
+  // Retry only known transient codes with short backoff.
+  return runFeishuApiCall(context, fn, {
+    retryableCodes: RETRYABLE_BITABLE_ERROR_CODES,
+    backoffMs: RETRY_BACKOFF_MS,
+  });
+}
+
+const FIELD_TYPE_NAMES: Record<number, string> = {
+  1: "Text",
+  2: "Number",
+  3: "SingleSelect",
+  4: "MultiSelect",
+  5: "DateTime",
+  7: "Checkbox",
+  11: "User",
+  13: "Phone",
+  15: "URL",
+  17: "Attachment",
+  18: "SingleLink",
+  19: "Lookup",
+  20: "Formula",
+  21: "DuplexLink",
+  22: "Location",
+  23: "GroupChat",
+  1001: "CreatedTime",
+  1002: "ModifiedTime",
+  1003: "CreatedUser",
+  1004: "ModifiedUser",
+  1005: "AutoNumber",
+};
+
+export function formatField(field: {
+  field_id?: string;
+  field_name?: string;
+  type?: number;
+  is_primary?: boolean;
+  property?: unknown;
+  ui_type?: string;
+  is_hidden?: boolean;
+}) {
+  const typeName = field.type != null ? FIELD_TYPE_NAMES[field.type] || `type_${field.type}` : undefined;
+  return {
+    field_id: field.field_id,
+    field_name: field.field_name,
+    type: field.type,
+    ...(typeName && { type_name: typeName }),
+    is_primary: field.is_primary,
+    ui_type: field.ui_type,
+    is_hidden: field.is_hidden,
+    ...(field.property && { property: field.property }),
+  };
+}

package/src/bitable-tools/meta.ts

@@ -0,0 +1,80 @@
+import { runBitableApiCall, type BitableClient } from "./common.js";
+
+// Accept both native bitable URLs and wiki-embedded bitable URLs.
+function parseBitableUrl(url: string): { token: string; tableId?: string; isWiki: boolean } | null {
+  try {
+    const u = new URL(url);
+    const tableId = u.searchParams.get("table") ?? undefined;
+
+    const wikiMatch = u.pathname.match(/\/wiki\/([A-Za-z0-9]+)/);
+    if (wikiMatch) {
+      return { token: wikiMatch[1], tableId, isWiki: true };
+    }
+
+    const baseMatch = u.pathname.match(/\/base\/([A-Za-z0-9]+)/);
+    if (baseMatch) {
+      return { token: baseMatch[1], tableId, isWiki: false };
+    }
+
+    return null;
+  } catch {
+    return null;
+  }
+}
+
+async function getAppTokenFromWiki(client: BitableClient, nodeToken: string): Promise<string> {
+  // Wiki links expose a wiki node token; bitable APIs require app_token.
+  const res = await runBitableApiCall("wiki.space.getNode", () =>
+    client.wiki.space.getNode({
+      params: { token: nodeToken },
+    }),
+  );
+
+  const node = res.data?.node;
+  if (!node) throw new Error("Node not found");
+  if (node.obj_type !== "bitable") {
+    throw new Error(`Node is not a bitable (type: ${node.obj_type})`);
+  }
+
+  return node.obj_token!;
+}
+
+export async function getBitableMeta(client: BitableClient, url: string) {
+  const parsed = parseBitableUrl(url);
+  if (!parsed) {
+    throw new Error("Invalid URL format. Expected /base/XXX or /wiki/XXX URL");
+  }
+
+  const appToken = parsed.isWiki ? await getAppTokenFromWiki(client, parsed.token) : parsed.token;
+
+  const res = await runBitableApiCall("bitable.app.get", () =>
+    client.bitable.app.get({
+      path: { app_token: appToken },
+    }),
+  );
+
+  let tables: { table_id: string; name: string }[] = [];
+  if (!parsed.tableId) {
+    // If table is not specified in URL, return available tables to guide the next call.
+    const tablesRes = await runBitableApiCall("bitable.appTable.list", () =>
+      client.bitable.appTable.list({
+        path: { app_token: appToken },
+      }),
+    );
+    tables = (tablesRes.data?.items ?? []).map((t) => ({
+      table_id: t.table_id!,
+      name: t.name!,
+    }));
+  }
+
+  return {
+    app_token: appToken,
+    table_id: parsed.tableId,
+    name: res.data?.app?.name,
+    url_type: parsed.isWiki ? "wiki" : "base",
+    ...(tables.length > 0 && { tables }),
+    hint: parsed.tableId
+      ? `Use app_token="${appToken}" and table_id="${parsed.tableId}" for other bitable tools`
+      : `Use app_token="${appToken}" for other bitable tools. Select a table_id from the tables list.`,
+  };
+}