feat: Lark integration closes #3571 #3576

waleedalzarooni · 2025-12-15T16:35:36Z

Description

Adds LarkToolkit for integrating CAMEL agents with Lark (Feishu) Open Platform - a popular enterprise collaboration platform similar to Slack + Notion.

Features

Authentication

Browser-based OAuth 2.0 with automatic token caching (~/.camel/lark_token.json)
Auto-refresh tokens before expiry
Supports both user tokens (documents) and tenant tokens (messaging)

16 Tools Available

Category	Tools
Documents	`create_document`, `get_document`, `get_document_content`
Blocks	`list_document_blocks`, `get_block`, `get_block_children`, `create_block`, `update_block`, `delete_block`
Drive	`get_root_folder_token`, `list_folder_contents`, `create_folder`
Messaging	`send_message`, `list_chats`, `get_chat`, `get_chat_messages`

Block Types Supported: text, heading (1-9), bullet, ordered, code, quote, todo, divider, callout

Configuration

LARK_APP_ID=cli_xxxxx
LARK_APP_SECRET=xxxxxxxx

Usage

from camel.toolkits import LarkToolkit
from camel.agents import ChatAgent

toolkit = LarkToolkit()  # Auto-authenticates
agent = ChatAgent(system_message="Lark assistant", tools=toolkit.get_tools())
agent.step("Create a document called 'Notes' and add a heading 'Tasks'")

Files Added

camel/toolkits/lark_toolkit.py - Main implementation
examples/toolkits/lark_toolkit_example.py - Examples
test/toolkits/test_lark_toolkit.py - Unit tests

Checklist

Go over all the following points, and put an x in all the boxes that apply.

[ X] I have read the CONTRIBUTION guide (required)
[ X] I have linked this PR to an issue using the Development section on the right sidebar or by adding Fixes #issue-number in the PR description (required)
[X ] I have checked if any dependencies need to be added or updated in pyproject.toml and uv lock
[ X] I have updated the tests accordingly (required for a bug fix or a new feature)
[ X] I have updated the documentation if needed:
[ X] I have added examples if this is a new feature

If you are unsure about any of these, don't hesitate to ask. We are here to help!

coderabbitai · 2025-12-15T16:35:46Z

Important

Review skipped

Auto reviews are disabled on this repository.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

_{Comment @coderabbitai help to get the list of available commands and usage tips.}

camel/toolkits/lark_toolkit.py

examples/toolkits/lark_oauth_example.py

Pakchoioioi · 2025-12-17T21:53:22Z

@waleedalzarooni thanks for the contribution. I suppose that would be better that the Lark integration should allow:

Agents to access Lark data from:

Direct message
IM group chats message
Lark Docs (Feishu Documents)

waleedalzarooni · 2025-12-22T15:34:12Z

@Wendong-Fan @a7m-1st @fengju0213 @JINO-ROHIT There are a couple of conflicts however I don't want to resolve them on the command line in case all the changes in master get included in the diff making reviews difficult. I propose that after reviews are completed I can create a commit updating the branch to master before we merge.

a7m-1st

Hi there @waleedalzarooni thanks for the PR, those are my analysis after static review.

I am yet to test it, though I hope meanwhile you can make those simple changes to maintain consistency.

camel/toolkits/lark_toolkit.py

a7m-1st · 2025-12-23T20:57:40Z

camel/toolkits/lark_toolkit.py

+
+            response = requests.post(
+                url, headers=headers, json=body, timeout=30
+            )
+            result = response.json()
+


16 instances use hard coded timeouts, but we defined it in Args. Perhaps need to use self.timeout:

timeout (Optional[float]): Request timeout in seconds.

fengju0213

thanks @waleedalzarooni left some comments

fengju0213 · 2025-12-23T12:12:51Z

camel/toolkits/lark_toolkit.py

