Feishu Agent Skill

Feishu (Lark) CLI agent - Provides calendar, todo, and contact management capabilities for AI assistants.

Installation

# Install via clawhub
clawhub install feishu-agent

# Or run directly with bunx
bunx @teamclaw/feishu-agent <command>

# Or install globally via bun
bun add -g @teamclaw/feishu-agent
feishu-agent <command>

Quick Start

1. Setup - Configure Feishu app credentials:

   feishu-agent setup
   

2. Authenticate - OAuth 2.0 authorization:

   feishu-agent auth
   

3. Start using - Check your calendar:

   feishu-agent calendar events
   

Capabilities

• 📅 Calendar: List calendars, view events, create/delete events with automatic conflict detection
• ✅ Todo: Manage tasks via Feishu Bitable
• 👥 Contacts: Search and list users from organization
• 🔐 Auth: OAuth 2.0 authentication with automatic token refresh

Commands

Setup & Auth

Calendar Management

Other Features

Setup Flow

Option 1: Interactive Setup (Recommended)

feishu-agent setup

This wizard will:

1. Prompt for App ID and App Secret
2. Open browser for OAuth 2.0 authorization
3. Save tokens to ~/.feishu-agent/config.json
4. Optionally fetch Bitable schema

Option 2: Manual Configuration

# Step 1: Set app credentials
feishu-agent config set appId cli_xxxxx
feishu-agent config set appSecret xxxxx

# Step 2: Authorize with user account
feishu-agent auth

Configuration

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

{
  "appId": "cli_xxxxx",
  "appSecret": "xxxxx",
  "userAccessToken": "xxxxx",
  "refreshToken": "xxxxx"
}