@larksuite/openclaw-lark 2025.7.15-beta.0

package/src/tools/oapi/task/tasklist.js

@@ -0,0 +1,276 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_task_tasklist tool -- Manage Feishu task lists.
+ *
+ * P0 Actions: create, get, list, tasks 支持通过 auth_type 参数切换用户(user)或应用(tenant)身份。
+ * P1 Actions: patch, add_members
+ *
+ * Uses the Feishu Task v2 API:
+ *   - create: POST /open-apis/task/v2/tasklists
+ *   - get:    GET  /open-apis/task/v2/tasklists/:tasklist_guid
+ *   - list:   GET  /open-apis/task/v2/tasklists
+ *   - tasks:  GET  /open-apis/task/v2/tasklists/:tasklist_guid/tasks
+ *   - patch:  PATCH /open-apis/task/v2/tasklists/:tasklist_guid
+ *   - add_members: POST /open-apis/task/v2/tasklists/:tasklist_guid/add_members
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuTaskTasklistTool = registerFeishuTaskTasklistTool;
+const typebox_1 = require("@sinclair/typebox");
+const helpers_1 = require("../helpers.js");
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuTaskTasklistAuthType = typebox_1.Type.Optional((0, helpers_1.StringEnum)(['tenant', 'user'], {
+    description: '调用 API 时使用的 Token 类型。可选值："tenant"（应用身份） 或 "user"（用户身份）。默认使用 "user"。',
+}));
+const FeishuTaskTasklistSchema = typebox_1.Type.Union([
+    // CREATE (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('create'),
+        auth_type: FeishuTaskTasklistAuthType,
+        name: typebox_1.Type.String({
+            description: '清单名称',
+        }),
+        members: typebox_1.Type.Optional(typebox_1.Type.Array(typebox_1.Type.Object({
+            id: typebox_1.Type.String({ description: '成员 ID（通常为 open_id）' }),
+            type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['user', 'app'])),
+            role: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['editor', 'viewer'])),
+        }), {
+            description: '清单成员列表（editor=可编辑，viewer=可查看）。注意：创建人自动成为 owner，如在 members 中也指定创建人，该用户最终成为 owner 并从 members 中移除（同一用户只能有一个角色）。成员类型支持 user 和 app，默认为 user。',
+        })),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // GET (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('get'),
+        auth_type: FeishuTaskTasklistAuthType,
+        tasklist_guid: typebox_1.Type.String({ description: '清单 GUID' }),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // LIST (P0)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('list'),
+        auth_type: FeishuTaskTasklistAuthType,
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Number({ description: '每页数量，默认 50，最大 100' })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({ description: '分页标记' })),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // TASKS (P0) - 列出清单内的任务
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('tasks'),
+        auth_type: FeishuTaskTasklistAuthType,
+        tasklist_guid: typebox_1.Type.String({ description: '清单 GUID' }),
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Number({ description: '每页数量，默认 50，最大 100' })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({ description: '分页标记' })),
+        completed: typebox_1.Type.Optional(typebox_1.Type.Boolean({ description: '是否只返回已完成的任务（默认返回所有）' })),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // PATCH (P1)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('patch'),
+        auth_type: FeishuTaskTasklistAuthType,
+        tasklist_guid: typebox_1.Type.String({ description: '清单 GUID' }),
+        name: typebox_1.Type.Optional(typebox_1.Type.String({ description: '新的清单名称' })),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+    // ADD_MEMBERS (P1)
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('add_members'),
+        auth_type: FeishuTaskTasklistAuthType,
+        tasklist_guid: typebox_1.Type.String({ description: '清单 GUID' }),
+        members: typebox_1.Type.Array(typebox_1.Type.Object({
+            id: typebox_1.Type.String({ description: '成员 ID（通常为 open_id）' }),
+            type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['user', 'app'])),
+            role: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['editor', 'viewer'])),
+        }), { description: '要添加的成员列表' }),
+        user_id_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['open_id', 'union_id', 'user_id'])),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function registerFeishuTaskTasklistTool(api) {
+    if (!api.config)
+        return;
+    const cfg = api.config;
+    const { toolClient, log } = (0, helpers_1.createToolContext)(api, 'feishu_task_tasklist');
+    (0, helpers_1.registerTool)(api, {
+        name: 'feishu_task_tasklist',
+        label: 'Feishu Task Lists',
+        description: '【以用户或应用身份】飞书任务清单管理工具。当用户要求创建/查询/管理清单、查看清单内的任务时使用。Actions: create（创建清单）, get（获取清单详情）, list（列出所有可读取的清单，包括我创建的和他人共享给我的）, tasks（列出清单内的任务）, patch（更新清单）, add_members（添加成员）。',
+        parameters: FeishuTaskTasklistSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // CREATE
+                    // -----------------------------------------------------------------
+                    case 'create': {
+                        log.info(`create: name=${p.name}, members_count=${p.members?.length ?? 0}`);
+                        const data = { name: p.name };
+                        // 转换成员格式
+                        if (p.members && p.members.length > 0) {
+                            data.members = p.members.map((m) => ({
+                                id: m.id,
+                                type: m.type || 'user',
+                                role: m.role || 'editor',
+                            }));
+                        }
+                        const res = await client.invoke('feishu_task_tasklist.create', (sdk, opts) => sdk.task.v2.tasklist.create({
+                            params: {
+                                user_id_type: 'open_id',
+                            },
+                            data,
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`create: created tasklist ${res.data?.tasklist?.guid}`);
+                        return (0, helpers_1.json)({
+                            tasklist: res.data?.tasklist,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // GET
+                    // -----------------------------------------------------------------
+                    case 'get': {
+                        log.info(`get: tasklist_guid=${p.tasklist_guid}`);
+                        const res = await client.invoke('feishu_task_tasklist.get', (sdk, opts) => sdk.task.v2.tasklist.get({
+                            path: {
+                                tasklist_guid: p.tasklist_guid,
+                            },
+                            params: {
+                                user_id_type: 'open_id',
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`get: returned tasklist ${p.tasklist_guid}`);
+                        return (0, helpers_1.json)({
+                            tasklist: res.data?.tasklist,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // LIST
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: page_size=${p.page_size ?? 50}`);
+                        const res = await client.invoke('feishu_task_tasklist.list', (sdk, opts) => sdk.task.v2.tasklist.list({
+                            params: {
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                                user_id_type: 'open_id',
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        log.info(`list: returned ${data?.items?.length ?? 0} tasklists`);
+                        return (0, helpers_1.json)({
+                            tasklists: data?.items,
+                            has_more: data?.has_more ?? false,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // TASKS - 列出清单内的任务
+                    // -----------------------------------------------------------------
+                    case 'tasks': {
+                        log.info(`tasks: tasklist_guid=${p.tasklist_guid}, completed=${p.completed ?? 'all'}`);
+                        const res = await client.invoke('feishu_task_tasklist.tasks', (sdk, opts) => sdk.task.v2.tasklist.tasks({
+                            path: {
+                                tasklist_guid: p.tasklist_guid,
+                            },
+                            params: {
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                                completed: p.completed,
+                                user_id_type: 'open_id',
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        log.info(`tasks: returned ${data?.items?.length ?? 0} tasks`);
+                        return (0, helpers_1.json)({
+                            tasks: data?.items,
+                            has_more: data?.has_more ?? false,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // PATCH
+                    // -----------------------------------------------------------------
+                    case 'patch': {
+                        log.info(`patch: tasklist_guid=${p.tasklist_guid}, name=${p.name}`);
+                        // 飞书 Task API 要求特殊的更新格式
+                        const tasklistData = {};
+                        const updateFields = [];
+                        if (p.name !== undefined) {
+                            tasklistData.name = p.name;
+                            updateFields.push('name');
+                        }
+                        if (updateFields.length === 0) {
+                            return (0, helpers_1.json)({
+                                error: 'No fields to update',
+                            });
+                        }
+                        const res = await client.invoke('feishu_task_tasklist.patch', (sdk, opts) => sdk.task.v2.tasklist.patch({
+                            path: {
+                                tasklist_guid: p.tasklist_guid,
+                            },
+                            params: {
+                                user_id_type: 'open_id',
+                            },
+                            data: {
+                                tasklist: tasklistData,
+                                update_fields: updateFields,
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`patch: updated tasklist ${p.tasklist_guid}`);
+                        return (0, helpers_1.json)({
+                            tasklist: res.data?.tasklist,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // ADD_MEMBERS
+                    // -----------------------------------------------------------------
+                    case 'add_members': {
+                        if (!p.members || p.members.length === 0) {
+                            return (0, helpers_1.json)({
+                                error: 'members is required and cannot be empty',
+                            });
+                        }
+                        log.info(`add_members: tasklist_guid=${p.tasklist_guid}, members_count=${p.members.length}`);
+                        const memberData = p.members.map((m) => ({
+                            id: m.id,
+                            type: m.type || 'user',
+                            role: m.role || 'editor',
+                        }));
+                        const res = await client.invoke('feishu_task_tasklist.add_members', (sdk, opts) => sdk.task.v2.tasklist.addMembers({
+                            path: {
+                                tasklist_guid: p.tasklist_guid,
+                            },
+                            params: {
+                                user_id_type: 'open_id',
+                            },
+                            data: {
+                                members: memberData,
+                            },
+                        }, opts), { as: p.auth_type || 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`add_members: added ${p.members.length} members to tasklist ${p.tasklist_guid}`);
+                        return (0, helpers_1.json)({
+                            tasklist: res.data?.tasklist,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await (0, helpers_1.handleInvokeErrorWithAutoAuth)(err, cfg);
+            }
+        },
+    }, { name: 'feishu_task_tasklist' });
+}

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

@@ -0,0 +1,12 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Wiki 工具集
+ * 统一导出所有知识库相关工具的注册函数
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+/**
+ * 注册所有 Wiki 工具
+ */
+export declare function registerFeishuWikiTools(api: OpenClawPluginApi): void;

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

@@ -0,0 +1,42 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * Wiki 工具集
+ * 统一导出所有知识库相关工具的注册函数
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuWikiTools = registerFeishuWikiTools;
+const accounts_1 = require("../../../core/accounts.js");
+const tools_config_1 = require("../../../core/tools-config.js");
+const space_1 = require("./space.js");
+const space_node_1 = require("./space-node.js");
+/**
+ * 注册所有 Wiki 工具
+ */
+function registerFeishuWikiTools(api) {
+    if (!api.config) {
+        api.logger.debug?.('feishu_wiki: No config available, skipping');
+        return;
+    }
+    const accounts = (0, accounts_1.getEnabledLarkAccounts)(api.config);
+    if (accounts.length === 0) {
+        api.logger.debug?.('feishu_wiki: No Feishu accounts configured, skipping');
+        return;
+    }
+    const toolsCfg = (0, tools_config_1.resolveAnyEnabledToolsConfig)(accounts);
+    if (!toolsCfg.wiki) {
+        api.logger.debug?.('feishu_wiki: wiki tool disabled in all accounts');
+        return;
+    }
+    // 注册所有工具
+    const registered = [];
+    if ((0, space_1.registerFeishuWikiSpaceTool)(api))
+        registered.push('feishu_wiki_space');
+    if ((0, space_node_1.registerFeishuWikiSpaceNodeTool)(api))
+        registered.push('feishu_wiki_space_node');
+    if (registered.length > 0) {
+        api.logger.debug?.(`feishu_wiki: Registered ${registered.join(', ')}`);
+    }
+}

package/src/tools/oapi/wiki/space-node.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_space_node tool -- Manage Feishu Wiki space nodes.
+ *
+ * Actions: list, get, create, move, copy
+ *
+ * Uses the Feishu Wiki API:
+ *   - list:   GET  /open-apis/wiki/v2/spaces/:space_id/nodes
+ *   - get:    GET  /open-apis/wiki/v2/spaces/get_node
+ *   - create: POST /open-apis/wiki/v2/spaces/:space_id/nodes
+ *   - move:   POST /open-apis/wiki/v2/spaces/:space_id/nodes/:node_token/move
+ *   - copy:   POST /open-apis/wiki/v2/spaces/:space_id/nodes/:node_token/copy
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuWikiSpaceNodeTool(api: OpenClawPluginApi): boolean;

package/src/tools/oapi/wiki/space-node.js

@@ -0,0 +1,233 @@
+"use strict";
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_space_node tool -- Manage Feishu Wiki space nodes.
+ *
+ * Actions: list, get, create, move, copy
+ *
+ * Uses the Feishu Wiki API:
+ *   - list:   GET  /open-apis/wiki/v2/spaces/:space_id/nodes
+ *   - get:    GET  /open-apis/wiki/v2/spaces/get_node
+ *   - create: POST /open-apis/wiki/v2/spaces/:space_id/nodes
+ *   - move:   POST /open-apis/wiki/v2/spaces/:space_id/nodes/:node_token/move
+ *   - copy:   POST /open-apis/wiki/v2/spaces/:space_id/nodes/:node_token/copy
+ */
+/* eslint-disable @typescript-eslint/no-explicit-any */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerFeishuWikiSpaceNodeTool = registerFeishuWikiSpaceNodeTool;
+const typebox_1 = require("@sinclair/typebox");
+const helpers_1 = require("../helpers.js");
+// ---------------------------------------------------------------------------
+// Schema
+// ---------------------------------------------------------------------------
+const FeishuWikiSpaceNodeSchema = typebox_1.Type.Union([
+    // LIST NODES
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('list'),
+        space_id: typebox_1.Type.String({
+            description: 'space_id',
+        }),
+        parent_node_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'parent_node_token',
+        })),
+        page_size: typebox_1.Type.Optional(typebox_1.Type.Integer({
+            description: 'page_size',
+            minimum: 1,
+        })),
+        page_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'page_token',
+        })),
+    }),
+    // GET NODE
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('get'),
+        token: typebox_1.Type.String({
+            description: 'node token',
+        }),
+        obj_type: typebox_1.Type.Optional((0, helpers_1.StringEnum)(['doc', 'sheet', 'mindnote', 'bitable', 'file', 'docx', 'slides', 'wiki'], { description: 'obj_type' })),
+    }),
+    // CREATE NODE
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('create'),
+        space_id: typebox_1.Type.String({
+            description: 'space_id',
+        }),
+        obj_type: (0, helpers_1.StringEnum)(['sheet', 'mindnote', 'bitable', 'file', 'docx', 'slides'], { description: 'obj_type' }),
+        parent_node_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'parent_node_token',
+        })),
+        node_type: (0, helpers_1.StringEnum)(['origin', 'shortcut'], {
+            description: 'node_type',
+        }),
+        origin_node_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'origin_node_token',
+        })),
+        title: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'title',
+        })),
+    }),
+    // MOVE NODE
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('move'),
+        space_id: typebox_1.Type.String({
+            description: 'space_id',
+        }),
+        node_token: typebox_1.Type.String({
+            description: 'node_token',
+        }),
+        target_parent_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'target_parent_token',
+        })),
+    }),
+    // COPY NODE
+    typebox_1.Type.Object({
+        action: typebox_1.Type.Literal('copy'),
+        space_id: typebox_1.Type.String({
+            description: 'space_id',
+        }),
+        node_token: typebox_1.Type.String({
+            description: 'node_token',
+        }),
+        target_space_id: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'target_space_id',
+        })),
+        target_parent_token: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'target_parent_token',
+        })),
+        title: typebox_1.Type.Optional(typebox_1.Type.String({
+            description: 'title',
+        })),
+    }),
+]);
+// ---------------------------------------------------------------------------
+// Registration
+// ---------------------------------------------------------------------------
+function registerFeishuWikiSpaceNodeTool(api) {
+    if (!api.config)
+        return false;
+    const cfg = api.config;
+    const { toolClient, log } = (0, helpers_1.createToolContext)(api, 'feishu_wiki_space_node');
+    return (0, helpers_1.registerTool)(api, {
+        name: 'feishu_wiki_space_node',
+        label: 'Feishu Wiki Space Nodes',
+        description: '飞书知识库节点管理工具。操作：list（列表）、get（获取）、create（创建）、move（移动）、copy（复制）。' +
+            '节点是知识库中的文档，包括 doc、bitable(多维表表格)、sheet(电子表格) 等类型。' +
+            'node_token 是节点的唯一标识符，obj_token 是实际文档的 token。可通过 get 操作将 wiki 类型的 node_token 转换为实际文档的 obj_token。',
+        parameters: FeishuWikiSpaceNodeSchema,
+        async execute(_toolCallId, params) {
+            const p = params;
+            try {
+                const client = toolClient();
+                switch (p.action) {
+                    // -----------------------------------------------------------------
+                    // LIST NODES
+                    // -----------------------------------------------------------------
+                    case 'list': {
+                        log.info(`list: space_id=${p.space_id}, parent=${p.parent_node_token ?? '(root)'}, page_size=${p.page_size ?? 50}`);
+                        const res = await client.invoke('feishu_wiki_space_node.list', (sdk, opts) => sdk.wiki.spaceNode.list({
+                            path: { space_id: p.space_id },
+                            params: {
+                                page_size: p.page_size,
+                                page_token: p.page_token,
+                                parent_node_token: p.parent_node_token,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        const data = res.data;
+                        log.info(`list: returned ${data?.items?.length ?? 0} nodes`);
+                        return (0, helpers_1.json)({
+                            nodes: data?.items,
+                            has_more: data?.has_more,
+                            page_token: data?.page_token,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // GET NODE
+                    // -----------------------------------------------------------------
+                    case 'get': {
+                        log.info(`get: token=${p.token}, obj_type=${p.obj_type ?? 'wiki'}`);
+                        const res = await client.invoke('feishu_wiki_space_node.get', (sdk, opts) => sdk.wiki.space.getNode({
+                            params: {
+                                token: p.token,
+                                obj_type: (p.obj_type || 'wiki'),
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`get: retrieved node ${p.token}`);
+                        return (0, helpers_1.json)({
+                            node: res.data?.node,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // CREATE NODE
+                    // -----------------------------------------------------------------
+                    case 'create': {
+                        log.info(`create: space_id=${p.space_id}, obj_type=${p.obj_type}, parent=${p.parent_node_token ?? '(root)'}, title=${p.title ?? '(empty)'}, node_type=${p.node_type}, original_node_token=${p.origin_node_token ?? '(empty)'}`);
+                        const res = await client.invoke('feishu_wiki_space_node.create', (sdk, opts) => sdk.wiki.spaceNode.create({
+                            path: { space_id: p.space_id },
+                            data: {
+                                obj_type: p.obj_type,
+                                parent_node_token: p.parent_node_token,
+                                node_type: p.node_type,
+                                origin_node_token: p.origin_node_token,
+                                title: p.title,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`create: created node_token=${res.data?.node?.node_token}`);
+                        return (0, helpers_1.json)({
+                            node: res.data?.node,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // MOVE NODE
+                    // -----------------------------------------------------------------
+                    case 'move': {
+                        log.info(`move: space_id=${p.space_id}, node_token=${p.node_token}, target_parent=${p.target_parent_token ?? '(root)'}`);
+                        const res = await client.invoke('feishu_wiki_space_node.move', (sdk, opts) => sdk.wiki.spaceNode.move({
+                            path: {
+                                space_id: p.space_id,
+                                node_token: p.node_token,
+                            },
+                            data: {
+                                target_parent_token: p.target_parent_token,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`move: moved node ${p.node_token}`);
+                        return (0, helpers_1.json)({
+                            node: res.data?.node,
+                        });
+                    }
+                    // -----------------------------------------------------------------
+                    // COPY NODE
+                    // -----------------------------------------------------------------
+                    case 'copy': {
+                        log.info(`copy: space_id=${p.space_id}, node_token=${p.node_token}, target_space=${p.target_space_id ?? '(same)'}, target_parent=${p.target_parent_token ?? '(root)'}`);
+                        const res = await client.invoke('feishu_wiki_space_node.copy', (sdk, opts) => sdk.wiki.spaceNode.copy({
+                            path: {
+                                space_id: p.space_id,
+                                node_token: p.node_token,
+                            },
+                            data: {
+                                target_space_id: p.target_space_id,
+                                target_parent_token: p.target_parent_token,
+                                title: p.title,
+                            },
+                        }, opts), { as: 'user' });
+                        (0, helpers_1.assertLarkOk)(res);
+                        log.info(`copy: copied to node_token=${res.data?.node?.node_token}`);
+                        return (0, helpers_1.json)({
+                            node: res.data?.node,
+                        });
+                    }
+                }
+            }
+            catch (err) {
+                return await (0, helpers_1.handleInvokeErrorWithAutoAuth)(err, cfg);
+            }
+        },
+    }, { name: 'feishu_wiki_space_node' });
+}

package/src/tools/oapi/wiki/space.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) 2026 ByteDance Ltd. and/or its affiliates
+ * SPDX-License-Identifier: MIT
+ *
+ * feishu_wiki_space tool -- Manage Feishu Wiki spaces.
+ *
+ * Actions: list, get, create
+ *
+ * Uses the Feishu Wiki API:
+ *   - list:   GET  /open-apis/wiki/v2/spaces
+ *   - get:    GET  /open-apis/wiki/v2/spaces/:space_id
+ *   - create: POST /open-apis/wiki/v2/spaces
+ */
+import type { OpenClawPluginApi } from 'openclaw/plugin-sdk';
+export declare function registerFeishuWikiSpaceTool(api: OpenClawPluginApi): boolean;