demerzels-lab/openclaw-starter-kit

OpenClaw Starter Kit 🦞

The definitive starting point for autonomous agents. Powered by AIsa.

One API key. All the data sources your agent needs.

🔥 What Can You Do?

Morning Briefing (Scheduled)

"Send me a daily briefing at 8am with:
- My portfolio performance (NVDA, TSLA, BTC)
- Twitter trends in AI
- Top news in my industry"

Competitor Intelligence

"Monitor @OpenAI - alert me on new tweets, news mentions, and paper releases"

Investment Research

"Full analysis on NVDA: price trends, insider trades, analyst estimates, 
SEC filings, and Twitter sentiment"

Startup Validation

"Research the market for AI writing tools - find competitors, 
Twitter discussions, and academic papers on the topic"

Crypto Whale Alerts

"Track large BTC movements and correlate with Twitter activity"

AIsa vs bird

| Feature | AIsa ⚡ | bird 🐦 | |---------|---------|---------| | Auth method | API Key (simple) | Browser cookies (complex) | | Read Twitter | ✅ | ✅ | | Post/Like/Retweet | ✅ (via login) | ✅ | | Web Search | ✅ | ❌ | | Scholar Search | ✅ | ❌ | | News/Financial | ✅ | ❌ | | LLM Routing | ✅ | ❌ | | Server-friendly | ✅ | ❌ | | Cost | Pay-per-use | Free |

Use AIsa when: Server environment, need search/scholar APIs, prefer simple API key setup. Use bird when: Local machine with browser, need free access, complex Twitter interactions.

Quick Start

export AISA_API_KEY="your-key"

Core Capabilities

Twitter/X Data (Read)

# Get user info
curl "https://api.aisa.one/apis/v1/twitter/user/info?userName=elonmusk" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Advanced tweet search
curl "https://api.aisa.one/apis/v1/twitter/tweet/advanced_search?query=AI+agents&queryType=Latest" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Get trending topics (worldwide)
curl "https://api.aisa.one/apis/v1/twitter/trends?woeid=1" \
  -H "Authorization: Bearer $AISA_API_KEY"

Twitter/X Post (Write)

⚠️ Warning: Posting requires account login. Use responsibly to avoid rate limits or account suspension.

# Step 1: Login first (async, check status after)
curl -X POST "https://api.aisa.one/apis/v1/twitter/user_login_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_name":"myaccount","email":"[email protected]","password":"xxx","proxy":"http://user:pass@ip:port"}'

# Step 2: Send tweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/send_tweet_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_name":"myaccount","text":"Hello from OpenClaw!"}'

# Like / Retweet
curl -X POST "https://api.aisa.one/apis/v1/twitter/like_tweet_v3" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"user_name":"myaccount","tweet_id":"1234567890"}'

Search (Web + Academic)

# Web search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/web?query=AI+frameworks&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Academic/scholar search
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/scholar?query=transformer+models&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

# Smart search (web + academic combined)
curl -X POST "https://api.aisa.one/apis/v1/scholar/search/smart?query=machine+learning&max_num_results=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

Financial News

# Company news by ticker
curl "https://api.aisa.one/apis/v1/financial/news?ticker=AAPL&limit=10" \
  -H "Authorization: Bearer $AISA_API_KEY"

LLM Routing (OpenAI Compatible)

curl -X POST "https://api.aisa.one/v1/chat/completions" \
  -H "Authorization: Bearer $AISA_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"model": "gpt-4", "messages": [{"role": "user", "content": "Hello"}]}'

Supported models: GPT-4, Claude-3, Gemini, Qwen, Deepseek, Grok, and more.

Python Client

# Twitter Read
python3 {baseDir}/scripts/aisa_client.py twitter user-info --username elonmusk
python3 {baseDir}/scripts/aisa_client.py twitter search --query "AI agents"
python3 {baseDir}/scripts/aisa_client.py twitter trends --woeid 1

# Twitter Write (requires login first)
python3 {baseDir}/scripts/aisa_client.py twitter login --username myaccount --email [email protected] --password xxx --proxy "http://user:pass@ip:port"
python3 {baseDir}/scripts/aisa_client.py twitter post --username myaccount --text "Hello!"
python3 {baseDir}/scripts/aisa_client.py twitter like --username myaccount --tweet-id 1234567890

# Search
python3 {baseDir}/scripts/aisa_client.py search web --query "latest AI news"
python3 {baseDir}/scripts/aisa_client.py search scholar --query "LLM research"
python3 {baseDir}/scripts/aisa_client.py search smart --query "machine learning"

# News
python3 {baseDir}/scripts/aisa_client.py news --ticker AAPL

# LLM
python3 {baseDir}/scripts/aisa_client.py llm complete --model gpt-4 --prompt "Explain quantum computing"

Pricing

| API | Cost | |-----|------| | Twitter query | ~$0.0004 | | Twitter post/like | ~$0.001 | | Web search | ~$0.001 | | Scholar search | ~$0.002 | | News | ~$0.001 | | LLM | Token-based |

Every response includes usage.cost and usage.credits_remaining.

Error Handling

Errors return JSON with error field:

{
  "error": "Invalid API key",
  "code": 401
}

Common error codes:

• 401 - Invalid or missing API key
• 402 - Insufficient credits
• 429 - Rate limit exceeded
• 500 - Server error

Get Started

1. Sign up at aisa.one
2. Get your API key
3. Add credits (pay-as-you-go)
4. Set environment variable: export AISA_API_KEY="your-key"

Full API Reference

See API Reference for complete endpoint documentation.