Lark Toolkit for Openclaw

A comprehensive documentation-only reference guide for integrating AI agents with Lark and Feishu via plugins, MCP tools, and direct API paths.

pengxiao-wang
v1.0.0
Feb 23, 2026
0
2.3k
0

Install & Download

1. ClawHub CLI

The fastest way to install a skill directly from the registry.

npx clawhub@latest install lark-toolkit

2. Manual Installation

Copy the skill folder to one of these locations

Global
~/.openclaw/skills/
Workspace
<project>/skills/

Priority: Workspace > Local > Bundled

3. Prompt Installation

Copy this prompt to OpenClaw to install it automatically.

Help me install lark-toolkit using Clawhub. If Clawhub is not installed, install it first (npm i -g clawhub).

Prefer to download?

Get the raw skill files in a ZIP archive.

What is Lark Toolkit?

The Lark Toolkit is a robust framework designed to bridge the gap between AI agents and the Lark/Feishu collaboration suites. By providing three distinct access paths—the claw-lark plugin, MCP tools via mcporter, and direct Open API access—it ensures that developers can implement everything from simple messaging to complex Bitable and OKR management. This skill is a vital component of the Openclaw Skills ecosystem, offering a unified strategy for interacting with both Lark International and Feishu China platforms.

Built for professional developers and AI practitioners, the toolkit emphasizes security and flexibility. It relies on user-provided credentials and offers structured guidance on authentication, pagination, and error handling. Whether you are building an automated customer support bot or a complex project management agent, this skill provides the technical documentation and common API patterns necessary to leverage the full potential of Openclaw Skills in an enterprise environment.

Lark Toolkit Use Cases

  • Automating team communications by sending and replying to messages in Lark groups.
  • Managing complex organizational data through Bitable CRUD operations and record management.
  • Synchronizing corporate calendars and scheduling events using AI-driven agents.
  • Retrieving detailed organizational structures, including department users and contact lists.
  • Automating task tracking, OKR updates, and Wiki node searches for project transparency.

How Lark Toolkit Works

  1. Retrieve your App ID and App Secret from the Lark or Feishu Developer Console to establish the foundation for your Openclaw Skills integration.
  2. Choose the most efficient access path based on your needs: claw-lark for messaging, MCP for structured data, or direct curl commands for advanced administrative tasks.
  3. Generate a temporary tenant_access_token using the provided authentication scripts or manual API calls.
  4. Execute requests against the Lark International or Feishu China base URLs depending on your organization's region.
  5. Handle response data using cursor-based pagination and interpret error codes to ensure reliable agent performance.

Lark Toolkit Setup

First, obtain your credentials from the Lark Developer Console. You can then use the following bash script to fetch your access token for use within Openclaw Skills:

# Fetch tenant_access_token
TOKEN=$(curl -s -X POST 'https://open.larksuite.com/open-apis/auth/v3/tenant_access_token/internal' \
  -H 'Content-Type: application/json' \
  -d '{"app_id":"<APP_ID>","app_secret":"<APP_SECRET>"}' \
  | python3 -c "import sys,json; print(json.load(sys.stdin)['tenant_access_token'])")

Alternatively, set your environment variables to allow automated scripts to handle authentication:

export LARK_APP_ID="your_app_id"
export LARK_APP_SECRET="your_app_secret"

Lark Toolkit Data Schema & Taxonomy

The toolkit organizes data across several core modules to ensure compatibility with various Openclaw Skills workflows:

Module Data Type Key Attributes
Messaging JSON Object msg_type, content, receive_id, chat_id
Bitable Table/Record app_token, table_id, fields, records
Contacts User/Dept open_id, department_id, employee_type
Calendar Event event_id, start_time, end_time, summary
Auth Token tenant_access_token, expire_time

Lark Toolkit Advanced Features

  • Triple-path access strategy prioritizing the simplest interface (Plugin) before falling back to MCP or Direct API.
  • Comprehensive coverage of 38 MCP tools for advanced modules like OKR, Wiki, and Bitable.
  • Cross-platform support ensuring seamless operation across both open.larksuite.com and open.feishu.cn.
  • Detailed error handling and troubleshooting guides for common pitfalls like webhook timeouts and event deduplication in Openclaw Skills.
  • Specific guidance on handling bot-to-bot communication limitations and permission publishing requirements.

SKILL.md


Loading

Related Openclaw Skills

METADATA

Github Stars: 0
forks: 0

Featured*