This document offers a thorough walkthrough for integrating the OpenClaw platform with Feishu (internationally recognized as Lark). It meticulously details each stage of the process, beginning with the creation of a Feishu application, progressing through the configuration of necessary permissions and event subscriptions, and culminating in the final setup within OpenClaw. Additionally, the guide addresses potential issues with a troubleshooting section, explains group chat management, and highlights the benefits of streaming responses, providing a complete resource for a successful and efficient connection.
Detailed Steps for OpenClaw-Feishu Integration
In a significant development for enterprise collaboration, OpenClaw has officially announced its integration with Feishu (Lark), ByteDance's prominent communication platform. This integration, introduced with OpenClaw v2026.2.2, marks Feishu as the first Chinese chat client to receive official support. The collaboration is designed to enhance communication capabilities for tech companies and startups, particularly those operating in China and Southeast Asia, by offering a robust, secure, and low-latency messaging solution.
To initiate the connection, users must first possess OpenClaw v2026.2.2 or a later version, along with an active Feishu/Lark enterprise account and administrative access to the Feishu Open Platform. The integration process begins with the creation of a custom application on the Feishu Open Platform. Users are required to define an app name, provide a description, and upload an icon. Crucially, the system will generate an App ID and App Secret, which are essential for authentication. Following app creation, specific permissions must be configured. These include enabling scopes such as im:message for sending and receiving communications, im:message.group_at_msg to receive group chat mentions, im:resource for accessing multimedia files, and contact:user.id:readonly for user identification. After these permissions are set, the application needs to be published for review, a process that typically involves automatic approval for self-built apps in enterprise environments.
The next critical step involves enabling event subscriptions. It is vital to select “WebSocket Mode” for long-term connections, as this method eliminates the need for a public URL, ensuring enhanced security and ease of setup behind firewalls. Finally, the obtained Feishu credentials—the App ID and App Secret—must be added to the OpenClaw configuration file (~/.openclaw/.env or ~/.openclaw/config.yaml). After restarting OpenClaw, a confirmation log message should indicate a successful WebSocket connection, signaling that the integration is complete.
To verify the integration, users can open Feishu, locate their newly created app, and send a test message. OpenClaw supports various message types, including text, images, files, audio, and video, offering rich content exchange. For group chats, OpenClaw provides three access modes: open, allowlist, and disabled, allowing administrators to control bot interactions. Additionally, OpenClaw offers streaming AI responses through interactive cards, which update in real-time to provide a more dynamic user experience for lengthy responses.
Reflecting on Seamless Communication Technologies
The strategic integration of OpenClaw with Feishu underscores the growing importance of seamless communication and collaboration tools in the modern enterprise landscape. This partnership not only streamlines operational workflows but also exemplifies a commitment to catering to regional market needs, particularly within the dynamic Asian tech sector. The emphasis on security features, such as outbound connections that negate the need for public URLs, and the focus on real-time, bidirectional messaging, highlight a forward-thinking approach to enterprise communication. This collaboration serves as a testament to how specialized platforms can enhance their utility and reach by embracing well-established local ecosystems, ultimately fostering greater efficiency and connectivity for businesses worldwide.