Lark (by Lark Suite)

Use Cases

• Full workspace AI assistant — search messages, read docs, query bitable data, manage calendar events, all from chat
• Automated document creation and editing within Lark Docs triggered by chat commands
• Calendar management assistant that checks availability, creates events, and manages attendees via chat
• Task tracking bot that creates, updates, and completes tasks and subtasks through Lark Tasks integration
• Bitable/database query assistant that answers questions by running structured queries against Lark Base data
• Knowledge base assistant that reads and summarizes content from Lark Docs and Wiki spaces

Tips

• Start with read-only permissions and add write permissions only as needed — principle of least privilege
• Keep the default security settings unchanged — the Lark team explicitly warns against relaxing them
• Use the plugin as a private 1:1 assistant before enabling group chat features
• The detailed setup guide is at: https://bytedance.larkoffice.com/docx/MFK7dDFLFoVlOGxWCv5cTXKmnMh
• Interactive cards with Thinking/Generating/Complete status make the bot feel responsive during long operations
• Use per-group configuration to bind specific skills and system prompts to different group chats
• Grant the contact:user.base:readonly permission to resolve sender display names for speaker attribution
• For bitable operations, the advanced filtering API lets you build complex queries without reading entire tables

Known Issues & Gotchas

• Requires OpenClaw >= 2026.2.26 — check with `openclaw -v` and upgrade with `npm install -g openclaw` if needed
• Event subscriptions MUST be configured in the Feishu/Lark app settings — the plugin alone doesn't register them automatically
• Default security protections are strict by design — DO NOT relax them unless you fully understand the consequences
• The plugin acts under YOUR user identity — granting broad permissions means OpenClaw can do anything you can do in Lark/Feishu
• Use as a private conversational assistant only — don't add to group chats with untrusted users to prevent abuse
• Read and write permissions are separate scopes — you need to grant both individually for full CRUD operations
• The docx:document.block:convert permission is required for document write/append/create operations and drive imports
• Permission names in the Feishu console UI may not exactly match the scope names listed in docs — search by keyword if confused

Alternatives

• @openclaw/feishu
• @larksuiteoapi/feishu-openclaw-plugin
• @m1heng-clawd/feishu

Community Feedback

Master OpenClaw and Lark integration with our comprehensive guide. Learn to build a local-first AI agent that directly reads from and writes to messages, docs, bases, calendars, tasks, and more.

— Lark Suite Blog

This is the official Lark/Feishu plugin for OpenClaw, developed and maintained by the Lark/Feishu Open Platform team. It seamlessly connects your OpenClaw Agent to your Lark/Feishu workspace.

— GitHub

We strongly recommend that you do not proactively modify any default security settings; once relevant restrictions are relaxed, the risks will increase significantly.

— GitHub

Frequently Asked Questions

Configuration Examples

Basic Lark Bot Setup

channels:
  lark:
    enabled: true
    appId: cli_a1b2c3d4e5f6
    appSecret: ${LARK_APP_SECRET}
    verificationToken: ${LARK_VERIFY_TOKEN}

Lark with Full Workspace Permissions

channels:
  lark:
    enabled: true
    appId: cli_a1b2c3d4e5f6
    appSecret: ${LARK_APP_SECRET}
    encryptKey: ${LARK_ENCRYPT_KEY}
    verificationToken: ${LARK_VERIFY_TOKEN}
    dm:
      policy: pairing
    features:
      docs: true
      base: true
      sheets: true
      calendar: true
      tasks: true

Lark with Per-Group Configuration

channels:
  lark:
    enabled: true
    appId: cli_a1b2c3d4e5f6
    appSecret: ${LARK_APP_SECRET}
    verificationToken: ${LARK_VERIFY_TOKEN}
    groups:
      policy: allowlist
      allowed:
        - oc_xxxxxxxxxxxxxxxx
      settings:
        oc_xxxxxxxxxxxxxxxx:
          systemPrompt: 'You are a project management assistant for the engineering team.'
          skills:
            - tasks
            - calendar

Installation

openclaw plugins install @larksuite/openclaw-lark