@larksuite/openclaw-lark 2025.7.15-beta.0

package/src/tools/oapi/bitable/app-table.js

@@ -0,0 +1,195 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_bitable_app_table tool -- Manage Feishu Bitable tables.
+ *
+ * P0 Actions: create, list, patch
+ * P1 Actions: batch_create
+ *
+ * Uses the Feishu Bitable v1 API:
+ *   - create: POST /open-apis/bitable/v1/apps/:app_token/tables
+ *   - list:   GET  /open-apis/bitable/v1/apps/:app_token/tables
+ *   - patch:  PATCH /open-apis/bitable/v1/apps/:app_token/tables/:table_id
+ *   - batch_create: POST /open-apis/bitable/v1/apps/:app_token/tables/batch_create
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuBitableAppTableTool = registerFeishuBitableAppTableTool;
+const typebox_1 = require("@sinclair/typebox");
+const helpers_1 = require("../helpers.js");
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuBitableAppTableSchema = typebox_1.Type.Union([
+    // CREATE (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('create'),
+        app_token: typebox_1.Type.String({ description: '多维表格 token' }),
+        table: typebox_1.Type.Object({
+            name: typebox_1.Type.String({ description: '数据表名称' }),
+            default_view_name: typebox_1.Type.Optional(typebox_1.Type.String({ description: '默认视图名称' })),
+            fields: typebox_1.Type.Optional(typebox_1.Type.Array(typebox_1.Type.Object({
+                field_name: typebox_1.Type.String({ description: '字段名称' }),
+                type: typebox_1.Type.Number({
+                    description: '字段类型（1=文本，2=数字，3=单选，4=多选，5=日期，7=复选框，11=人员，13=电话，15=超链接，17=附件，1001=创建时间，1002=修改时间等）',
+                }),
+                property: typebox_1.Type.Optional(typebox_1.Type.Any({ description: '字段属性配置（根据类型而定）' })),
+            }), { description: '字段列表（可选，但强烈建议在创建表时就传入所有字段，避免后续逐个添加）。不传则创建空表。' })),
+        }),
+    }),
+    // LIST (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('list'),
+        app_token: typebox_1.Type.String({ description: '多维表格 token' }),
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Number({ description: '每页数量，默认 50，最大 100' })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({ description: '分页标记' })),
+    }),
+    // PATCH (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('patch'),
+        app_token: typebox_1.Type.String({ description: '多维表格 token' }),
+        table_id: typebox_1.Type.String({ description: '数据表 ID' }),
+        name: typebox_1.Type.Optional(typebox_1.Type.String({ description: '新的表名' })),
+    }),
+    // BATCH_CREATE (P1)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('batch_create'),
+        app_token: typebox_1.Type.String({ description: '多维表格 token' }),
+        tables: typebox_1.Type.Array(typebox_1.Type.Object({
+            name: typebox_1.Type.String({ description: '数据表名称' }),
+        }), { description: '要批量创建的数据表列表' }),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function registerFeishuBitableAppTableTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = (0, helpers_1.createToolContext)(api, 'feishu_bitable_app_table');
+    (0, helpers_1.registerTool)(api, {
+        name: 'feishu_bitable_app_table',
+        label: 'Feishu Bitable Tables',
+        description: '【以用户身份】飞书多维表格数据表管理工具。当用户要求创建/查询/管理数据表时使用。' +
+            '\n\nActions: create（创建数据表，可选择在创建时传入 fields 数组定义字段，或后续逐个添加）, list（列出所有数据表）, patch（更新数据表）, batch_create（批量创建）。' +
+            '\n\n【字段定义方式】支持两种模式：1) 明确需求时，在 create 中通过 table.fields 一次性定义所有字段（减少 API 调用）；2) 探索式场景时，使用默认表 + feishu_bitable_app_table_field 逐步修改字段（更稳定，易调整）。',
+        parameters: FeishuBitableAppTableSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // CREATE
+                    // -----------------------------------------------------------------
+                    case 'create': {
+                        log.info(`create: app_token=${p.app_token}, table_name=${p.table.name}, fields_count=${p.table.fields?.length ?? 0}`);
+                        // 特殊处理：复选框（type=7）和超链接（type=15）字段不能传 property
+                        const tableData = { ...p.table };
+                        if (tableData.fields) {
+                            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                            tableData.fields = tableData.fields.map((field) => {
+                                if ((field.type === 7 || field.type === 15) && field.property !== undefined) {
+                                    const fieldTypeName = field.type === 15 ? 'URL' : 'Checkbox';
+                                    log.warn(`create: ${fieldTypeName} field (type=${field.type}, name="${field.field_name}") detected with property parameter. ` +
+                                        `Removing property to avoid API error. ` +
+                                        `${fieldTypeName} fields must omit the property parameter entirely.`);
+                                    const { property: _property, ...fieldWithoutProperty } = field;
+                                    return fieldWithoutProperty;
+                                }
+                                return field;
+                            });
+                        }
+                        const res = await client.invoke('feishu_bitable_app_table.create', (sdk, opts) => sdk.bitable.appTable.create({
+                            path: {
+                                app_token: p.app_token,
+                            },
+                            data: {
+                                table: tableData,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`create: created table ${res.data?.table_id}`);
+                        return (0, helpers_1.json)({
+                            table_id: res.data?.table_id,
+                            default_view_id: res.data?.default_view_id,
+                            field_id_list: res.data?.field_id_list,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // LIST
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: app_token=${p.app_token}, page_size=${p.page_size ?? 50}`);
+                        const res = await client.invoke('feishu_bitable_app_table.list', (sdk, opts) => sdk.bitable.appTable.list({
+                            path: {
+                                app_token: p.app_token,
+                            },
+                            params: {
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        log.info(`list: returned ${data?.items?.length ?? 0} tables`);
+                        return (0, helpers_1.json)({
+                            tables: data?.items,
+                            has_more: data?.has_more ?? false,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // PATCH
+                    // -----------------------------------------------------------------
+                    case 'patch': {
+                        log.info(`patch: app_token=${p.app_token}, table_id=${p.table_id}, name=${p.name}`);
+                        const res = await client.invoke('feishu_bitable_app_table.patch', (sdk, opts) => sdk.bitable.appTable.patch({
+                            path: {
+                                app_token: p.app_token,
+                                table_id: p.table_id,
+                            },
+                            data: {
+                                name: p.name,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`patch: updated table ${p.table_id}`);
+                        return (0, helpers_1.json)({
+                            name: res.data?.name,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // BATCH_CREATE (P1)
+                    // -----------------------------------------------------------------
+                    case 'batch_create': {
+                        if (!p.tables || p.tables.length === 0) {
+                            return (0, helpers_1.json)({
+                                error: 'tables is required and cannot be empty',
+                            });
+                        }
+                        log.info(`batch_create: app_token=${p.app_token}, tables_count=${p.tables.length}`);
+                        const res = await client.invoke('feishu_bitable_app_table.batch_create', (sdk, opts) => sdk.bitable.appTable.batchCreate({
+                            path: {
+                                app_token: p.app_token,
+                            },
+                            data: {
+                                tables: p.tables,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`batch_create: created ${p.tables.length} tables in app ${p.app_token}`);
+                        return (0, helpers_1.json)({
+                            table_ids: res.data?.table_ids,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await (0, helpers_1.handleInvokeErrorWithAutoAuth)(err, cfg);
+            }
+        },
+    }, { name: 'feishu_bitable_app_table' });
+}

package/src/tools/oapi/bitable/app.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_bitable_app tool -- Manage Feishu Bitable apps (multidimensional tables).
+ *
+ * P0 Actions: create, get, list, patch
+ * P1 Actions: copy
+ *
+ * Uses the Feishu Bitable v1 API:
+ *   - create: POST /open-apis/bitable/v1/apps
+ *   - get:    GET  /open-apis/bitable/v1/apps/:app_token
+ *   - list:   GET  /open-apis/drive/v1/files (filtered by type=bitable)
+ *   - patch:  PATCH /open-apis/bitable/v1/apps/:app_token
+ *   - copy:   POST /open-apis/bitable/v1/apps/:app_token/copy
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuBitableAppTool(api: OpenClawPluginApi): void;

package/src/tools/oapi/bitable/app.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_bitable_app tool -- Manage Feishu Bitable apps (multidimensional tables).
+ *
+ * P0 Actions: create, get, list, patch
+ * P1 Actions: copy
+ *
+ * Uses the Feishu Bitable v1 API:
+ *   - create: POST /open-apis/bitable/v1/apps
+ *   - get:    GET  /open-apis/bitable/v1/apps/:app_token
+ *   - list:   GET  /open-apis/drive/v1/files (filtered by type=bitable)
+ *   - patch:  PATCH /open-apis/bitable/v1/apps/:app_token
+ *   - copy:   POST /open-apis/bitable/v1/apps/:app_token/copy
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuBitableAppTool = registerFeishuBitableAppTool;
+const typebox_1 = require("@sinclair/typebox");
+const helpers_1 = require("../helpers.js");
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuBitableAppSchema = typebox_1.Type.Union([
+    // CREATE (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('create'),
+        name: typebox_1.Type.String({ description: '多维表格名称' }),
+        folder_token: typebox_1.Type.Optional(typebox_1.Type.String({ description: '所在文件夹 token（默认创建在我的空间）' })),
+    }),
+    // GET (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('get'),
+        app_token: typebox_1.Type.String({ description: '多维表格的唯一标识 token' }),
+    }),
+    // LIST (P0) - 通过 Drive API 获取
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('list'),
+        folder_token: typebox_1.Type.Optional(typebox_1.Type.String({ description: '文件夹 token（默认列出我的空间）' })),
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Number({ description: '每页数量，默认 50，最大 200' })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({ description: '分页标记' })),
+    }),
+    // PATCH (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('patch'),
+        app_token: typebox_1.Type.String({ description: '多维表格 token' }),
+        name: typebox_1.Type.Optional(typebox_1.Type.String({ description: '新的名称' })),
+        is_advanced: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: '是否开启高级权限' })),
+    }),
+    // COPY (P1)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('copy'),
+        app_token: typebox_1.Type.String({ description: '源多维表格 token' }),
+        name: typebox_1.Type.String({ description: '新的名称' }),
+        folder_token: typebox_1.Type.Optional(typebox_1.Type.String({ description: '目标文件夹 token' })),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function registerFeishuBitableAppTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = (0, helpers_1.createToolContext)(api, 'feishu_bitable_app');
+    (0, helpers_1.registerTool)(api, {
+        name: 'feishu_bitable_app',
+        label: 'Feishu Bitable Apps',
+        description: '【以用户身份】飞书多维表格应用管理工具。当用户要求创建/查询/管理多维表格时使用。Actions: create（创建多维表格）, get（获取多维表格元数据）, list（列出多维表格）, patch（更新元数据）, delete（删除多维表格）, copy（复制多维表格）。',
+        parameters: FeishuBitableAppSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // CREATE
+                    // -----------------------------------------------------------------
+                    case 'create': {
+                        log.info(`create: name=${p.name}, folder_token=${p.folder_token ?? 'my_space'}`);
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const data = { name: p.name };
+                        if (p.folder_token) {
+                            data.folder_token = p.folder_token;
+                        }
+                        const res = await client.invoke('feishu_bitable_app.create', (sdk, opts) => sdk.bitable.app.create({
+                            data,
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`create: created app ${res.data?.app?.app_token}`);
+                        return (0, helpers_1.json)({
+                            app: res.data?.app,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // GET
+                    // -----------------------------------------------------------------
+                    case 'get': {
+                        log.info(`get: app_token=${p.app_token}`);
+                        const res = await client.invoke('feishu_bitable_app.get', (sdk, opts) => sdk.bitable.app.get({
+                            path: {
+                                app_token: p.app_token,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`get: returned app ${p.app_token}`);
+                        return (0, helpers_1.json)({
+                            app: res.data?.app,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // LIST - 使用 Drive API 筛选 bitable 类型文件
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: folder_token=${p.folder_token ?? 'my_space'}, page_size=${p.page_size ?? 50}`);
+                        const res = await client.invoke('feishu_bitable_app.list', (sdk, opts) => sdk.drive.v1.file.list({
+                            params: {
+                                folder_token: p.folder_token || '',
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        // 筛选出 type === "bitable" 的文件
+                        const data = res.data;
+                        const bitables = data?.files?.filter(
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        (f) => f.type === 'bitable') || [];
+                        log.info(`list: returned ${bitables.length} bitable apps`);
+                        return (0, helpers_1.json)({
+                            apps: bitables,
+                            has_more: data?.has_more ?? false,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // PATCH
+                    // -----------------------------------------------------------------
+                    case 'patch': {
+                        log.info(`patch: app_token=${p.app_token}, name=${p.name}, is_advanced=${p.is_advanced}`);
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const updateData = {};
+                        if (p.name !== undefined)
+                            updateData.name = p.name;
+                        if (p.is_advanced !== undefined)
+                            updateData.is_advanced = p.is_advanced;
+                        const res = await client.invoke('feishu_bitable_app.patch', (sdk, opts) => sdk.bitable.app.update({
+                            path: {
+                                app_token: p.app_token,
+                            },
+                            data: updateData,
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`patch: updated app ${p.app_token}`);
+                        return (0, helpers_1.json)({
+                            app: res.data?.app,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // COPY (P1)
+                    // -----------------------------------------------------------------
+                    case 'copy': {
+                        log.info(`copy: app_token=${p.app_token}, name=${p.name}, folder_token=${p.folder_token ?? 'my_space'}`);
+                        // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                        const data = { name: p.name };
+                        if (p.folder_token) {
+                            data.folder_token = p.folder_token;
+                        }
+                        const res = await client.invoke('feishu_bitable_app.copy', (sdk, opts) => sdk.bitable.app.copy({
+                            path: {
+                                app_token: p.app_token,
+                            },
+                            data,
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`copy: created copy ${res.data?.app?.app_token}`);
+                        return (0, helpers_1.json)({
+                            app: res.data?.app,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await (0, helpers_1.handleInvokeErrorWithAutoAuth)(err, cfg);
+            }
+        },
+    }, { name: 'feishu_bitable_app' });
+}

package/src/tools/oapi/bitable/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+export { registerFeishuBitableAppTool } from './app';
+export { registerFeishuBitableAppTableTool } from './app-table';
+export { registerFeishuBitableAppTableRecordTool } from './app-table-record';
+export { registerFeishuBitableAppTableFieldTool } from './app-table-field';
+export { registerFeishuBitableAppTableViewTool } from './app-table-view';

package/src/tools/oapi/bitable/index.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuBitableAppTableViewTool = exports.registerFeishuBitableAppTableFieldTool = exports.registerFeishuBitableAppTableRecordTool = exports.registerFeishuBitableAppTableTool = exports.registerFeishuBitableAppTool = void 0;
+var app_1 = require("./app.js");
+Object.defineProperty(exports, "registerFeishuBitableAppTool", { enumerable: true, get: function () { return app_1.registerFeishuBitableAppTool; } });
+var app_table_1 = require("./app-table.js");
+Object.defineProperty(exports, "registerFeishuBitableAppTableTool", { enumerable: true, get: function () { return app_table_1.registerFeishuBitableAppTableTool; } });
+var app_table_record_1 = require("./app-table-record.js");
+Object.defineProperty(exports, "registerFeishuBitableAppTableRecordTool", { enumerable: true, get: function () { return app_table_record_1.registerFeishuBitableAppTableRecordTool; } });
+var app_table_field_1 = require("./app-table-field.js");
+Object.defineProperty(exports, "registerFeishuBitableAppTableFieldTool", { enumerable: true, get: function () { return app_table_field_1.registerFeishuBitableAppTableFieldTool; } });
+var app_table_view_1 = require("./app-table-view.js");
+Object.defineProperty(exports, "registerFeishuBitableAppTableViewTool", { enumerable: true, get: function () { return app_table_view_1.registerFeishuBitableAppTableViewTool; } });

package/src/tools/oapi/calendar/calendar.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_calendar_calendar tool -- Manage Feishu calendars.
+ *
+ * P0 Actions: list, get, primary
+ *
+ * Uses the Feishu Calendar API:
+ *   - list:    GET  /open-apis/calendar/v4/calendars
+ *   - get:     GET  /open-apis/calendar/v4/calendars/:calendar_id
+ *   - primary: POST /open-apis/calendar/v4/calendars/primary
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuCalendarCalendarTool(api: OpenClawPluginApi): void;

package/src/tools/oapi/calendar/calendar.js

@@ -0,0 +1,125 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_calendar_calendar tool -- Manage Feishu calendars.
+ *
+ * P0 Actions: list, get, primary
+ *
+ * Uses the Feishu Calendar API:
+ *   - list:    GET  /open-apis/calendar/v4/calendars
+ *   - get:     GET  /open-apis/calendar/v4/calendars/:calendar_id
+ *   - primary: POST /open-apis/calendar/v4/calendars/primary
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuCalendarCalendarTool = registerFeishuCalendarCalendarTool;
+const typebox_1 = require("@sinclair/typebox");
+const helpers_1 = require("../helpers.js");
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuCalendarCalendarSchema = typebox_1.Type.Union([
+    // LIST
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('list'),
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Number({
+            description: 'Number of calendars to return per page (default: 50, max: 1000)',
+        })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'Pagination token for next page',
+        })),
+    }),
+    // GET
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('get'),
+        calendar_id: typebox_1.Type.String({
+            description: 'Calendar ID',
+        }),
+    }),
+    // PRIMARY
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('primary'),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function registerFeishuCalendarCalendarTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = (0, helpers_1.createToolContext)(api, 'feishu_calendar_calendar');
+    (0, helpers_1.registerTool)(api, {
+        name: 'feishu_calendar_calendar',
+        label: 'Feishu Calendar Management',
+        description: '【以用户身份】飞书日历管理工具。用于查询日历列表、获取日历信息、查询主日历。Actions: list（查询日历列表）, get（查询指定日历信息）, primary（查询主日历信息）。',
+        parameters: FeishuCalendarCalendarSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // LIST CALENDARS
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: page_size=${p.page_size ?? 50}, page_token=${p.page_token ?? 'none'}`);
+                        const res = await client.invoke('feishu_calendar_calendar.list', (sdk, opts) => sdk.calendar.calendar.list({
+                            params: {
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        const calendars = data?.calendar_list ?? [];
+                        log.info(`list: returned ${calendars.length} calendars`);
+                        return (0, helpers_1.json)({
+                            calendars,
+                            has_more: data?.has_more ?? false,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // GET CALENDAR
+                    // -----------------------------------------------------------------
+                    case 'get': {
+                        if (!p.calendar_id) {
+                            return (0, helpers_1.json)({
+                                error: "calendar_id is required for 'get' action",
+                            });
+                        }
+                        log.info(`get: calendar_id=${p.calendar_id}`);
+                        const res = await client.invoke('feishu_calendar_calendar.get', (sdk, opts) => sdk.calendar.calendar.get({
+                            path: { calendar_id: p.calendar_id },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`get: retrieved calendar ${p.calendar_id}`);
+                        const data = res.data;
+                        return (0, helpers_1.json)({
+                            calendar: data?.calendar ?? res.data,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // PRIMARY CALENDAR
+                    // -----------------------------------------------------------------
+                    case 'primary': {
+                        log.info(`primary: querying primary calendar`);
+                        const res = await client.invoke('feishu_calendar_calendar.primary', (sdk, opts) => sdk.calendar.calendar.primary({}, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        const calendars = data?.calendars ?? [];
+                        log.info(`primary: returned ${calendars.length} primary calendars`);
+                        return (0, helpers_1.json)({
+                            calendars,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await (0, helpers_1.handleInvokeErrorWithAutoAuth)(err, cfg);
+            }
+        },
+    }, { name: 'feishu_calendar_calendar' });
+}

package/src/tools/oapi/calendar/event-attendee.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_calendar_event_attendee tool -- Manage Feishu calendar event attendees.
+ *
+ * P0 Actions: create, list
+ *
+ * Uses the Feishu Calendar API:
+ *   - create: POST /open-apis/calendar/v4/calendars/:calendar_id/events/:event_id/attendees
+ *   - list:   GET  /open-apis/calendar/v4/calendars/:calendar_id/events/:event_id/attendees
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuCalendarEventAttendeeTool(api: OpenClawPluginApi): void;