SeekerClaw embeds a Node.js AI agent inside an Android app, running 24/7 as a foreground service. You interact through Telegram — ask questions, control your phone, trade crypto, schedule tasks. 71 tools, 35+ skills, Solana wallet, multi-provider AI (Claude + OpenAI + OpenRouter + any OpenAI-compatible gateway), all running locally on your device. Built for the Solana Seeker, runs on any Android 14+ phone.

graph LR
    You["You (Telegram)"] -->|messages| Agent["SeekerClaw Agent"]
    Agent -->|reasoning| AI["AI Provider (Claude / OpenAI / OpenRouter / Custom)"]
    Agent -->|swaps, balance| Solana["Solana / Jupiter"]
    Agent -->|device access| Bridge["Android Bridge"]
    Agent -->|search, fetch| Web["Web APIs"]
    AI -->|tool calls| Agent

Android App (Kotlin, Jetpack Compose)
 └─ Foreground Service
     └─ Node.js Runtime (nodejs-mobile)
         ├─ ai.js             — AI provider API, system prompt, conversations
         ├─ message-handler.js — Inbound message routing, commands, auto-resume
         ├─ providers/        — Claude, OpenAI, OpenRouter, Custom adapters
         ├─ tools/            — 71 tool handlers across 12 modules
         ├─ http.js           — HTTP/HTTPS transport, SSE streaming
         ├─ task-store.js     — Persistent task checkpoints
         ├─ solana.js         — Jupiter swaps, DCA, limit orders
         ├─ telegram.js       — Bot, formatting, commands, repetition detector
         ├─ memory.js         — Persistent memory + ranked search
         ├─ skills.js         — Skill loading + semantic routing
         ├─ cron.js           — Job scheduling + natural language parsing
         ├─ mcp-client.js     — MCP Streamable HTTP client
         ├─ web.js            — Search providers + fetch + caching
         ├─ database.js       — SQL.js analytics
         ├─ security.js       — Prompt injection defense
         ├─ bridge.js         — Android Bridge HTTP client
         ├─ config.js         — Config loading + validation
         └─ main.js           — Orchestrator + heartbeat

Prerequisites: Android Studio, JDK 17, Android SDK 35

git clone https://github.com/sepivip/SeekerClaw.git
cd SeekerClaw
./gradlew assembleDappStoreDebug
adb install app/build/outputs/apk/dappStore/debug/app-dappStore-debug.apk

Open the app → pick your AI provider (Claude, OpenAI, or OpenRouter) → enter your API key + Telegram bot token + choose a model + name your agent — or generate a QR code at seekerclaw.xyz/setup and scan it. Done. For custom gateways (DeepSeek, Ollama, LiteLLM, etc.), configure in Settings after setup.

Step-by-step setup guide: How to set up SeekerClaw

Beta — SeekerClaw is under active development. Expect rough edges and breaking changes. Issues and PRs welcome.

Install via Telegram: send your agent the install link and it handles the rest.

Build your own: Skills are Markdown files with YAML frontmatter. See SKILL-FORMAT.md for the spec.

SeekerClaw gives an AI agent real capabilities on your phone — including wallet transactions, messaging, and device control. Please be aware:

• AI can make mistakes. Large language models hallucinate, misinterpret instructions, and occasionally take unintended actions. Always verify before trusting critical outputs.
• Prompt injection is a real risk. Malicious content from websites, messages, or files could manipulate the agent. SeekerClaw includes defenses, but no system is bulletproof.
• Wallet transactions are irreversible. Swaps, transfers, and DCA orders on Solana cannot be undone. The agent requires confirmation for financial actions — read the details before approving.
• Start with small amounts. Don't connect a wallet with significant funds until you're comfortable with how the agent behaves.
• You are responsible for your agent's actions. SeekerClaw is a tool, not financial advice. The developers are not liable for any losses.

TL;DR: Treat your agent like a capable but imperfect assistant. Verify important actions, secure your wallet, and don't trust it with more than you can afford to lose.

Thanks to all contributors:

Website: seekerclaw.xyz · Product Hunt: SeekerClaw · Twitter: @SeekerClaw · Telegram: t.me/seekerclaw