← Back to Skills Marketplace
liangzhipengdamon-maker

Feishu Setup Guide

by Damon Liang · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
94
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install feishu-setup
Description
Complete Feishu (飞书) integration setup guide for OpenClaw. Use when setting up a new OpenClaw instance with Feishu capabilities, configuring the openclaw-lar...
README (SKILL.md)

Feishu Setup Guide for OpenClaw

End-to-end guide to configure OpenClaw with full Feishu capabilities: IM, Calendar, Docs, Bitable, Contacts, Search, and OAuth.

Architecture Overview

Feishu Cloud ←→ Feishu Bot (Webhook/Event) ←→ openclaw-lark plugin ←→ OpenClaw Gateway
  • openclaw-lark (@larksuite/openclaw-lark): Official Feishu channel plugin. Provides all feishu_* tools, skills, and OAuth flow.
  • openclaw-extension-miaoda (@lark-apaas/openclaw-extension-miaoda): Optional. Miaoda platform integration.
  • openclaw-extension-miaoda-coding (@lark-apaas/openclaw-extension-miaoda-coding): Optional. Miaoda vibe-coding extension.

Setup Checklist

Phase 1: Create Feishu App (Open Platform)

  1. Go to Feishu Open Platform → Create App
  2. Fill in App Name, Description, Icon
  3. Note down credentials: App ID (cli_xxx) and App Secret
  4. Under "Security Settings", configure Encrypt Key and Verification Token (or let platform auto-generate)

Phase 2: Configure App Capabilities

Read references/feishu-app-config.md for detailed step-by-step instructions covering:

  • Permissions & Scopes (OAuth)
  • Event Subscriptions
  • Bot capabilities
  • Card interaction

Phase 3: Install openclaw-lark Plugin

# In OpenClaw project directory
npx openclaw plugin install @larksuite/openclaw-lark

# Optional Miaoda extensions
npx openclaw plugin install @lark-apaas/openclaw-extension-miaoda
npx openclaw plugin install @lark-apaas/openclaw-extension-miaoda-coding

Phase 4: Configure OpenClaw

Read references/openclaw-config-reference.md for the complete config template with all feishu-related sections.

Key config sections:

  • channels.feishu — Channel credentials and policies
  • plugins.entries.openclaw-lark — Plugin enablement
  • tools.alsoAllow — Enable feishu tools
  • tools.deny — Disable unwanted tools
  • skills.entries.feishu-task — Task skill toggle

Quick start config patch:

openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId '\x3CYOUR_APP_ID>'
openclaw config set channels.feishu.appSecret '\x3CYOUR_APP_SECRET>'
openclaw config set channels.feishu.domain 'feishu'
openclaw config set channels.feishu.requireMention true
openclaw config set channels.feishu.dmPolicy 'allowlist'
openclaw config set channels.feishu.allowFrom '\x3COWNER_OPEN_ID>'
openclaw config set plugins.entries.openclaw-lark.enabled true

Phase 5: Configure Webhook / Event Subscription

  • Event subscription URL: https://\x3CYOUR_HOST>/feishu/webhook (or as documented by openclaw-lark)
  • Subscribe to events listed in references/feishu-app-config.md

Phase 6: Restart and Verify

openclaw gateway restart
# Or in non-systemd env:
sh scripts/restart.sh

Verify:

  1. Bot appears in Feishu contacts
  2. Send a DM to bot — it should respond
  3. Check openclaw status for channel health

Tool Matrix

See references/tool-matrix.md for the complete mapping of feishu_* tools to capabilities, with enable/disable configuration.

Permission Scopes Reference

See references/permissions-reference.md for all OAuth scopes needed per feature area.

Troubleshooting

  • Bot not responding: Check webhook URL, event subscription, and openclaw status
  • OAuth failures: User needs to complete authorization flow; check scopes in Feishu Open Platform
  • Tool not found: Verify tool is in tools.alsoAllow and not in tools.deny
  • Permission denied on API call: Check Feishu app has the required scope enabled AND user has authorized

For deep diagnostics, read the feishu-troubleshooting skill if available.

