Skip to content

Randomdh/beast-companion

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

31 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Beast Companion

Your personal AI assistant for A Kid Called Beast collecting.

Beast Companion runs on OpenClaw — a self-hosted AI agent platform. Unlike broadcast bots, this runs on YOUR device with YOUR data. It learns your preferences, tracks your wallet, and helps you find opportunities.


What Can It Do?

Feature Description
Portfolio Analysis Score your collection, identify gaps, get suggestions
Smart Search "Find me a Robot under 0.15 ETH with vibe 60+"
Beast Evaluation Full breakdown with buy/hold/pass recommendations
Personal Alerts Watch for specific traits, prices, or opportunities
Market Briefs Daily summaries tailored to your portfolio
Collecting Journal Track your thesis and notes on each beast

Before You Start

Beast Companion requires OpenClaw. There are two paths:

Option A: Kimi Claw (Zero Setup)

Kimi Claw runs OpenClaw in your browser — no server, no terminal, no 30-minute setup.

  1. Sign up for Kimi.ai (Allegretto plan or higher)
  2. Access Kimi Claw at kimi.com/bot
  3. Install Beast Companion via "Bring Your Own Claw" (instructions coming)

Pros: Zero setup, 40GB storage, 5000+ skills included Cons: Beta access only, Chinese data jurisdiction

Option B: Self-Hosted OpenClaw

Full control, fully private. Requires some technical comfort.

  1. Install OpenClaw (Node.js 22+ required)
  2. Configure your AI provider (see below)
  3. Install Beast Companion plugin

Hardware: Mac Mini vs VPS

Many OpenClaw users buy dedicated Mac Minis. Here's when that makes sense:

Factor Mac Mini VPS ($5-24/mo)
iMessage alerts Native support Not possible
Local LLMs Run on unified memory ($0 API) Need $100+/mo GPU instances
Privacy Data never leaves home Data on provider's server
Power cost ~$1-2/mo (3-4W idle) Included
Noise Silent, bedroom-friendly N/A
Uptime You manage Provider manages
Upfront cost $600-1500 $0

For Beast Companion specifically: Most users don't need a Mac Mini. You're calling our API + a cloud model — a $5/month VPS or Kimi Claw works fine.

Consider Mac Mini if you also want:

  • iMessage integration for alerts
  • Local LLMs for zero ongoing API costs
  • Maximum privacy (sensitive portfolio data)
  • No monthly fees after hardware purchase

Resources: UGREEN comparison, Hardware guide


Critical: Cost & Performance Setup

OpenClaw can be expensive without optimization. Complete these steps before heavy use.

1. Install a Memory Plugin (Required)

Without a memory plugin, OpenClaw burns tokens exponentially. Users report $800+/month without optimization.

Recommended: QMD (60-97% token reduction, fully local, zero API cost)

# Install QMD
cd ~/.openclaw/extensions
git clone https://github.com/levineam/qmd-skill

Alternatives: MemOS (72% reduction), Mem0

2. Configure Your Model (Required)

Your AI provider choice dramatically affects cost. We recommend OpenRouter — pay-as-you-go access to multiple models including Kimi K2.5 (8x cheaper than Claude).

  1. Sign up at openrouter.ai
  2. Add credits (no subscription required)
  3. Get your API key from the dashboard
Model Input Cost Output Cost Recommendation
Kimi K2.5 $0.50/M $2.80/M Default choice
Kimi K2 (free) $0 $0 Testing only
Claude Haiku $0.25/M $1.25/M Simple queries
Claude Sonnet $3/M $15/M Complex analysis
Local (LMStudio) $0 $0 Privacy-focused

Configure in ~/.openclaw/openclaw.json:

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-YOUR_KEY_HERE"
    }
  },
  "defaults": {
    "model": "moonshotai/kimi-k2.5"
  }
}

3. Run Security Audit (Required)

OpenClaw has deep system access. Before first use:

openclaw security audit --deep

Review and address any findings. See SECURITY.md for details.

Expected Monthly Costs

Usage With Optimization Without
Casual (few queries/day) $5-15 $30-50
Active (hourly use) $30-80 $150-300
Power user (always on) $100-200 $800-1500

Installation

Step 1: Clone the Plugin

cd ~/.openclaw/extensions
git clone https://github.com/akcb/beast-companion.git
cd beast-companion
npm install
npm run build

Step 2: Configure

Add to ~/.openclaw/openclaw.json:

