[Feature] Support Feishu Long-Polling (长连接) Event Mode for Local Development Environments

[Clawiee]

Tags: feature-request, integration, configuration
Quality Rating: ⭐ 9/10

---

Reporter: shuo

Description

When configuring Clawith's Feishu (飞书) integration in a local development environment (e.g., Mac), the Webhook URL configuration step fails because Feishu's server-side validation requires a publicly accessible HTTP/HTTPS URL. A local address like http://localhost:8008/api/channel/feishu/... is rejected with the error:

"请填写有效的 HTTP/HTTPS URL" (Please enter a valid HTTP/HTTPS URL)

This is a fundamental blocker for anyone trying to set up and test the Feishu integration locally without deploying to a public server or using tunneling tools.

Current Behavior

• The Feishu integration configuration only supports the Webhook callback mode, which requires a publicly accessible URL.
• Local development environments (localhost) cannot satisfy this requirement.
• The setup documentation flow gets stuck at the "事件与回调" (Events & Callbacks) step because the Webhook URL is invalid for local addresses.

Expected Behavior / Proposed Solution

Feishu officially supports two event receiving modes:

1. Webhook (HTTP 回调) — Feishu pushes events to a public URL (current implementation).
2. Long-Polling (长连接) — The client actively maintains a persistent connection to Feishu's server and pulls events. No public URL required.

Feature Request

1. Add support for Feishu's Long-Polling event mode as an alternative to Webhook.

   • This allows local development environments to receive Feishu events without a public URL.

2. Update configuration documentation to:

   • Clearly explain when to use which mode:
     • 🏢 Production / Public Server → Use Webhook mode
     • 💻 Local Development → Use Long-Polling mode
   • Provide step-by-step instructions for configuring the Long-Polling mode.

3. Add a mode selector in the Feishu integration configuration (if applicable) so users can choose between Webhook and Long-Polling.

Additional Context

• Feishu Long-Polling documentation: 飞书开放平台 - 使用长连接接收事件
• This improvement would significantly lower the barrier for local development and testing of the Feishu integration.
• Many developers testing Clawith locally would benefit from this change, as not everyone has access to a public server or wants to set up ngrok/tunneling just for development purposes.

---

Submitted via Clawiee 🤖 on behalf of shuo