Add Feishu (飞书/Lark) as a channel. An agent skill from sugarforever/01coder-agent-skills.

MITAuto-check: notesProductivity & Automation

Install Add Feishu

skills CLI
$ npx skills add sugarforever/01coder-agent-skills --skill add-feishu -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sugarforever/01coder-agent-skills add-feishu --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sugarforever/01coder-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/add-feishu .claude/skills/add-feishu && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
add-feishu
GitHub stars
137
Token cost
~1.4k tokens
SKILL.md length
659 words
Files
5
Skills in repo
21
Repo updated
First seen
Licence
MIT

At a glance

Add Feishu (飞书/Lark) as a channel. An agent skill from sugarforever/01coder-agent-skills.

  • Works in 5 steps: Pre-flight → Apply Code Changes → Setup → …
  • Tasks that involve Messaging and chat bots
  • SKILL.md covers Phase 1: Pre-flight, Phase 2: Apply Code Changes, Phase 3: Setup and Phase 4: Registration, plus 3 more sections
  • Runs TypeScript scripts from its folder; calls npm, sqlite3 and npx; needs FEISHU_APP_SECRET

What it does

Add Feishu is an agent skill from sugarforever/01coder-agent-skills. Add Feishu (飞书/Lark) as a channel. Uses WebSocket long connection mode — no public URL needed. Bot responds to all messages (no trigger required).

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 9 other files (for example `add/src/channels/feishu.ts`, `manifest.yaml` and `modify/src/index.ts`).

It sits in Productivity & Automation, covering Messaging and chat bots. It works with Feishu (Lark). The licence is MIT.

When your agent uses it

  • Tasks that involve Messaging and chat bots

Example prompts

  • “/add-feishu”

Requirements

  • Node.js
  • A credential in FEISHU_APP_SECRET

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Pre-flight
  2. Apply Code Changes
  3. Setup
  4. Registration
  5. Verify

What it can do on your machine

Read from SKILL.md and the folder at commit e51fb6e. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships script files (TypeScript), which the agent can run.

    Shell commands in SKILL.md call:

    • npm
    • sqlite3
    • npx

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    Links to these hosts (documentation or services it may open):

    • open.feishu.cn

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names these keys or tokens, usually read from environment variables:

    • FEISHU_APP_SECRET

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Add Feishu loads about 1.4k tokens when it runs. Until then it costs about 39 tokens; SKILL.md has 659 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~39
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NoteMentions a .env fileSKILL.md:46
    - Updates `.env` with `FEISHU_APP_ID` and `FEISHU_APP_SECRET`
  • NoteMentions a .env fileSKILL.md:81
    Add to `.env`:
  • NoteMentions a .env fileSKILL.md:152
    _ID` and `FEISHU_APP_SECRET` are set in `.env`
  • NoteMentions a .env fileSKILL.md:181
    HU_APP_ID` and `FEISHU_APP_SECRET` from `.env`

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sugarforever/01coder-agent-skills at commit e51fb6e, republished under its MIT licence (© sugarforever). 659 words, ~1,434 tokens.

