Skip to content
Last updated

OpenClaw Feishu / Lark Setup Guide

Use this guide when you need OpenClaw inside a Feishu or Lark team environment. Compared with Telegram, the Feishu path depends more on app permissions, plugin compatibility, and connection mode choices, so the setup is less casual but more suitable for internal operations.

Why Feishu / Lark is different

  • You need an internal app, not just a bot token
  • Permissions and event subscriptions matter as much as runtime config
  • WebSocket mode is usually the easiest starting point before you move to webhook mode

Step 1: Create an internal app

  • Create an app in Feishu Open Platform and copy the App ID / App Secret
  • Enable bot permissions and message events

Step 2: Install the Feishu plugin

Command
openclaw plugins install @m1heng-clawd/feishu

Step 3: Configure WebSocket mode

Command
openclaw config set channels.feishu.appId "YOUR_APP_ID"openclaw config set channels.feishu.appSecret "YOUR_APP_SECRET"openclaw config set channels.feishu.enabled trueopenclaw config set channels.feishu.connectionMode websocket

Step 4: Restart the gateway

Command
openclaw gateway restart

Step 5: Test in chat

  • Add the bot to a group or DM
  • Send @bot what time is it?

Common Feishu / Lark issues

  • Personal account limitations -> use an org admin account
  • Plugin mismatch -> update OpenClaw or install manually
  • No events -> check permissions, keys, and WebSocket status
  • Runtime or relay issues -> compare /docs/troubleshooting and /docs/advanced-config

Webhook mode (public HTTPS required)

For event-subscription webhooks, continue with /docs/feishu-webhook-tunnel.

Related links