Usage Guidance
This is a coherent, expected Feishu integration guide. Before proceeding: (1) only enable the specific OAuth scopes and feishu_* tools you need — many listed tools allow reading messages, files, contacts and are sensitive; (2) store appSecret in a secure secret provider (avoid committing secrets to plaintext config); (3) host the webhook endpoint on a TLS-protected, authenticated URL and validate Feishu verification tokens/encrypt keys; (4) vet the npm plugin packages you install (namespaced @larksuite/@lark-apaas are expected, but confirm package provenance and check package versions/lockfiles); (5) test with a restricted availability scope or test account before publishing to all users. If you want, provide the actual plugin package versions or your intended scope list and I can point out which permissions/tools are most risky and suggest a minimal safe configuration.
Capability Analysis
Type: OpenClaw Skill Name: feishu-setup Version: 1.0.0 The feishu-setup skill bundle is a comprehensive documentation and configuration guide for integrating OpenClaw with the Feishu (Lark) platform. It contains standard setup instructions, configuration templates (openclaw-config-reference.md), and permission mappings (permissions-reference.md) required for legitimate API access. The included shell commands in SKILL.md are limited to official plugin installation and configuration via the openclaw CLI, with no evidence of malicious intent, data exfiltration, or unauthorized execution.
Capability Tags
requires-oauth-token
Capability Assessment
✓ Purpose & Capability
The skill's name/description (Feishu setup) matches the contents: step-by-step app creation, permissions, plugin installation (openclaw-lark), OpenClaw config, webhooks, and troubleshooting. Required items (appId/appSecret, webhook URL, plugin) are appropriate for this purpose.
ℹ Instruction Scope
Instructions are focused on setup and verification. They reference storing app secrets in OpenClaw config or a secret provider (file path), installing the plugin via npx, configuring tools/scopes, and verifying webhooks. Note: the guide explicitly covers enabling tools that grant access to messages, files, contacts and other sensitive data — which is expected for full integration but is sensitive and should be enabled only as needed.
✓ Install Mechanism
This is an instruction-only skill (no install spec). It suggests using 'npx openclaw plugin install' to fetch packages from npm (namespaced @larksuite/@lark-apaas), which is consistent with installing OpenClaw plugins and not unusual. No downloads from untrusted hosts or extracted archives are present in the bundle.
ℹ Credentials
The skill does not declare required env vars and does not ask for unrelated credentials. It does instruct the user to provide Feishu App ID/Secret and optionally use a file-based secret provider (path access) — this is proportional to the task. However, the recommended tool set includes highly sensitive capabilities (reading chat history, downloading attachments, searching across chats, accessing contacts/docs/calendar). Enabling the full tool list grants broad access to user data and should be limited to only the necessary scopes/users.
✓ Persistence & Privilege
always is false and the skill is user-invocable. There is no install script writing files in the skill bundle. The guide asks operators to configure OpenClaw and secret providers themselves; it does not request permanent platform privileges or modify other skills' configs automatically.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install feishu-setup
  3. After installation, invoke the skill by name or use /feishu-setup
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Complete Feishu integration setup guide for OpenClaw
Metadata
Slug feishu-setup
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Feishu Setup Guide?

Complete Feishu (飞书) integration setup guide for OpenClaw. Use when setting up a new OpenClaw instance with Feishu capabilities, configuring the openclaw-lar... It is an AI Agent Skill for Claude Code / OpenClaw, with 94 downloads so far.

How do I install Feishu Setup Guide?

Run "/install feishu-setup" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Feishu Setup Guide free?

Yes, Feishu Setup Guide is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Feishu Setup Guide support?

Feishu Setup Guide is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Feishu Setup Guide?

It is built and maintained by Damon Liang (@liangzhipengdamon-maker); the current version is v1.0.0.

More Skills
self-improving agent
Captures learnings, errors, and corrections to enable continuous improvement. Use when: (1) A command or operation fails unexpectedly, (2) User corrects Clau...
⬇ 463283 · by pskoett
Skill Vetter
Security-first skill vetting for AI agents. Use before installing any skill from ClawdHub, GitHub, or other sources. Checks for red flags, permission scope, and suspicious patterns.
⬇ 259410 · by spclaudehome
Polymarket
Query Polymarket prediction markets. Check odds, find trending markets, search events, track price movements.
⬇ 232503 · by joelchance
Self-Improving + Proactive Agent
Self-reflection + Self-criticism + Self-learning + Self-organizing memory. Agent evaluates its own work, catches mistakes, and improves permanently. Use when...
⬇ 200423 · by ivangdavila
Github
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
⬇ 191113 · by steipete
ontology
Typed knowledge graph for structured agent memory and composable skills. Use when creating/querying entities (Person, Project, Task, Event, Document), linkin...
⬇ 190156 · by oswalpalash

💬 Comments