add-feishu
This skill integrates Feishu (Lark) messaging into NanoClaw through deterministic code changes and guided setup. It uses WebSocket long connection mode, so your bot responds to all messages without needing a public endpoint or trigger phrase.
Add Feishu enables WebSocket-based Feishu messaging integration for NanoClaw bots without requiring a public URL.
AI-generated summary based on this skill's SKILL.md
Install
sugarforever/01coder-agent-skills/add-feishu · repository language: Python
git clone https://github.com/sugarforever/01coder-agent-skills
cp -r 01coder-agent-skills/skills/add-feishu ~/.claude/skills/add-feishuFrequently asked questions
AI-generated answers based on this skill's SKILL.md and metadata
How do I add Feishu as a messaging channel to NanoClaw?
add-feishu integrates Feishu (Lark) messaging into NanoClaw through deterministic code changes and guided setup. The skill walks you through adding Feishu as a messaging channel by configuring your app credentials, enabling WebSocket long connection mode, and registering your chat groups in the database. Once set up, your NanoClaw bot will respond to all messages in registered Feishu chats without needing a public endpoint or trigger phrase.
What is feishu websocket long connection and how does it work?
add-feishu uses Feishu's WebSocket long connection mode instead of webhooks, which means your bot maintains a persistent connection to Feishu's servers. This approach eliminates the need for a public URL endpoint and allows your NanoClaw bot to receive and respond to all messages in real time from registered Feishu chats. The WebSocket connection handles message delivery directly without requiring trigger phrases or external routing.
How do I configure Feishu app credentials and WebSocket connection?
add-feishu guides you through obtaining your Feishu app ID and secret from the Feishu developer console, then configuring them in NanoClaw. The skill sets up the WebSocket long connection by establishing the im.message.receive event subscription with proper app permissions. Your credentials enable the bot to authenticate with Feishu's servers and maintain the persistent connection needed for real-time message handling.
How do I register Feishu chats and enable bot message responses?
add-feishu includes chat registration through an SQLite database where you store your Feishu group identifiers. Once registered, your NanoClaw bot automatically responds to all messages in those groups. The skill provides the setup steps for enabling the im.message event subscription and configuring message response behavior so your bot engages with every message in registered Feishu chats without additional configuration per message.
What should I do if my Feishu bot has connectivity or permission issues?
add-feishu includes troubleshooting guidance for common Feishu bot connectivity and permission problems. Check that your app ID and secret are correct, verify the im.message permission is enabled in your Feishu app settings, confirm your chat groups are properly registered in the database, and ensure your WebSocket connection is active. The skill helps you diagnose whether issues stem from credential misconfiguration, missing permissions, or connection state problems.
Why doesn't Feishu bot integration need a public URL or webhook?
add-feishu uses Feishu's WebSocket long connection mode, which is fundamentally different from webhook-based integrations. Your NanoClaw bot initiates an outbound connection to Feishu's servers and maintains it persistently, so Feishu pushes messages directly through that open connection. This eliminates the requirement for a publicly accessible endpoint, making setup simpler and more suitable for bots running in private networks or development environments.
SKILL.md
rendered from the published skill — quoted content, verbatim
Add Feishu Channel
This skill adds Feishu (飞书) support to NanoClaw using the skills engine for deterministic code changes, then walks through interactive setup.
Phase 1: Pre-flight
Check if already applied
Read .nanoclaw/state.yaml. If feishu is in applied_skills, skip to Phase 3 (Setup). The code changes are already in place.
Ask the user
Use AskUserQuestion to collect configuration:
AskUserQuestion: Do you have a Feishu app already, or do you need to create one?
If they have one, collect FEISHU_APP_ID and FEISHU_APP_SECRET now. If not, we'll create one in Phase 3.
Phase 2: Apply Code Changes
Run the skills engine to apply this skill's code package. The package files are in this directory alongside this SKILL.md.
Initialize skills system (if needed)
If .nanoclaw/ directory doesn't exist yet:
npx tsx scripts/apply-skill.ts --init
Apply the skill
npx tsx scripts/apply-skill.ts .claude/skills/add-feishu
This
(truncated - see the full file via the links below)
Read as markdown · JSON record · Browse the source repository
File tree — 5 files
skills/add-feishu/SKILL.md
skills/add-feishu/add/src/channels/feishu.ts
skills/add-feishu/manifest.yaml
skills/add-feishu/modify/src/index.ts
skills/add-feishu/modify/src/index.ts.intent.md