{
  "plugins": {
    "beast-companion": {
      "enabled": true,
      "dataSource": "remote",
      "dataApiUrl": "http://129.158.41.81:3100",
      "walletAddresses": [
        "0xYourWalletAddress"
      ]
    }
  }
}

Step 3: Restart OpenClaw

openclaw restart

Step 4: Verify

You: What's in my wallet?
AI: [Analyzes your AKCB holdings...]

Usage Examples

You: What's in my wallet?
AI: You have 7 beasts with an average composite of 62. Your strongest
    is #4521 (composite 78, Cowboy archetype). You're light on Robot
    traits — consider adding one for archetype diversity.

You: Find me a Wolf under 0.15 ETH
AI: Found 3 Wolf listings under 0.15 ETH:
    - #2341: 0.12 ETH, composite 58, clean suit
    - #5672: 0.14 ETH, composite 64, vibe 71
    - #1893: 0.098 ETH, composite 45, project piece

You: Evaluate beast 4521
AI: Beast #4521 Analysis:
    Composite: 78 (top 15%)
    Vibe: 64 | Reputation: 72
    Archetype: Cowboy (cohesive)
    Top traits: Shaykhah (heating), Gold Chain
    Recommendation: HOLD — strong fundamentals, Shaykhah demand rising

You: Alert me when any Robot Suit under 0.2 lists
AI: Alert created! I'll notify you when a Robot Suit lists under 0.2 ETH.

You: What's the market doing?
AI: Market Brief (Feb 16):
    Floor: 0.058 ETH (+3% 24h)
    Volume: 12.4 ETH (above average)
    Heating: Wolf (+8%), Shaykhah (+12%)
    Cooling: Basic backgrounds (-4%)
    For your portfolio: Your Wolf is up 15% from entry.

You: I bought #1234 because I think Robots are undervalued
AI: Noted in your journal. I'll track your Robot thesis and alert you
    to relevant developments.

Tools Reference

Tool What It Does
akcb_portfolio_analyze Analyze wallet holdings, scores, gaps, suggestions
akcb_find_listings Search listings with trait, price, score filters
akcb_evaluate_beast Full evaluation of a specific beast
akcb_track_alert Create and manage personal alerts
akcb_market_brief Market overview with portfolio-relevant insights
akcb_journal Add and search collecting notes

Configuration Options

Option Type Default Description
dataSource "local" | "remote" "remote" Where to fetch scoring data
dataApiUrl string http://129.158.41.81:3100 Remote API endpoint
localDataPath string Path to local data files
walletAddresses string[] [] Wallets to track
openSeaApiKey string For live listing data
alchemyApiKey string For on-chain data

Data & Privacy

  • Your data stays local: Wallet, alerts, and journal stored on your device only
  • Your API key is yours: We never see your queries or responses
  • Scoring data is public: Derived from on-chain activity, no personal info
  • No tracking: No telemetry, no accounts, no analytics

Troubleshooting

"Context overflow" or high token usage

Install a memory plugin (QMD recommended). See Cost & Performance Setup.

Plugin not loading

  1. Check openclaw doctor
  2. Verify plugin is built: cd beast-companion && npm run build
  3. Check config syntax in openclaw.json

Data API not responding

curl http://129.158.41.81:3100/health

Should return {"status":"ok"}. If not, the API may be down.

Config changes not taking effect

Run openclaw doctor --fix after any upgrade or config change. OpenClaw stores config in 4 places — this syncs them.

Costs higher than expected

  1. Verify memory plugin is active
  2. Use Kimi K2.5 via OpenRouter (8x cheaper than Claude)
  3. Try free Kimi K2 tier for testing (moonshotai/kimi-k2:free)
  4. Enable prompt caching in your provider settings
  5. Use /new to clear context when starting fresh tasks

Token Gating (Coming Soon)

Beast Companion will be free for all AKCB holders. Verify your holdings to unlock features:

Tier Requirement Features
Basic 1+ Beast Portfolio view, basic queries
Collector 5+ Beasts Full scoring, alerts, journal
Whale 10+ Beasts Priority data, advanced analytics

Development

# Watch mode
npm run dev

# Build
npm run build

# Lint
npm run lint

Support


License

MIT


Credits

Built for the AKCB community. Scoring algorithms from akc-sales-bot.

Beast Companion is not affiliated with or endorsed by the official AKCB team.

About

Personal AI assistant for A Kid Called Beast collectors - OpenClaw plugin

Resources

Security policy

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors