OpenSkillIndex← back to search
claude-codeopenclawproductivity

Skills feishu-agent

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

install
source · Clone the upstream repo
git clone https://github.com/openclaw/skills
Claude Code · Install into ~/.claude/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.claude/skills && cp -r "$T/skills/boyd4y/feishu-agent" ~/.claude/skills/openclaw-skills-feishu-agent && rm -rf "$T"
OpenClaw · Install into ~/.openclaw/skills/
T=$(mktemp -d) && git clone --depth=1 https://github.com/openclaw/skills "$T" && mkdir -p ~/.openclaw/skills && cp -r "$T/skills/boyd4y/feishu-agent" ~/.openclaw/skills/openclaw-skills-feishu-agent && rm -rf "$T"
manifest: skills/boyd4y/feishu-agent/SKILL.md
tags
#feishu#lark#calendar#todo#contact-management#cli
source content

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

CommandDescription
feishu-agent setup
Interactive setup wizard (App credentials + OAuth + Bitable)
feishu-agent auth
OAuth 2.0 authorization to get user_access_token
feishu-agent whoami
Show current user and authorization status
feishu-agent config list
View global configuration

Calendar Management

CommandDescription
feishu-agent calendar
List all calendars (primary, subscribed)
feishu-agent calendar events
List events in primary calendar
feishu-agent calendar create --summary "Meeting" --start "2026-03-05 14:00" --end "2026-03-05 15:00"
Create a new event (auto-checks conflicts)
feishu-agent calendar create --summary "Meeting" --start "..." --end "..." --attendee user_id
Create event with attendees
feishu-agent calendar delete --event-id=evt123
Delete an event

Other Features

CommandDescription
feishu-agent todo list
List todos from Bitable
feishu-agent todo create --title "Task" --priority "High"
Create a todo
feishu-agent todo done --record-id=rec123
Mark todo as done
feishu-agent contact list
List users in department
feishu-agent contact search "John"
Search users by name/email

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"
}

Required Feishu App Permissions

In Feishu Developer Console, enable:

  • calendar:calendar
    - View and manage user calendars
  • calendar:event
    - Manage events in calendars
  • contact:user.base:readonly
    - Read user contact info
  • bitable:app
    - Access Bitable data (for todo feature)

Redirect URI must be configured: 

http://localhost:3000/callback

Use Cases for AI Agents

Schedule a Meeting

feishu-agent calendar create \
  --summary "Team Standup" \
  --start "2026-03-05 10:00" \
  --end "2026-03-05 10:30" \
  --attendee user_id_1 \
  --attendee user_id_2

Note: The command automatically checks for time conflicts using the FreeBusy API. If a conflict is detected, the event creation will fail with a description of the busy time slot.

Check Daily Schedule

feishu-agent calendar events

Manage Tasks

feishu-agent todo create --title "Review PR #123" --priority "High"
feishu-agent todo list
feishu-agent todo done --record-id rec_xxx

Troubleshooting

"User authorization required"

  • Run 
    feishu-agent auth
    to authorize

"Token expired"

  • Run 
    feishu-agent auth
    again to refresh

"Time conflict detected"

  • The requested time slot is already busy
  • Choose a different time or check your calendar with 
    feishu-agent calendar events

"Permission denied"

  • Check app permissions in Feishu Developer Console

License

MIT