Download SKILL.mdSave it as .claude/skills/add-feishu/SKILL.md (or your agent's skills folder). This skill also uses 4 other files; get the full folder from GitHub.
name
add-feishu
description
Add Feishu (飞书/Lark) as a channel. Uses WebSocket long connection mode — no public URL needed. Bot responds to all messages (no trigger required).

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:

bash
npx tsx scripts/apply-skill.ts --init
Apply the skill
bash
npx tsx scripts/apply-skill.ts .claude/skills/add-feishu

This deterministically:

  • Adds src/channels/feishu.ts (FeishuChannel class implementing Channel interface)
  • Three-way merges Feishu support into src/index.ts (reads credentials via readEnvFile, creates FeishuChannel if configured)
  • Installs the @larksuiteoapi/node-sdk npm dependency
  • Updates .env with FEISHU_APP_ID and FEISHU_APP_SECRET
  • Records the application in .nanoclaw/state.yaml

If the apply reports merge conflicts, read the intent file:

  • modify/src/index.ts.intent.md — what changed and invariants for index.ts
Validate code changes
bash
npm run build

Build must be clean before proceeding.

Phase 3: Setup

Create Feishu App (if needed)

If the user doesn't have a Feishu app, tell them:

I need you to create a Feishu bot:

  1. Go to Feishu Open Platform and create a new app
  2. Under Credentials, copy the App ID and App Secret
  3. Under Event Subscriptions, enable Long Connection (WebSocket) mode
  4. Add the event: im.message.receive_v1 (Receive messages)
  5. Under Permissions, add:
    • im:message:send_as_bot (Send messages as bot)
    • im:message (Read messages)
  6. Publish the app (or create a version and approve it)

Wait for the user to provide the App ID and App Secret.

Configure environment

Add to .env:

bash
FEISHU_APP_ID=<their-app-id>
FEISHU_APP_SECRET=<their-app-secret>
Build and restart
bash
npm run build
launchctl kickstart -k gui/$(id -u)/com.nanoclaw  # macOS
# Linux: systemctl --user restart nanoclaw

Phase 4: Registration

Get Chat ID

Tell the user:

  1. Start the bot: npm run dev
  2. Send any message to the bot in Feishu (DM or group)
  3. Check the logs — the chat_id will appear in the metadata
  4. The JID format is {chat_id}@feishu

Or check the database directly:

bash
sqlite3 store/messages.db "SELECT jid FROM chats WHERE jid LIKE '%@feishu'"
Register the chat

Register directly in SQLite:

sql
INSERT INTO registered_groups (jid, name, folder, trigger_pattern, added_at, requires_trigger)
VALUES ('{chat_id}@feishu', 'feishu', 'feishu', '@{ASSISTANT_NAME}', datetime('now'), 0);

Note: requires_trigger is set to 0 (false) so the bot responds to all messages without needing @mention.

Then restart the service to pick up the new registration.

Phase 5: Verify

Show full SKILL.md (272 more words)Show less
Test the connection

Tell the user:

Send a message to the bot in Feishu. It should respond within a few seconds.

Check logs if needed
bash
tail -f logs/nanoclaw.log
# Or run interactively:
npm run dev

Look for:

  • Feishu bot info fetched — bot connected and identified itself
  • Connected to Feishu via WebSocket — WebSocket established
  • Feishu message sent — outbound message delivered

Troubleshooting

Bot not responding

Check:

  1. FEISHU_APP_ID and FEISHU_APP_SECRET are set in .env
  2. Chat is registered: sqlite3 store/messages.db "SELECT * FROM registered_groups WHERE jid LIKE '%@feishu'"
  3. App is published on Feishu Open Platform (draft apps don't receive events)
  4. Event subscription im.message.receive_v1 is enabled
  5. Long Connection (WebSocket) mode is enabled (not webhook)
  6. Service is running: launchctl list | grep nanoclaw (macOS) or systemctl --user status nanoclaw (Linux)
Bot connects but doesn't receive messages
  • Verify the app has im:message permission
  • Verify the event im.message.receive_v1 is subscribed
  • Check that the app version is published and approved
Bot receives but can't send
  • Verify the app has im:message:send_as_bot permission
  • For group chats: the bot must be added to the group first
"Failed to fetch Feishu bot info"

Non-critical warning. Bot message detection (filtering own messages) won't work, but message sending/receiving still functions. Usually means the bot API endpoint isn't accessible — check network connectivity.

Removal

To remove Feishu integration:

  1. Delete src/channels/feishu.ts
  2. Remove FeishuChannel import and creation block from src/index.ts
  3. Remove readEnvFile import if no other channel uses it
  4. Remove FEISHU_APP_ID and FEISHU_APP_SECRET from .env
  5. Remove Feishu registrations: sqlite3 store/messages.db "DELETE FROM registered_groups WHERE jid LIKE '%@feishu'"
  6. Uninstall: npm uninstall @larksuiteoapi/node-sdk
  7. Rebuild: npm run build && launchctl kickstart -k gui/$(id -u)/com.nanoclaw (macOS) or npm run build && systemctl --user restart nanoclaw (Linux)

© sugarforever, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 4 other files in skills/add-feishu of sugarforever/01coder-agent-skills.

  • SKILL.md
  • add/src/channels/feishu.ts
  • manifest.yaml
  • modify/src/index.ts
  • modify/src/index.ts.intent.md

Open the folder on GitHubat commit e51fb6e

Compare with similar skills

Add Feishu next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Add Feishu compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Add Feishu this skillsugarforever/01coder-agent-skills137—~1.4kAutomated safety check: NotesMIT
Feishu BridgeAlexAnys/feishu-openclaw3171 repos~615Automated safety check: PassNone
Lark Eventrongxinzy/RongxinAI1543 repos~2.7kAutomated safety check: PassAGPL-3.0
Lark Eventappleweiping/WEIPING_WIKI119—~1.9kAutomated safety check: PassMIT
Feishucodewhale-hq/Codewhale41k—~413Automated safety check: PassMIT
Feishu NotifyAI4Scientist/nano-scientist1284 repos~1.6kAutomated safety check: PassNone

Similar skills

  • Feishu Bridge

    AlexAnys/feishu-openclaw

    Connect a Feishu (Lark) bot to Clawdbot via WebSocket long-connection.

    317 GitHub starsUsed in 1 repo~615 tokens
    Productivity & AutomationAuto-check passed
  • Lark Event

    rongxinzy/RongxinAI

    Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via lark-cli event consume <EventKey (covers IM messages/reactions/chat changes, Approval status changes…

    154 GitHub starsUsed in 3 repos~2.7k tokens
    Productivity & AutomationAuto-check passed
  • Lark Event

    appleweiping/WEIPING_WIKI

    Lark/Feishu real-time event listening / subscribing / consuming: stream events as NDJSON via lark-cli event consume <EventKey (covers IM message receive, reactions, chat member changes, etc.).

    119 GitHub stars~1.9k tokensUpdated 1 mo ago
    Productivity & AutomationAuto-check passed
  • Feishu

    codewhale-hq/Codewhale

    Work with Feishu or Lark bots, docs, sheets, bitables, approval flows, and OpenAPI/MCP setup without hardcoding credentials.

    41k GitHub stars~413 tokensUpdated today
    Productivity & AutomationAuto-check passed
  • Feishu Notify

    AI4Scientist/nano-scientist

    Send notifications to Feishu/Lark. An agent skill from AI4Scientist/nano-scientist.

    128 GitHub starsUsed in 4 repos~1.6k tokens
    Productivity & AutomationAuto-check passed
  • Feishu Lark

    OpenClaudia/openclaudia-skills

    Send messages and interactive cards to Feishu (飞书) and Lark channels via webhooks or Bot API.

    713 GitHub stars~7.4k tokensUpdated 22 days ago
    Productivity & AutomationAuto-check: notes

More from sugarforever/01coder-agent-skills

All 21 skills in this repo
  • Typography Cover Designer

    sugarforever/01coder-agent-skills

    Designs typography-driven video covers and thumbnails in HTML/CSS and screenshots them with Chrome DevTools at 16:9, 16:10, 9:16 and 3:4.

    137 GitHub stars~3.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Mining Session Skills

    sugarforever/01coder-agent-skills

    Reviews one finished Claude Code session from its exported markdown and decides whether a skill is worth creating, updating or reusing for similar work.

    137 GitHub stars~1.4k tokensUpdated 3 mo ago
    Auto-check passed
  • Subtitle Correction

    sugarforever/01coder-agent-skills

    Fixes speech-recognition mistakes in .srt subtitle files, in Chinese or English, using terms you supply and leaving every timestamp untouched.

    137 GitHub stars~2.3k tokensUpdated 3 mo ago
    Auto-check passed
  • Claude Session Exporter

    sugarforever/01coder-agent-skills

    Lists Claude Code session transcripts and exports them to organized Markdown with a digest, a clean conversation and linked tool-call details.

    137 GitHub stars~1.7k tokensUpdated 3 mo ago
    Auto-check passed
  • Codex Session Manager

    sugarforever/01coder-agent-skills

    Lists, filters and exports local Codex session transcripts to organized Markdown with a digest, timeline and tool-call details, in full or pick-one mode.

    137 GitHub stars~1.2k tokensUpdated 3 mo ago
    Auto-check passed
  • Diagram to Image Converter

    sugarforever/01coder-agent-skills

    Converts Mermaid diagrams and markdown tables into PNG images through a hosted rendering API, for platforms without rich formatting.

    137 GitHub stars~1.9k tokensUpdated 3 mo ago
    Auto-check passed

Works with

Questions about Add Feishu

What does Add Feishu do?

Add Feishu (飞书/Lark) as a channel. An agent skill from sugarforever/01coder-agent-skills. Add Feishu is an agent skill from sugarforever/01coder-agent-skills. Add Feishu (飞书/Lark) as a channel.

When should I use Add Feishu?

Add Feishu fits situations like: tasks that involve Messaging and chat bots.

How do I install Add Feishu in Claude Code?

Run `npx skills add sugarforever/01coder-agent-skills --skill add-feishu -a claude-code`. Or copy the skill folder (skills/add-feishu in sugarforever/01coder-agent-skills) into .claude/skills/add-feishu in your project. Claude Code loads it when a task matches its description.

How do I install Add Feishu in Codex?

Run `npx skills add sugarforever/01coder-agent-skills --skill add-feishu -a codex`. Or copy the skill folder (skills/add-feishu in sugarforever/01coder-agent-skills) into .agents/skills/add-feishu in your project. Codex loads it when a task matches its description.

Can I use Add Feishu in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sugarforever/01coder-agent-skills --skill add-feishu -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/add-feishu, .gemini/skills/add-feishu, .github/skills/add-feishu and .opencode/skills/add-feishu in your project.

What does Add Feishu need to run?

Going by SKILL.md and its folder, Add Feishu needs TypeScript for the scripts in its folder, the command-line tools its instructions call (npm, sqlite3 and npx) and credentials named FEISHU_APP_SECRET. Our summary lists: Node.js; A credential in FEISHU_APP_SECRET.

Does Add Feishu access the network?

SKILL.md names 1 domain. As links in the text: open.feishu.cn. This is read from the text; nothing was executed.

Is Add Feishu safe to install?

Our automated static check of SKILL.md found notes only (mentions a .env file), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Add Feishu use?

Add Feishu is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Add Feishu use?

About 1.4k tokens (SKILL.md is roughly 5.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Add Feishu?

Skills that share tags, products or a category with Add Feishu: Feishu Bridge (AlexAnys/feishu-openclaw, 317 stars), Lark Event (rongxinzy/RongxinAI, 154 stars), Lark Event (appleweiping/WEIPING_WIKI, 119 stars) and Feishu (codewhale-hq/Codewhale, 41k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Add Feishu?

sugarforever (a GitHub user) maintains it in sugarforever/01coder-agent-skills, which has 137 GitHub stars. The repository holds 21 skills in this directory. The repository was last updated on June 19, 2026.

Source: sugarforever/01coder-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.