Airweave
by @lennertjansen
Context retrieval layer for AI agents across users' applications. Search and retrieve context from Airweave collections. Airweave indexes and syncs data from user applications to enable optimal context retrieval by AI agents. Supports semantic, keyword, and agentic search. Use when users ask about their data in connected apps (Slack, GitHub, Notion, Jira, Confluence, Google Drive, Salesforce, Linear, SharePoint, Stripe, etc.), need to find documents or information from their workspace, want answ
clawhub install airweaveπ About This Skill
name: airweave description: Context retrieval layer for AI agents across users' applications. Search and retrieve context from Airweave collections. Airweave indexes and syncs data from user applications to enable optimal context retrieval by AI agents. Supports semantic, keyword, and agentic search. Use when users ask about their data in connected apps (Slack, GitHub, Notion, Jira, Confluence, Google Drive, Salesforce, Linear, SharePoint, Stripe, etc.), need to find documents or information from their workspace, want answers based on their company data, or need you to check app data for context to complete a task. metadata: {"clawdbot":{"requires":{"bins":["python3"],"env":["AIRWEAVE_API_KEY","AIRWEAVE_COLLECTION_ID"]},"primaryEnv":"AIRWEAVE_API_KEY"}}
Airweave Search
Search and retrieve context from Airweave collections using the search script at {baseDir}/scripts/search.py.
When to Search
Search when the user:
Don't search when:
Query Formulation
Turn user intent into effective search queries:
| User Says | Search Query | |-----------|--------------| | "What did Sarah say about the launch?" | "Sarah product launch" | | "Find the API documentation" | "API documentation" | | "Any bugs reported this week?" | "bug report issues" | | "What's our refund policy?" | "refund policy customer" |
Tips:
Running a Search
Execute the search script:
python3 {baseDir}/scripts/search.py "your search query"
Optional parameters:
--limit N β Max results (default: 20)--temporal N β Temporal relevance 0-1 (default: 0, use 0.7+ for "recent", "latest")--strategy TYPE β Retrieval strategy: hybrid, semantic, keyword (default: hybrid)--raw β Return raw results instead of AI-generated answer--expand β Enable query expansion for broader results--rerank / --no-rerank β Toggle LLM reranking (default: on)Examples:
# Basic search
python3 {baseDir}/scripts/search.py "customer feedback pricing"Recent conversations
python3 {baseDir}/scripts/search.py "product launch updates" --temporal 0.8Find specific document
python3 {baseDir}/scripts/search.py "API authentication docs" --strategy keywordGet raw results for exploration
python3 {baseDir}/scripts/search.py "project status" --limit 30 --rawBroad search with query expansion
python3 {baseDir}/scripts/search.py "onboarding" --expand
Handling Results
Interpreting scores:
Presenting to users: 1. Lead with the answer β don't start with "I found 5 results" 2. Cite sources β mention where info came from ("According to your Slack conversation...") 3. Synthesize β combine relevant parts into a coherent response 4. Acknowledge gaps β if results don't fully answer, say so
Handling No Results
If search returns nothing useful: 1. Broaden the query β remove specific terms 2. Try different phrasing β use synonyms 3. Increase limit β fetch more results 4. Ask for clarification β user might have more context
Parameter Reference
See PARAMETERS.md for detailed parameter guidance.
Examples
See EXAMPLES.md for complete search scenarios.
π‘ Examples
See EXAMPLES.md for complete search scenarios.