← 返回 Skills 市场

Feishu Setup Guide

Name: Feishu Setup Guide
Author: liangzhipengdamon-maker

作者 Damon Liang · GitHub ↗ · v1.0.0 · MIT-0

cross-platform ✓ 安全检测通过

总下载

当前安装

版本数

在 OpenClaw 中安装

/install feishu-setup

功能描述

Complete Feishu (飞书) integration setup guide for OpenClaw. Use when setting up a new OpenClaw instance with Feishu capabilities, configuring the openclaw-lar...

使用说明 (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)

Go to Feishu Open Platform → Create App
Fill in App Name, Description, Icon
Note down credentials: App ID (cli_xxx) and App Secret
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:

Bot appears in Feishu contacts
Send a DM to bot — it should respond
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.

安全使用建议

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.

功能分析

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.

能力标签

requires-oauth-token

能力评估

✓ 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.

如何使用

确保已安装 OpenClaw（本地或 Docker 部署）
在对话框中输入安装命令：/install feishu-setup
安装完成后，直接呼叫该 Skill 的名称或使用 /feishu-setup 触发
根据 Skill 的参数说明提供必要输入，即可获得结构化输出

版本历史

v1.0.0

Complete Feishu integration setup guide for OpenClaw

元数据

Slug feishu-setup

版本 1.0.0

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 1

常见问题