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. 56 tools, 35 skills, Solana wallet, multi-provider AI (Claude + OpenAI), all running locally on your device. Built for the Solana Seeker, runs on any Android 14+ phone.
| Feature | What it does | |
|---|---|---|
| 🤖 | AI Engine | Claude or OpenAI (multi-provider) with multi-turn tool use |
| 💬 | Telegram | Full bot — reactions, file sharing, inline keyboards, 12 commands |
| 🔗 | Solana Wallet | Swaps, limit orders, DCA, transfers via Jupiter + MWA |
| 📱 | Device Control | Battery, GPS, camera, SMS, calls, clipboard, TTS |
| 🧠 | Memory | Persistent personality, daily notes, ranked keyword search |
| ⏰ | Scheduling | Cron jobs with natural language ("remind me in 30 min") |
| 🌐 | Web Intel | Search (Brave / DuckDuckGo / Perplexity), fetch, caching |
| 🔌 | Extensible | 35 skills + custom skills + MCP remote tools |
Architecture
graph LR
You["You (Telegram)"] -->|messages| Agent["SeekerClaw Agent"]
Agent -->|reasoning| Claude["Claude API"]
Agent -->|swaps, balance| Solana["Solana / Jupiter"]
Agent -->|device access| Bridge["Android Bridge"]
Agent -->|search, fetch| Web["Web APIs"]
Claude -->|tool calls| Agent
On-device stack:
Android App (Kotlin, Jetpack Compose)
└─ Foreground Service
└─ Node.js Runtime (nodejs-mobile)
├─ claude.js — AI provider API, system prompt, conversations
├─ tools.js — 56 tool handlers + confirmations
├─ task-store.js — Persistent task checkpoints
├─ solana.js — Jupiter swaps, DCA, limit orders
├─ telegram.js — Bot, formatting, commands
├─ 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 + 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.apkOpen the app → pick your AI provider (Claude or OpenAI) → 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.
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.
| Skill | What it does | Install | |
|---|---|---|---|
| 🐾 | ClawPump | Launch tokens on Solana via pump.fun — gasless launches | Install |
| 🔮 | Dune Analytics | Query onchain data — DEX trades, token stats, wallet activity | Install |
| 🏠 | Home Assistant | Control smart home — lights, climate, vacuum, alarm, media | Install |
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 · Twitter: @SeekerClaw · Telegram: t.me/seekerclaw
Contributing · Security · Changelog · License