x402agent/solanaos/public

Claude Code and agent skill by x402agent/solanaos

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Install

npx vskill@latest install x402agent/solanaos/public

SKILL.md

The same SKILL.md was published earlier as x402agent/solanaos/public.

SolanaOS — Agent Skill Sheet

Give this file to any AI agent (Claude, Codex, GPT-4, MiniMax, etc.) to fully install, configure, and run SolanaOS in one shot.

What You Are Installing

SolanaOS Companion — an autonomous Solana trading agent by SolanaOS Labs.

  • Single ~10MB Go binary (solanaos)
  • Runs a full OODA trading loop (RSI + EMA + ATR strategy)
  • Telegram bot with live strategy controls
  • Chrome extension with wallet + miner card
  • Bitaxe Gamma 602 Bitcoin miner integration
  • x402 payment protocol for monetized APIs
  • macOS menu bar app + persistent LaunchAgent daemon
  • Powered by a local-first Ollama harness (default: minimax-m2.7:cloud)

Prerequisites

The agent should verify these exist before proceeding:

  • go >= 1.21 (go version)
  • git (git --version)
  • curl (curl --version)
  • macOS (for LaunchAgent) or Linux (for systemd)
  • A .env file in the project root (see Step 2)

Step 1 — Clone the Repo

bash
git clone https://github.com/x402agent/SolanaOS solanaos
cd solanaos

Step 2 — Create .env

Create a .env file in the project root. Minimum required fields:

bash
# ── Required ──────────────────────────────────────────────────
HELIUS_API_KEY=your_helius_api_key # https://helius.dev
TELEGRAM_BOT_TOKEN=your_telegram_bot_token # https://t.me/BotFather
TELEGRAM_ID=your_telegram_user_id # your numeric Telegram user ID
# ── Wallet (auto-generated on first boot if omitted) ──────────
# SOLANA_PRIVATE_KEY=base58_encoded_keypair
# ── AI Model ──────────────────────────────────────────────────
LLM_PROVIDER=ollama
OLLAMA_MODEL=minimax-m2.7:cloud
# ── Optional: Native Claude backend ───────────────────────────
# ANTHROPIC_API_KEY=sk-ant-...
# ANTHROPIC_MODEL=claude-sonnet-4-6
# ── Optional: Grok tool/search path ───────────────────────────
# XAI_API_KEY=your_xai_key
# XAI_TOOL_MODEL=grok-4.20-beta-latest-non-reasoning
# ── Optional: Bitaxe Bitcoin miner ────────────────────────────
# BITAXE_HOST=192.168.1.XX
# BITAXE_ENABLED=true
# BITAXE_POLL_INTERVAL=10
# ── Optional: x402 payment paywall ────────────────────────────
# X402_PAYWALL_ENABLED=true
# X402_FACILITATOR_URL=https://facilitator.x402.rs
# ── Optional: Aster perpetuals ────────────────────────────────
# ASTER_API_KEY=your_aster_key
# ASTER_API_SECRET=your_aster_secret
# HYPERLIQUID_PRIVATE_KEY=0x...
# HYPERLIQUID_WALLET=0x...
# ── Optional: Remote gateway / Tailscale ──────────────────────
# OPENCLAW_GATEWAY_URL=ws://127.0.0.1:18789
# OPENCLAW_GATEWAY_TOKEN=your_token
# GATEWAY_TAILSCALE_MODE=serve
# ── Optional: Solana Agent Registry ──────────────────────────
# AGENT_REGISTRY_ENABLED=true
# AGENT_REGISTRY_CLUSTER=mainnet-beta

Step 3 — Build

bash
make build
# Output: build/solanaos

Or build manually:

bash
go build -o build/solanaos .

Step 4 — Onboard (First Run)

bash
./build/solanaos onboard

This generates the agent wallet, creates ~/.solanaos/config.json, and validates your API keys.


Step 5 — Run the Daemon

Option A: Foreground (development)
bash
./build/solanaos daemon
Option B: Persistent macOS LaunchAgent (recommended)
bash
# Install as a system service that survives reboots and crashes
bash scripts/install-service.sh
# Check status
bash scripts/install-service.sh --status
# View logs
tail -f ~/Library/Logs/solanaos/daemon.out.log
Option C: Docker
bash
docker build -t solanaos .
docker run -d --name solanaos --env-file .env solanaos
Option D: systemd (Linux)
bash
sudo cp build/solanaos /usr/local/bin/
sudo tee /etc/systemd/system/solanaos.service <<EOF
[Unit]
Description=SolanaOS Daemon
After=network.target
[Service]
EnvironmentFile=/path/to/.env
ExecStart=/usr/local/bin/solanaos daemon
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl enable --now solanaos

