# Send Feishu Agent to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "feishu-agent",
    "name": "Feishu Agent",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/boyd4y/feishu-agent",
    "canonicalUrl": "https://clawhub.ai/boyd4y/feishu-agent",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/feishu-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "slug": "feishu-agent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-29T21:25:41.596Z",
      "expiresAt": "2026-05-06T21:25:41.596Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-agent",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-agent",
        "contentDisposition": "attachment; filename=\"feishu-agent-1.0.14.zip\"",
        "redirectLocation": null,
        "bodySnippet": null,
        "slug": "feishu-agent"
      },
      "scope": "item",
      "summary": "Item download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this item.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/feishu-agent"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/feishu-agent",
    "downloadUrl": "https://openagent3.xyz/downloads/feishu-agent",
    "agentUrl": "https://openagent3.xyz/skills/feishu-agent/agent",
    "manifestUrl": "https://openagent3.xyz/skills/feishu-agent/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/feishu-agent/agent.md"
  }
}
```
## Documentation

### 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

Setup - Configure Feishu app credentials:
feishu-agent setup



Authenticate - OAuth 2.0 authorization:
feishu-agent auth



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

### Setup & Auth

CommandDescriptionfeishu-agent setupInteractive setup wizard (App credentials + OAuth + Bitable)feishu-agent authOAuth 2.0 authorization to get user_access_tokenfeishu-agent whoamiShow current user and authorization statusfeishu-agent config listView global configuration

### Calendar Management

CommandDescriptionfeishu-agent calendarList all calendars (primary, subscribed)feishu-agent calendar eventsList events in primary calendarfeishu-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_idCreate event with attendeesfeishu-agent calendar delete --event-id=evt123Delete an event

### Other Features

CommandDescriptionfeishu-agent todo listList todos from Bitablefeishu-agent todo create --title "Task" --priority "High"Create a todofeishu-agent todo done --record-id=rec123Mark todo as donefeishu-agent contact listList users in departmentfeishu-agent contact search "John"Search users by name/email

### Option 1: Interactive Setup (Recommended)

feishu-agent setup

This wizard will:

Prompt for App ID and App Secret
Open browser for OAuth 2.0 authorization
Save tokens to ~/.feishu-agent/config.json
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

### 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
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: boyd4y
- Version: 1.0.14
## Source health
- Status: healthy
- Item download looks usable.
- Yavira can redirect you to the upstream package for this item.
- Health scope: item
- Reason: direct_download_ok
- Checked at: 2026-04-29T21:25:41.596Z
- Expires at: 2026-05-06T21:25:41.596Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/feishu-agent)
- [Send to Agent page](https://openagent3.xyz/skills/feishu-agent/agent)
- [JSON manifest](https://openagent3.xyz/skills/feishu-agent/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/feishu-agent/agent.md)
- [Download page](https://openagent3.xyz/downloads/feishu-agent)