{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/feishu-agent",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=feishu-agent",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-23T16:43:11.935Z",
      "expiresAt": "2026-04-30T16:43:11.935Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard",
        "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/feishu-agent",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "Feishu Agent Skill",
        "body": "Feishu (Lark) CLI agent - Provides calendar, todo, and contact management capabilities for AI assistants."
      },
      {
        "title": "Installation",
        "body": "# Install via clawhub\nclawhub install feishu-agent\n\n# Or run directly with bunx\nbunx @teamclaw/feishu-agent <command>\n\n# Or install globally via bun\nbun add -g @teamclaw/feishu-agent\nfeishu-agent <command>"
      },
      {
        "title": "Quick Start",
        "body": "Setup - Configure Feishu app credentials:\nfeishu-agent setup\n\n\n\nAuthenticate - OAuth 2.0 authorization:\nfeishu-agent auth\n\n\n\nStart using - Check your calendar:\nfeishu-agent calendar events"
      },
      {
        "title": "Capabilities",
        "body": "📅 Calendar: List calendars, view events, create/delete events with automatic conflict detection\n✅ Todo: Manage tasks via Feishu Bitable\n👥 Contacts: Search and list users from organization\n🔐 Auth: OAuth 2.0 authentication with automatic token refresh"
      },
      {
        "title": "Setup & Auth",
        "body": "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"
      },
      {
        "title": "Calendar Management",
        "body": "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"
      },
      {
        "title": "Other Features",
        "body": "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"
      },
      {
        "title": "Option 1: Interactive Setup (Recommended)",
        "body": "feishu-agent setup\n\nThis wizard will:\n\nPrompt for App ID and App Secret\nOpen browser for OAuth 2.0 authorization\nSave tokens to ~/.feishu-agent/config.json\nOptionally fetch Bitable schema"
      },
      {
        "title": "Option 2: Manual Configuration",
        "body": "# Step 1: Set app credentials\nfeishu-agent config set appId cli_xxxxx\nfeishu-agent config set appSecret xxxxx\n\n# Step 2: Authorize with user account\nfeishu-agent auth"
      },
      {
        "title": "Configuration",
        "body": "Global config is stored in ~/.feishu-agent/config.json:\n\n{\n  \"appId\": \"cli_xxxxx\",\n  \"appSecret\": \"xxxxx\",\n  \"userAccessToken\": \"xxxxx\",\n  \"refreshToken\": \"xxxxx\"\n}"
      },
      {
        "title": "Required Feishu App Permissions",
        "body": "In Feishu Developer Console, enable:\n\ncalendar:calendar - View and manage user calendars\ncalendar:event - Manage events in calendars\ncontact:user.base:readonly - Read user contact info\nbitable:app - Access Bitable data (for todo feature)\n\nRedirect URI must be configured: http://localhost:3000/callback"
      },
      {
        "title": "Schedule a Meeting",
        "body": "feishu-agent calendar create \\\n  --summary \"Team Standup\" \\\n  --start \"2026-03-05 10:00\" \\\n  --end \"2026-03-05 10:30\" \\\n  --attendee user_id_1 \\\n  --attendee user_id_2\n\nNote: 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."
      },
      {
        "title": "Check Daily Schedule",
        "body": "feishu-agent calendar events"
      },
      {
        "title": "Manage Tasks",
        "body": "feishu-agent todo create --title \"Review PR #123\" --priority \"High\"\nfeishu-agent todo list\nfeishu-agent todo done --record-id rec_xxx"
      },
      {
        "title": "Troubleshooting",
        "body": "\"User authorization required\"\n\nRun feishu-agent auth to authorize\n\n\"Token expired\"\n\nRun feishu-agent auth again to refresh\n\n\"Time conflict detected\"\n\nThe requested time slot is already busy\nChoose a different time or check your calendar with feishu-agent calendar events\n\n\"Permission denied\"\n\nCheck app permissions in Feishu Developer Console"
      },
      {
        "title": "License",
        "body": "MIT"
      }
    ],
    "body": "Feishu Agent Skill\n\nFeishu (Lark) CLI agent - Provides calendar, todo, and contact management capabilities for AI assistants.\n\nInstallation\n# Install via clawhub\nclawhub install feishu-agent\n\n# Or run directly with bunx\nbunx @teamclaw/feishu-agent <command>\n\n# Or install globally via bun\nbun add -g @teamclaw/feishu-agent\nfeishu-agent <command>\n\nQuick Start\n\nSetup - Configure Feishu app credentials:\n\nfeishu-agent setup\n\n\nAuthenticate - OAuth 2.0 authorization:\n\nfeishu-agent auth\n\n\nStart using - Check your calendar:\n\nfeishu-agent calendar events\n\nCapabilities\n📅 Calendar: List calendars, view events, create/delete events with automatic conflict detection\n✅ Todo: Manage tasks via Feishu Bitable\n👥 Contacts: Search and list users from organization\n🔐 Auth: OAuth 2.0 authentication with automatic token refresh\nCommands\nSetup & Auth\nCommand\tDescription\nfeishu-agent setup\tInteractive setup wizard (App credentials + OAuth + Bitable)\nfeishu-agent auth\tOAuth 2.0 authorization to get user_access_token\nfeishu-agent whoami\tShow current user and authorization status\nfeishu-agent config list\tView global configuration\nCalendar Management\nCommand\tDescription\nfeishu-agent calendar\tList all calendars (primary, subscribed)\nfeishu-agent calendar events\tList events in primary calendar\nfeishu-agent calendar create --summary \"Meeting\" --start \"2026-03-05 14:00\" --end \"2026-03-05 15:00\"\tCreate a new event (auto-checks conflicts)\nfeishu-agent calendar create --summary \"Meeting\" --start \"...\" --end \"...\" --attendee user_id\tCreate event with attendees\nfeishu-agent calendar delete --event-id=evt123\tDelete an event\nOther Features\nCommand\tDescription\nfeishu-agent todo list\tList todos from Bitable\nfeishu-agent todo create --title \"Task\" --priority \"High\"\tCreate a todo\nfeishu-agent todo done --record-id=rec123\tMark todo as done\nfeishu-agent contact list\tList users in department\nfeishu-agent contact search \"John\"\tSearch users by name/email\nSetup Flow\nOption 1: Interactive Setup (Recommended)\nfeishu-agent setup\n\n\nThis wizard will:\n\nPrompt for App ID and App Secret\nOpen browser for OAuth 2.0 authorization\nSave tokens to ~/.feishu-agent/config.json\nOptionally fetch Bitable schema\nOption 2: Manual Configuration\n# Step 1: Set app credentials\nfeishu-agent config set appId cli_xxxxx\nfeishu-agent config set appSecret xxxxx\n\n# Step 2: Authorize with user account\nfeishu-agent auth\n\nConfiguration\n\nGlobal config is stored in ~/.feishu-agent/config.json:\n\n{\n  \"appId\": \"cli_xxxxx\",\n  \"appSecret\": \"xxxxx\",\n  \"userAccessToken\": \"xxxxx\",\n  \"refreshToken\": \"xxxxx\"\n}\n\nRequired Feishu App Permissions\n\nIn Feishu Developer Console, enable:\n\ncalendar:calendar - View and manage user calendars\ncalendar:event - Manage events in calendars\ncontact:user.base:readonly - Read user contact info\nbitable:app - Access Bitable data (for todo feature)\n\nRedirect URI must be configured: http://localhost:3000/callback\n\nUse Cases for AI Agents\nSchedule a Meeting\nfeishu-agent calendar create \\\n  --summary \"Team Standup\" \\\n  --start \"2026-03-05 10:00\" \\\n  --end \"2026-03-05 10:30\" \\\n  --attendee user_id_1 \\\n  --attendee user_id_2\n\n\nNote: 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.\n\nCheck Daily Schedule\nfeishu-agent calendar events\n\nManage Tasks\nfeishu-agent todo create --title \"Review PR #123\" --priority \"High\"\nfeishu-agent todo list\nfeishu-agent todo done --record-id rec_xxx\n\nTroubleshooting\n\n\"User authorization required\"\n\nRun feishu-agent auth to authorize\n\n\"Token expired\"\n\nRun feishu-agent auth again to refresh\n\n\"Time conflict detected\"\n\nThe requested time slot is already busy\nChoose a different time or check your calendar with feishu-agent calendar events\n\n\"Permission denied\"\n\nCheck app permissions in Feishu Developer Console\nLicense\n\nMIT"
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/boyd4y/feishu-agent",
    "publisherUrl": "https://clawhub.ai/boyd4y/feishu-agent",
    "owner": "boyd4y",
    "version": "1.0.14",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}