Step 6 — Verify

bash
# Check daemon health
curl http://127.0.0.1:7777/api/status
# Expected fields in response:
# { "status": "ok", "daemon": "running", "oodaMode": "simulated"|"live", ... }

Step 7 — Chrome Extension

  1. Open chrome://extensions
  2. Enable Developer mode (top right toggle)
  3. Click Load unpacked
  4. Select the chrome-extension/ folder in this repo
  5. Click the SolanaOS Control icon in the toolbar

The extension auto-connects to http://127.0.0.1:7777.


Step 8 — Bitaxe Miner (Optional)

bash
# Auto-discover Bitaxe on LAN, configure pool, write .env
BTC_WALLET=bc1q...your_address bash scripts/bitaxe-quickstart.sh
# Restart daemon to pick up miner config
launchctl kickstart -k gui/$(id -u)/com.solanaos.daemon

After this the Chrome extension shows a live hashrate card and Telegram responds to /miner.


Step 9 — Use the Local MiniMax Harness (Optional)

bash
# Install Ollama
curl -fsSL https://ollama.ai/install.sh | sh
# Pull MiniMax M2.7
ollama pull minimax-m2.7:cloud
# Point SolanaOS at it
echo "LLM_PROVIDER=ollama" >> .env
echo "OLLAMA_MODEL=minimax-m2.7:cloud" >> .env
# Restart daemon
launchctl kickstart -k gui/$(id -u)/com.solanaos.daemon

Telegram Commands Reference

CommandDescription
/statusFull runtime dashboard: model, wallet, Honcho, Aster, Hyperliquid, services
/walletWallet address + SOL balance
/personalitySet bot persona and preferred name
/trendingTrending Solana tokens
/oodaTrigger OODA cycle
/simSwitch to simulated mode
/liveSwitch to live trading mode
/strategyShow strategy parameters
/set <param> <value>Live-edit strategy (e.g. /set rsi_period 12)
/minerBitaxe hashrate, temp, power
/research <mint>Deep research a token
/tradesRecent trade history
/web <query>Grok web search
/xsearch <query>Grok X search
/deepsolana <prompt>Force the local Ollama harness path
/helpAll commands

Strategy Parameters (live-editable via /set)

ParameterDefaultRange
rsi_period145–30
rsi_overbought7260–90
rsi_oversold2810–40
ema_fast93–20
ema_slow2110–100
stop_loss71–20 (%)
take_profit255–100 (%)
position_size101–20 (%)

Key Files

FilePurpose
main.goCLI entrypoint — all commands
pkg/daemon/daemon.goOrchestrator — wallet, OODA, Telegram, miner
pkg/strategy/strategy.goRSI + EMA + ATR signal engine
pkg/config/config.goConfig struct + Load/Save
pkg/nanobot/server.goLocal HTTP server (port 7777)
chrome-extension/MV3 Chrome extension
scripts/install-service.shmacOS LaunchAgent installer
scripts/bitaxe-quickstart.shBitaxe auto-setup
strategy.mdStrategy documentation
docs/bitaxe-setup.mdBitaxe full setup guide

Common Issues

ProblemFix
Port 7777 in uselsof -i :7777 → kill the process
Telegram 409 Conflictpkill -f "solanaos" then restart
Wallet not foundRun solanaos onboard
Extension shows offlineMake sure daemon is running, check curl http://127.0.0.1:7777/api/status
Build failsRun go mod tidy then make build

One-Shot Agent Prompt

If you want an AI agent to do the entire setup automatically, paste this:

Read skill.md in the SolanaOS project root.
Follow every step in order.
My .env values are:
HELIUS_API_KEY=...
OPENROUTER_API_KEY=...
TELEGRAM_BOT_TOKEN=...
TELEGRAM_CHAT_ID=...
Complete the full installation including LaunchAgent and Chrome extension.
Confirm each step before proceeding.

SolanaOS Companion · Built by SolanaOS Labs · Apache 2.0

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

Source

Popularity

Repository stars
9
Repository forks
2
7-day trend score
12

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 20 May 2026, 6 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/x402agent/solanaos/public/badge)](https://verified-skill.com/skills/x402agent/solanaos/public)

Something wrong with this skill or its page? Tell us.