SeekerClaw Turn your Solana Seeker (or any @codeKK javascriptOpen Source Website

SeekerClaw

Introduction: Turn your Solana Seeker (or any Android phone) into a 24/7 personal AI agent

Tags:

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.

	Feature	What it does
:robot:	AI Engine	Claude, OpenAI, OpenRouter, or any OpenAI-compatible gateway (Custom) with multi-turn tool use
:speech_balloon:	Telegram	Full bot — reactions, file sharing, inline keyboards, 12 commands
:link:	Solana Wallet	Swaps, limit orders, DCA, transfers via Jupiter + MWA
:iphone:	Device Control	Battery, GPS, camera, SMS, calls, clipboard, TTS
:brain:	Memory	Persistent personality, daily notes, ranked keyword search
:alarm_clock:	Scheduling	Cron jobs with natural language ("remind me in 30 min")
:globe_with_meridians:	Web Intel	Search (Brave / Perplexity / Exa / Tavily / Firecrawl), fetch, caching
:electric_plug:	Extensible	35 skills + custom skills + MCP remote tools

Architecture

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

On-device stack:

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

Quick Start

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.

Partner Skills

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

	Skill	What it does	Install
:ocean:	Byreal	Trade on Byreal DEX — pool analytics, swap quotes, LP positions, copy top farmers	Install
:rocket:	Career Companion	AI career coach — job search, resume tailoring, mock interviews, salary research	Install
:paw_prints:	ClawPump	Launch tokens on Solana via pump.fun — gasless launches	Install
:crystal_ball:	Dune Analytics	Query onchain data — DEX trades, token stats, wallet activity	Install
:house:	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.

Important Safety Notice

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.