Felo AI Search

Use Felo AI for comprehensive, AI-summarized web search when you need:

• Multiple sources consolidated into structured insights
• Trending topics with context (community scanning)
• Research questions requiring cross-source synthesis

Do NOT use for:

• Time-sensitive queries requiring exact timestamps
• Single-source lookups (use web_fetch instead)
• When speed is critical (Felo takes ~15 seconds vs web_search ~1 second)

Authentication

API key location: ~/.config/felo/api_key

cat ~/.config/felo/api_key
# Returns: fk-Kfcl9cKqX18y3d93qAk06dK3f0dHowiycT6OqcSkMqfQjDal

Basic Usage

curl -s -X POST https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $(cat ~/.config/felo/api_key)" \
  -H "Content-Type: application/json" \
  -d '{"query": "Your search query here (1-2000 chars)"}' | jq .

Response Structure

{
  "status": "ok",
  "data": {
    "answer": "AI-generated summary...",
    "query_analysis": {
      "queries": ["optimized", "search", "terms"]
    },
    "resources": [
      {
        "link": "https://...",
        "title": "Source title",
        "snippet": "Relevant excerpt"
      }
    ]
  }
}

Key fields:

• data.answer — AI-synthesized answer (use for summaries)
• data.resources — Source links (typically 15-40 sources)

Common Patterns

Community Scanning (Cron Job)

# Query: Broad topic + time constraint + source diversity
curl -s -X POST https://openapi.felo.ai/v2/chat \
  -H "Authorization: Bearer $(cat ~/.config/felo/api_key)" \
  -H "Content-Type: application/json" \
  -d '{
    "query": "What are the top 5 trending topics in the OpenClaw AI agent community this week? Include specific discussions from Reddit, GitHub, X (Twitter), forums, and blogs. Provide source links."
  }' > /tmp/felo_result.json

# Extract structured output
ANSWER=$(jq -r '.data.answer' /tmp/felo_result.json)
SOURCES=$(jq -r '.data.resources[0:10] | .[] | "- [\(.title)](\(.link))"' /tmp/felo_result.json)
SOURCE_COUNT=$(jq '.data.resources | length' /tmp/felo_result.json)

Interactive Research

# For one-off queries
felo_query() {
  local query="$1"
  curl -s -X POST https://openapi.felo.ai/v2/chat \
    -H "Authorization: Bearer $(cat ~/.config/felo/api_key)" \
    -H "Content-Type: application/json" \
    -d "{\"query\": \"$query\"}" | jq -r '.data.answer'
}

felo_query "Compare memory-lancedb-pro vs mem0 for AI agent long-term memory"

Rate Limits

• Default: 100 requests/minute per API key
• Response headers: X-RateLimit-*
• Handle 429 errors with exponential backoff

Error Handling

Common errors:

• INVALID_API_KEY (401) — Check ~/.config/felo/api_key
• QUERY_TOO_LONG (400) — Max 2000 chars
• RATE_LIMIT_EXCEEDED (429) — Slow down requests

When to Use vs web_search