firefly

What This Skill Does

The firefly skill is a powerful integration for OpenClaw that connects directly to the Fireflies.ai GraphQL API. It enables users to interact with their meeting intelligence ecosystem directly from their terminal or AI agent environment. The skill facilitates fetching, searching, and managing meeting transcripts, automated summaries, and action items. By centralizing this information, it eliminates the need to switch contexts between your workspace and the Fireflies web dashboard, allowing for seamless integration of meeting data into your technical workflows.

Installation

To integrate this skill into your environment, use the OpenClaw command-line interface. Run the following command in your terminal:

clawhub install openclaw/skills/skills/codes71/firefly

Ensure you have a valid FIREFLY_API_KEY obtained from your Fireflies.ai account settings. This key must be configured in your gateway environment variables to allow the script to authenticate with the GraphQL API at https://api.fireflies.ai/graphql.

Use Cases

This skill is designed for professionals and teams who spend significant time in video conferences and require efficient retrieval of meeting outcomes. Ideal use cases include:

• Quickly retrieving action items from a stand-up meeting without opening the browser.
• Searching past recordings for specific technical decisions or architectural discussions.
• Extracting full transcripts for documentation or audit purposes.
• Summarizing lengthy discovery calls to share key takeaways with stakeholders.

Example Prompts

1. "List the last 5 meetings I had and give me the summary for the one about the API migration."
2. "Search my recent transcripts for any mentions of 'security vulnerability' or 'audit' from last week."
3. "Pull the action items from my 1-on-1 meeting today and add them to my to-do list file."

Tips & Limitations

When handling full transcripts, keep in mind that these documents can be extremely lengthy, often exceeding 2,000 sentences. The skill includes a smart-handling feature: rather than dumping the entire file to your terminal, it generates a preview of the first 50 lines. Use the search command to find specific topics before requesting full exports. Always ensure your environment variables are secured, as the API key grants access to your complete meeting history. For advanced users, refer to references/api.md to construct custom GraphQL queries if the native CLI commands do not cover your specific data needs.