Feishu Agent — Feishu 代理

Feishu 代理 技能

Feishu (Lark) 命令行工具 代理 - Provides calendar, todo, and contact management capabilities for AI 助手s.

安装ation # 安装 via ClawHub ClawHub 安装 feishu-代理

# Or 运行 directly with bunx bunx @teamclaw/feishu-代理

# Or 安装 globally via bun bun 添加 -g @teamclaw/feishu-代理 feishu-代理

Quick 启动

设置up - 配置 Feishu 应用 凭证s:

feishu-代理 设置up

认证 - OAuth 2.0 authorization:

feishu-代理 auth

启动 using - 检查 your calendar:

feishu-代理 calendar 事件

Capabilities 📅 Calendar: 列出 calendars, view 事件, 创建/删除 事件 with automatic conflict 检测ion ✅ Todo: Manage tasks via Feishu Bitable 👥 Contacts: 搜索 and 列出 users from organization 🔐 Auth: OAuth 2.0 authentication with automatic 令牌 refresh Commands 设置up & Auth Command Description feishu-代理 设置up Interactive 设置up wizard (应用 凭证s + OAuth + Bitable) feishu-代理 auth OAuth 2.0 authorization to 获取 user_访问_令牌 feishu-代理 whoami Show current user and authorization 状态 feishu-代理 config 列出 View global configuration Calendar Management Command Description feishu-代理 calendar 列出 all calendars (primary, subscribed) feishu-代理 calendar 事件 列出 事件 in primary calendar feishu-代理 calendar 创建 --summary "Meeting" --启动 "2026-03-05 14:00" --end "2026-03-05 15:00" 创建 a new event (auto-检查s conflicts) feishu-代理 calendar 创建 --summary "Meeting" --启动 "..." --end "..." --attendee user_id 创建 event with attendees feishu-代理 calendar 删除 --event-id=evt123 删除 an event Other Features Command Description feishu-代理 todo 列出 列出 todos from Bitable feishu-代理 todo 创建 --title "Task" --priority "High" 创建 a todo feishu-代理 todo done --record-id=rec123 Mark todo as done feishu-代理 contact 列出 列出 users in department feishu-代理 contact 搜索 "John" 搜索 users by name/emAIl 设置up Flow Option 1: Interactive 设置up (Recommended) feishu-代理 设置up

This wizard will:

Prompt for 应用 ID and 应用 Secret Open browser for OAuth 2.0 authorization Save 令牌s to ~/.feishu-代理/config.json Optionally fetch Bitable 模式 Option 2: Manual Configuration # Step 1: 设置 应用 凭证s feishu-代理 config 设置 应用Id 命令行工具_xxxxx feishu-代理 config 设置 应用Secret xxxxx

# Step 2: 授权 with user account feishu-代理 auth

Configuration

Global config is stored in ~/.feishu-代理/config.json:

{ "应用Id": "命令行工具_xxxxx", "应用Secret": "xxxxx", "user访问令牌": "xxxxx", "refresh令牌": "xxxxx" }

Required Feishu 应用 权限s

In Feishu Developer Console, enable:

calendar:calendar - View and manage user calendars calendar:event - Manage 事件 in calendars contact:user.base:readonly - Read user contact 信息 bitable:应用 - 访问 Bitable data (for todo feature)

Redirect URI must be 配置d: http://localhost:3000/callback

Use Cases for AI 代理s Schedule a Meeting feishu-代理 calendar 创建 \ --summary "Team Standup" \ --启动 "2026-03-05 10:00" \ --end "2026-03-05 10:30" \ --attendee user_id_1 \ --attendee user_id_2

Note: The command automatically 检查s for time conflicts using the FreeBusy API. If a conflict is 检测ed, the event creation will fAIl with a description of the busy time slot.

检查 DAIly Schedule feishu-代理 calendar 事件

Manage Tasks feishu-代理 todo 创建 --title "Review PR #123" --priority "High" feishu-代理 todo 列出 feishu-代理 todo done --record-id rec_xxx

Troubleshooting

"User authorization required"

运行 feishu-代理 auth to 授权

"令牌 expired"

运行 feishu-代理 auth agAIn to refresh

"Time conflict 检测ed"

The 请求ed time slot is already busy Choose a different time or 检查 your calendar with feishu-代理 calendar 事件

"权限 denied"

检查 应用 权限s in Feishu Developer Console License

MIT