Feishu integration in the OpenClaw documentation has evolved from a “plugin mode” to being “built-in out of the box.” Therefore, you need to determine your current version’s state before deciding whether to install the plugin.
Figure: The header image of the official OpenClaw Feishu channel documentation page.
1. Determine if Your Environment Needs the Plugin
According to the official channel page, if you see a plugin not available prompt, you should then proceed with the plugin installation path.
First, run:
openclaw channels status --probeIf Feishu is available, you can proceed directly with onboarding; if it is not available, proceed with installing the plugin.
Figure: Feishu App creation page (official documentation screenshot).
Figure: Where to get Feishu App credentials (official documentation screenshot).
Figure: Feishu permissions configuration page (official documentation screenshot).
2. Plugin Installation Path for Older Versions/Minimal Builds
The official plugin command is:
openclaw plugins install @openclaw/feishuIf you are using a local source code environment, you can also install it to the local extensions directory.
It is recommended to restart the gateway after installation to ensure the plugin is fully loaded.
3. Integrating Feishu via the Wizard
The official recommended path is onboarding:
openclaw onboardThe wizard will guide you to:
- Create a Feishu App and prepare credentials.
- Write the Feishu configuration into OpenClaw.
- Start and verify the gateway.
4. Verify Channel Status
openclaw gateway statusopenclaw channels status --probeopenclaw logs --followPrimarily check the logs for records of Feishu event subscriptions and message processing.
5. Additional Risks of Plugins/Channels
- Mismatched plugin version and core version.
- Plugin failing to load after a gateway restart (common when deployment scripts miss steps).
- Trial and error directly in the production environment, causing abnormal message loops.
6. Security Recommendations
- Only install plugins from trusted sources.
- Configure minimum necessary permissions after installing a plugin; do not enable all action capabilities by default.
- For channels, use a whitelist/pairing strategy first before expanding the scope.
There are also official security notes regarding OpenClaw plugin installation (e.g., dependency installation strategies), which you should read before going live.
7. A More Stable Release Process
- Verify plugin installation locally.
- Debug message sending and receiving with a test tenant.
- Observe logs for 24 hours.
- Then go live with the official tenant.
Summary
Integrating Feishu is not difficult because of the steps, but because of “plugin lifecycle management.” As long as you solidify the four steps of installation, versioning, restarting, and log verification, the subsequent operation will be very stable.
Reference Links
- Feishu Channel Docs:
https://docs.openclaw.ai/channels/feishu - Plugin Docs:
https://docs.openclaw.ai/tools/plugin - Channels Overview:
https://docs.openclaw.ai/channels/index
Further Reading
If this article helped you, please share it with others!
Some information may be outdated