add-feishu_skill

Overview

This skill adds Feishu (Lark) as a realtime channel to the agent using WebSocket long-connection mode so no public webhook URL is required. It installs a Feishu channel implementation, wires it into the app bootstrap, and provides interactive setup steps to create or register a Feishu bot. The bot responds to all incoming messages by default (no trigger required).

How this skill works

The skill applies deterministic code changes: it adds a FeishuChannel class, merges channel registration into the app entrypoint, and adds the @larksuiteoapi/node-sdk dependency. During setup you provide FEISHU_APP_ID and FEISHU_APP_SECRET, enable long-connection (WebSocket) event subscriptions, and publish the app. The running service connects via WebSocket, listens for im.message.receive_v1 events, and sends replies as the bot.

When to use it

• You want real-time Feishu (Lark) support without exposing a public webhook endpoint.
• You need the bot to reply to every message in DMs or groups (no trigger required).
• You prefer a deterministic, code-driven addition to an existing NanoClaw install.
• You are able to create/publish a Feishu app and manage environment variables and service restarts.

Best practices

• Create and publish a Feishu app before enabling events; draft apps often do not receive events.
• Enable Long Connection (WebSocket) and subscribe to im.message.receive_v1 and required permissions.
• Store FEISHU_APP_ID and FEISHU_APP_SECRET in .env and keep the file secure.
• Validate a clean npm run build before restarting the service to avoid runtime failures.
• Register chats in the database with requires_trigger = 0 to ensure the bot replies to all messages.

Example use cases

• Add a workspace assistant that auto-responds to user DMs and group queries in Feishu.
• Onboard the bot to a team and log all inbound messages into the local message store.
• Use WebSocket mode for environments behind NAT or without a stable public URL.
• Automate replies or integrations (notifications, searches) for Feishu users via the agent.