+            logger.error(f"Error getting document: {e}")
+            return {"error": f"Error getting document: {e!s}"}
+
+    def lark_get_document_content(


seems like there are query parameters can be added

fengju0213 · 2025-12-23T12:18:49Z

camel/toolkits/lark_toolkit.py

+            logger.error(f"Error listing blocks: {e}")
+            return {"error": f"Error listing blocks: {e!s}"}
+
+    def lark_get_block(


i suggest using the same api name in lark doc to replace all toolkit methods

fengju0213 · 2025-12-23T12:30:58Z

camel/toolkits/lark_toolkit.py

+        self,
+        document_id: str,
+        block_id: str,
+        parent_block_id: Optional[str] = None,


can not find the parent_block_id parameter in the doc https://open.larksuite.com/document/server-docs/docs/docs/docx-v1/document-block/batch_delete

fengju0213 · 2025-12-25T10:24:58Z

camel/toolkits/lark_toolkit.py

+        self,
+        folder_token: Optional[str] = None,
+        page_size: int = 50,
+        page_token: Optional[str] = None,


cannot find order_by and direction in doc https://open.larksuite.com/document/server-docs/docs/drive-v1/folder/list

fengju0213 · 2025-12-25T10:26:10Z

camel/toolkits/lark_toolkit.py

+            logger.error(f"Error listing folder contents: {e}")
+            return {"error": f"Error listing folder contents: {e!s}"}
+
+    def lark_get_root_folder_token(self) -> Dict[str, Any]:


betterbetter to unfiy the name

fengju0213 · 2025-12-25T10:38:55Z

camel/toolkits/lark_toolkit.py

+    def lark_create_folder(
+        self,
+        name: str,
+        folder_token: Optional[str] = None,


its a required parameter

fengju0213 · 2025-12-25T14:02:58Z

camel/toolkits/lark_toolkit.py

+        self,
+        receive_id: str,
+        content: str,
+        receive_id_type: Literal[


some parameters are required

fengju0213

LGTM

Wendong-Fan

thanks @waleedalzarooni and @fengju0213 and sorry for the late review, added one enhance PR: #3685, feel free to check and leave your comment

initial implementation

65cdd03

waleedalzarooni requested review from Wendong-Fan, a7m-1st and fengju0213 December 15, 2025 16:35

waleedalzarooni self-assigned this Dec 15, 2025

waleedalzarooni added the Waiting for Update PR has been reviewed, need to be updated based on review comment label Dec 15, 2025

waleedalzarooni marked this pull request as draft December 15, 2025 16:35

github-actions bot added the Review Required PR need to be reviewed label Dec 15, 2025

waleedalzarooni linked an issue Dec 15, 2025 that may be closed by this pull request

[Feature Request] Integrate Lark #3571

Closed

2 tasks

waleedalzarooni removed the Review Required PR need to be reviewed label Dec 15, 2025

github-advanced-security bot found potential problems Dec 15, 2025

View reviewed changes

working OAUTH, folder_token methods

dcfada0

github-advanced-security bot found potential problems Dec 16, 2025

View reviewed changes

examples/toolkits/lark_oauth_example.py Fixed Show fixed Hide fixed

Pakchoioioi mentioned this pull request Dec 17, 2025

[Feature Request] Integrate Lark (International Version) into Eigent for Agent Access to Chats, Channels, and Weekly Reports eigent-ai/eigent#792

Closed

waleedalzarooni added 5 commits December 18, 2025 11:48

minimal working version

00c09cd

bot based message retrieval

2db0ddf

OAUTH consolidation

f2464d3

OAUTH enhancement

6e41fc8

minor fixes

35f959f

Wendong-Fan added this to the Sprint 45 milestone Dec 22, 2025

Wendong-Fan added this to Project Camel Dec 22, 2025

final fixes

fe48e35

waleedalzarooni marked this pull request as ready for review December 22, 2025 15:15

waleedalzarooni requested a review from JINO-ROHIT December 22, 2025 15:31

waleedalzarooni added Review Required PR need to be reviewed P0 Task with high level priority and removed Waiting for Update PR has been reviewed, need to be updated based on review comment labels Dec 22, 2025

a7m-1st requested changes Dec 23, 2025

View reviewed changes

fengju0213 requested changes Dec 26, 2025

View reviewed changes

fengju0213 and others added 3 commits January 4, 2026 13:46

chore: Enhance lark (#3631)

5bf1470

example file update

9da27e8

Merge branch 'master' into feat/lark-integration

19fbbc0

waleedalzarooni requested review from a7m-1st and fengju0213 January 4, 2026 14:02

fengju0213 modified the milestones: Sprint 45, Sprint 46 Jan 5, 2026

fengju0213 and others added 4 commits January 12, 2026 14:40

Merge branch 'master' into feat/lark-integration

f5a8a0d

add extension

0f9fbdd

minor update

726b7a9

Update uv.lock

7e674b3

fengju0213 approved these changes Jan 12, 2026

View reviewed changes

Wendong-Fan reviewed Jan 13, 2026

View reviewed changes

Wendong-Fan added 2 commits January 13, 2026 08:51

enhance: feat: Lark integration closes #3571 (#3685)

887ef4c

Merge branch 'master' into feat/lark-integration

6906af3

Wendong-Fan merged commit 986eda5 into master Jan 13, 2026
13 checks passed

Wendong-Fan deleted the feat/lark-integration branch January 13, 2026 00:52

feat: Lark integration closes #3571 #3576

feat: Lark integration closes #3571 #3576

Uh oh!

Conversation

waleedalzarooni commented Dec 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Description

Features

Configuration

Usage

Files Added

Checklist

Uh oh!

coderabbitai bot commented Dec 15, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

Review skipped

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Pakchoioioi commented Dec 17, 2025

Uh oh!

waleedalzarooni commented Dec 22, 2025

Uh oh!

a7m-1st left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fengju0213 left a comment

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

Choose a reason for hiding this comment

Uh oh!

fengju0213 left a comment

Choose a reason for hiding this comment

Uh oh!

Wendong-Fan left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

5 participants

waleedalzarooni commented Dec 15, 2025 •

edited

Loading

coderabbitai bot commented Dec 15, 2025 •

edited

Loading