openclaw-feishu-webhook-setup

Diagnose Feishu connectivity issues and switch to webhook mode via cloudflared tunnel.

1|Updated Apr 13, 2026
One-click install
npx skills add https://github.com/tangzheng202202/hermes-skills --skill openclaw-feishu-webhook-setup
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: openclaw-feishu-webhook-setup
Source: https://github.com/tangzheng202202/hermes-skills/tree/main/01-coding-dev/openclaw-feishu-webhook-setup
Command: npx skills add https://github.com/tangzheng202202/hermes-skills --skill openclaw-feishu-webhook-setup

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires cloudflared, openclaw, and includes scripts (resource) components.

What problem does it solve?

Fixes Feishu integration when messages aren't received by the agent by diagnosing connectivity, switching to webhook mode, and subscribing to events.

Core Features & Use Cases

  • Webhook-based delivery: ensures Feishu messages reach the agent reliably by falling back from WebSocket when needed.
  • Public URL tunneling: creates a public URL using cloudflared for Feishu event delivery.
  • Config and restart: updates Feishu webhook URL, applies gateway changes, and restarts services to activate the workflow.
  • Use case: if Feishu messages stop arriving due to WebSocket limitations, run the fix to restore real-time messaging.

Quick Start

Run the openclaw-feishu-fix.sh script to establish a public URL tunnel and switch Feishu to webhook mode.

Frequently Asked Questions about openclaw-feishu-webhook-setup

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I fix Feishu messages not reaching my agent when WebSocket mode is unavailable?

To fix Feishu messages not reaching your agent when WebSocket mode is unavailable, you can switch to webhook mode by running a diagnostic script that establishes a public URL tunnel and updates your gateway configuration.

How do I set up a Feishu webhook URL using cloudflared tunneling?

To set up a Feishu webhook URL using cloudflared tunneling, run the openclaw-feishu-fix.sh script, which creates a public URL for Feishu event delivery, configures the webhook subscription, and restarts the gateway.

Does my Feishu event subscription require a public URL to receive messages in webhook mode?

Yes, Feishu event subscription in webhook mode requires a public URL tunnel. The Skill uses cloudflared to establish this public endpoint so that Feishu can reliably deliver event messages to your agent.

Why does my Feishu agent stop receiving messages after switching from WebSocket to webhook mode?

Your Feishu agent might stop receiving messages after switching to webhook mode if the gateway is not restarted or the event subscription is misconfigured. The Skill diagnoses these connectivity issues and restarts services to activate the workflow.

Can I use cloudflared to restore real-time Feishu messaging when event subscriptions are misconfigured?

Yes, you can use cloudflared to restore real-time Feishu messaging when event subscriptions are misconfigured. It creates a public URL tunnel for Feishu event delivery, allowing the webhook mode to function properly.