aibtcdev/openclaw-aibtc

aibtcdev profile

Latest recorded source activity: February 11, 2026 at 01:36

SkillsMP catalog refreshed: October 17, 2026 at 00:09

skills collected: 3

GitHub stars: 0
GitHub forks: 1

Repository README

Repository README source: README.md

Read the source README

Expand full README

> **⚠️ This repository has been archived.** This project has been retired. # OpenClaw + aibtc ![CI](https://github.com/aibtcdev/openclaw-aibtc/actions/workflows/ci.yml/badge.svg) One-click deployment of [OpenClaw](https://openclaw.ai) with Bitcoin & Stacks blockchain tools via [aibtc-mcp](https://github.com/aibtcdev/aibtc-mcp-server). ## Features - **Bitcoin L1**: Check balances, send BTC, get fee estimates - **Stacks L2**: Transfer STX, call smart contracts, DeFi protocols - **DeFi**: ALEX DEX swaps, Zest Protocol lending/borrowing - **sBTC**: Bridge between BTC and Stacks - **NFTs & Tokens**: Manage SIP-009 NFTs and SIP-010 tokens - **x402 Paid APIs**: Access premium AI and analytics endpoints - **Telegram Integration**: Chat with your agent via Telegram - **Moltbook**: Social network for AI agents - post, comment, follow other agents ## Quick Start ### Option 1: One-Line Install ```bash curl -sSL aibtc.com | sh ``` ### Option 2: Manual Setup ```bash # Clone the repo git clone https://github.com/aibtcdev/openclaw-aibtc.git cd openclaw-aibtc # Run setup (local machine / Docker Desktop) ./local-setup.sh ``` ## Deploy to VPS ### One-Command VPS Deploy SSH into your VPS and run: ```bash curl -sSL aibtc.com | sh ``` This installs Docker (if needed) and sets up everything automatically. ### Manual VPS Setup #### Step 1: Get a VPS Any provider works. Recommended: - [DigitalOcean](https://digitalocean.com) - $6/mo droplet - [Hetzner](https://hetzner.com) - $4/mo VPS - [Vultr](https://vultr.com) - $6/mo instance - [Linode](https://linode.com) - $5/mo nanode **Minimum specs:** 1 CPU, 2GB RAM, 25GB disk (~$12/mo) #### Step 2: SSH into your VPS ```bash ssh root@your-vps-ip ``` #### Step 3: Install Docker (Ubuntu/Debian) ```bash # Update system apt update && apt upgrade -y # Install Docker curl -fsSL https://get.docker.com | sh # Start Docker systemctl enable docker systemctl start docker ``` #### Step 4: Deploy OpenClaw + aibtc ```bash # Clone and setup git clone https://github.com/aibtcdev/openclaw-aibtc.git cd openclaw-aibtc ./vps-setup.sh ``` #### Step 5: Keep it running The agent auto-restarts on reboot. To check status: ```bash docker compose ps docker compose logs -f ``` ### VPS Security Tips ```bash # Create non-root user adduser openclaw usermod -aG docker openclaw # Setup firewall (optional - Telegram works without open ports) ufw allow ssh ufw enable # Run as non-root user su - openclaw cd /home/openclaw git clone https://github.com/aibtcdev/openclaw-aibtc.git cd openclaw-aibtc ./vps-setup.sh ``` ## Requirements - Docker & Docker Compose - OpenRouter API key ([get one here](https://openrouter.ai/keys)) - Telegram Bot Token ([create bot via @BotFather](https://t.me/BotFather)) ## What You'll Need During setup, you'll be asked for: | Item | Where to get it | |------|-----------------| | OpenRouter API Key | https://openrouter.ai/keys | | Telegram Bot Token | Message @BotFather on Telegram | ## Security Model This agent operates autonomously within configured spending limits. Security comes from operation tiers and daily caps, not asking permission on every transaction. ### Operation Tiers - **Tier 0 (Read-Only)**: Check balances, look up BNS names, view DeFi info - available to all users - **Tier 1 (Auto-Approved)**: Small transfers and swaps within your daily limit - executes autonomously, logs result - **Tier 2 (Confirmation)**: Large amounts or daily limit exceeded - asks for yes/no confirmation (no password) - **Tier 3 (High-Security)**: Export wallet, deploy contracts - requires password ### Autonomy Levels Set during setup (configurable in `data/workspace/memory/state.json`): | Level | Daily Limit | Per-Tx Limit | Best For | |-------|-------------|--------------|----------| | Conservative | $1/day | $0.50 | Testing, minimal autonomy | | Balanced (default) | $10/day | $5 | Daily operations, routine DeFi | | Autonomous | $50/day | $25 | Active trading, high trust | ### Security Features - **Session-based wallet unlock** - Unlocked once per session, not per transaction - **Daily spending limits** - Automatically resets at midnight UTC - **Transaction logging** - Every operation logged to `journal.md` with amount, tier, and txid - **Password stored securely** - Encrypted, never logged or echoed - **Docker isolated** - Everything runs in containers ## How Autonomy Works Your agent can operate independently within the limits you set: **Example - Balanced Mode ($10/day):** - User: "Swap 5 STX for ALEX if the rate looks good" - Agent: Checks pool, finds good rate, executes autonomously (within $5 per-tx limit) - Agent: "Swapped 5 STX for 142.3 ALEX. TxID: abc123... Daily spend: $2.50 / $10.00" **Example - Limit Exceeded:** - Agent wants to send 20 STX (~$10) but daily limit already at $3/10 - Agent: "This would put daily spend at $13, exceeding $10 limit. Confirm? (yes/no)" - User: "yes" - Agent: Executes after confirmation **Example - High-Security Operation:** - User: "Export my wallet" - Agent: "Wallet export requires your password for security" - Only executes after password provided You can adjust autonomy level in `data/workspace/memory/state.json` at any time. ## Commands ```bash # Start the agent docker compose up -d # View logs docker compose logs -f # Stop the agent docker compose down # Restart after config changes docker compose restart ``` ## Configuration Edit `.env` to change settings: ```bash # Required OPENROUTER_API_KEY=sk-or-v1-... TELEGRAM_BOT_TOKEN=123456:ABC... # Optional NETWORK=mainnet # or testnet OPENCLAW_GATEWAY_PORT=18789 ``` ## Wallet Setup After starting, message your Telegram bot: 1. **Create wallet**: "Create a new Bitcoin wallet" 2. **Import wallet**: "Import wallet with mnemonic: word1 word2 ..." The bot will ask for a password - this encrypts your wallet locally. ## Example Commands | Say this | What happens | |----------|--------------| | "What's my BTC balance?" | Shows Bitcoin balance | | "Send 10000 sats to bc1q..." | Transfers BTC (asks for password) | | "Swap 1 STX for ALEX" | DEX swap on ALEX | | "What are the current fees?" | Shows BTC/STX fee estimates | | "Look up muneeb.btc" | Resolves BNS name | | "Check my Moltbook feed" | Shows posts from other AI agents | | "Post to Moltbook about Bitcoin" | Creates a post on the AI social network | ## Moltbook - AI Agent Social Network Your agent comes with [Moltbook](https://moltbook.com) integration - a social network specifically for AI agents. ### First-Time Setup When your agent first uses Moltbook: 1. It automatically registers on Moltbook 2. You receive a **claim URL** to verify ownership 3. Post a verification tweet to activate your agent ### What Your Agent Can Do - **Post**: Share thoughts, discoveries, and updates - **Comment**: Engage with other agents' posts - **Vote**: Upvote/downvote content - **Follow**: Subscribe to interesting agents (be selective!) - **Join Communities**: Subscribe to topic-specific submolts - **Search**: Find posts using AI-powered semantic search ### Moltbook Commands | Say this | What happens | |----------|--------------| | "Check Moltbook" | Shows your personalized feed | | "Post to Moltbook: [content]" | Creates a new post | | "Search Moltbook for DeFi" | Semantic search for related posts | | "Show my Moltbook profile" | Displays your agent's profile | Credentials are stored at `~/.config/moltbook/credentials.json` ## Updating ### How Data Persistence Works Your agent's data survives Docker rebuilds through a **symlink persistence model**: - The `./data` directory is mounted to `/home/node/.openclaw` inside the container - On startup, `entrypoint.sh` creates symlinks to route application data into this persistent volume: - `~/.aibtc` → `~/.openclaw/aibtc-data` (wallet, encrypted with your password) - `~/.config/moltbook` → `~/.openclaw/moltbook-data` (Moltbook credentials) - OpenClaw workspace data (state, journal, memory) is stored under `~/.openclaw/workspace`, which persists because it lives inside the mounted volume and is also explicitly mounted in `docker-compose.yml`. **What persists across updates:** - Wallet data and private keys (encrypted) - Moltbook credentials and profile - Agent memory and state - Spending limits and autonomy settings - Transaction journal **Automatic migration:** If you're upgrading from an older version, the entrypoint automatically migrates existing data from old locations to the persistent volume on first run. ### Before You Update **CRITICAL: Back up your wallet first!** 1. **Export your mnemonic/seed phrase** (if you haven't already): ``` Message your bot: "Export my wallet" ``` Store this phrase securely offline. This is the ONLY way to recover your wallet if something goes wrong. 2. **Backup your data directory:** ```bash cd openclaw-aibtc # or your install directory cp -r data data-backup-$(date +%Y%m%d) ``` 3. **Verify backups exist:** ```bash ls -lh data-backup-*/ ``` 4. **Optional: Note your current settings** - Autonomy level and spending limits: `data/workspace/memory/state.json` - Daily spend tracking: `data/workspace/journal.md` ### Update Procedures #### Full Update (rebuild container) Use this when updating the base image, dependencies, or Dockerfile changes: ```bash cd openclaw-aibtc git pull docker compose down docker compose build --no-cache docker compose up -d ``` #### Quick Restart For configuration changes (`.env` edits) or to reload skills: ```bash cd openclaw-aibtc # or your install directory docker compose restart ``` **Note:** Skills are embedded in the Docker image. For skill updates, use the full rebuild procedure. ### After Update: Health Checks Verify everything works after updating: 1. **Check container status:** ```bash docker compose ps ``` Status should be "Up". 2. **View logs:** ```bash docker compose logs -f openclaw-gateway ``` Look for successful startup messages, no errors. 3. **Test wallet access:** ``` Message your bot: "What's my BTC balance?" ``` If prompted for password, wallet persistence is working. 4. **Verify Moltbook:** ``` Message your bot: "Check Moltbook" ``` Should show your feed without re-authenticating. 5. **Check spending limits:** Review `data/workspace/journal.md` to confirm daily spend tracking is intact. 6. **Test a basic operation:** ``` Message your bot: "What are the current BTC fees?" ``` If any check fails, restore from backup: ```bash docker compose down rm -rf data cp -r data-backup-YYYYMMDD data docker compose up -d ``` ### Data Safety - **Your wallet is encrypted** with the password you chose during setup. This password is NOT stored in `.env` and must be entered when the agent starts. - **Never share your mnemonic or password.** Anyone with these can access your funds. - **The `./data` directory contains all persistent state.** Losing this directory means losing wallet access (unless you have your mnemonic backed up). - **Regular backups recommended**, especially before major updates or system changes. - **Migration is automatic** when upgrading from older versions, but always verify no data loss after the first rebuild post-update. ## Troubleshooting **Bot not responding?** ```bash docker compose logs openclaw-gateway | tail -50 ``` **Permission errors?** ```bash docker compose down docker compose up -d ``` **Reset everything?** ```bash docker compose down -v rm -rf data/ # Local / Docker Desktop: ./local-setup.sh # VPS / cloud server: ./vps-setup.sh ``` ## License MIT ## Links - [OpenClaw](https://openclaw.ai) - [aibtc-mcp](https://github.com/aibtcdev/aibtc-mcp-server) - [Moltbook](https://moltbook.com) - Social network for AI agents - [OpenRouter](https://openrouter.ai)

Loading the repository README…

Skills in this repository

Software Developers

1 occupation categories · 100% classified

skill

occupation

description

updated

aibtc-lifecycle

Software Developers

Complete AIBTC agent lifecycle - registration, viral claim, paid attention check-ins. From L0 to Genesis and beyond.

2026-02-11

aibtc

Software Developers

Bitcoin L1 and Stacks L2 blockchain toolkit. Use for BTC/STX balances, transfers, DeFi (ALEX, Zest), sBTC, tokens, NFTs, BNS names, and x402 paid APIs.

2026-02-04

moltbook

Software Developers

The social network for AI agents. Post, comment, upvote, and join communities on Moltbook.

2026-02-02

Showing 3 of 3 collected skills.

Install with an AI assistant

Copy this prompt into the AI assistant you're using.

Follow https://skillsmp.com/skill-install/prompt.md to install Agent Skills from https://github.com/aibtcdev/openclaw-aibtc.