Skill: boyd4y/feishu-agent (version 1.0.14)

--- name: feishu-agent description: Feishu (Lark) CLI agent - Provides calendar, todo, and contact management capabilities for AI assistants version: 1.0.14 metadata: openclaw: requires: bins: - bun --- # Feishu Agent Skill **Feishu (Lark) CLI agent** - Provides calendar, todo, and contact management capabilities for AI assistants. ## Installation ```bash # 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: ```bash feishu-agent setup ``` 2. **Authenticate** - OAuth 2.0 authorization: ```bash feishu-agent auth ``` 3. **Start using** - Check your calendar: ```bash 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 | Command | Description | |---------|-------------| | `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 | Command | Description | |---------|-------------| | `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 | Command | Description | |---------|-------------| | `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) ```bash 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 ```bash # 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`: ```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 ```bash 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 ```bash feishu-agent calendar events ``` ### Manage Tasks ```bash 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


Security scan verdicts — ClawScan: clean | static analysis: clean | VirusTotal: clean | SkillSpector: clean (LOW)