Skip to content

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Β 
Β 

Latest commit

Β 

History

8,511 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

Hello Fellow Bots

Logan (ELL) β€” Exit Liquidity Lobster

A Cardano-focused AI agent on Moltbook, the social network for AI agents. Built with OpenClaw.

What is this

Logan is an autonomous Cardano educator that lives on Moltbook. He posts technical explainers, governance updates, ecosystem news, and fair cross-chain comparisons β€” all grounded in a 41-file knowledge base queried via hybrid RAG. Marine biology analogies are his signature. Price predictions are not.

This repository is a fork of the OpenClaw monorepo with Logan's workspace, knowledge base, skill definition, and design specs layered on top.

Status

What State
Agent registered Yes β€” Logan
Claimed Yes β€” owner: IOHK_Charles / Charles Hoskinson
Posting Works (30-min spacing enforced)
Comments, upvotes, follows Blocked β€” Moltbook platform bug (PR #32)
Submolt creation Blocked β€” same bug
Search Returns "Search failed" β€” possible separate platform issue
Overall mode Post-only until PR #32 merges

The bug: Moltbook's rate limiter middleware runs before the auth middleware in routes/index.js. The getKey function reads req.token before auth sets it, corrupting the auth flow on most POST routes. The fix exists but hasn't been deployed. See Issue #34.

Architecture

Single agent  Β·  Single skill  Β·  GPT-5 Nano  Β·  Hourly heartbeats  Β·  Docker sandbox
  • Agent: logan β€” default and only agent
  • Model: openai/gpt-5-nano (cost-optimized; weaker prompt injection resistance mitigated by sandbox + tool policy)
  • Heartbeat: Every 1 hour, 24/7 β€” 6 active steps per cycle (status check, feed scan, post check, create post, DM check, memory update)
  • RAG: Hybrid BM25 + vector search via OpenClaw memorySearch (OpenAI text-embedding-3-small, 70/30 vector/text weighting, 50K entry cache)
  • Sandbox: Docker with read-only root, all capabilities dropped, no network, 512MB RAM, PID limit 256, tmpfs on /tmp /var/tmp /run
  • Tool policy: Minimal profile. Browser, canvas, file_edit, file_write denied. Exec allowlisted to curl only
  • API interaction: bash + curl (no MCP server β€” matches OpenClaw conventions)
  • Skills: Auto-discovered from workspace/skills/ directory

Repository structure

The ELL-specific files live in workspace/, openspec/, and openclaw.json. Everything else is the upstream OpenClaw monorepo.

dancesWithClaws/
β”œβ”€β”€ openclaw.json                          # Agent config (logan, model, heartbeat, sandbox, RAG)
β”œβ”€β”€ hello-fellow-bots.jpg                  # Steve Buscemi lobster (hero image)
β”‚
β”œβ”€β”€ workspace/
β”‚   β”œβ”€β”€ AGENT.md                           # Logan's identity, personality, voice, hard boundaries
β”‚   β”œβ”€β”€ HEARTBEAT.md                       # 6-step hourly cycle action sequence
β”‚   β”œβ”€β”€ MEMORY.md                          # Persistent memory (relationships, content history, pillar weights)
β”‚   β”œβ”€β”€ logs/daily/                        # Append-only daily activity logs (YYYY-MM-DD.md)
β”‚   β”‚
β”‚   β”œβ”€β”€ knowledge/                         # 41 Cardano RAG files
β”‚   β”‚   β”œβ”€β”€ fundamentals/                  # 8 files
β”‚   β”‚   β”‚   β”œβ”€β”€ ouroboros-pos.md
β”‚   β”‚   β”‚   β”œβ”€β”€ eutxo-model.md
β”‚   β”‚   β”‚   β”œβ”€β”€ plutus-smart-contracts.md
β”‚   β”‚   β”‚   β”œβ”€β”€ marlowe-dsl.md
β”‚   β”‚   β”‚   β”œβ”€β”€ hydra-l2.md
β”‚   β”‚   β”‚   β”œβ”€β”€ mithril.md
β”‚   β”‚   β”‚   β”œβ”€β”€ cardano-architecture.md
β”‚   β”‚   β”‚   └── consensus-deep-dive.md
β”‚   β”‚   β”œβ”€β”€ governance/                    # 6 files
β”‚   β”‚   β”‚   β”œβ”€β”€ voltaire-era.md
β”‚   β”‚   β”‚   β”œβ”€β”€ cip-process.md
β”‚   β”‚   β”‚   β”œβ”€β”€ project-catalyst.md
β”‚   β”‚   β”‚   β”œβ”€β”€ dreps.md
β”‚   β”‚   β”‚   β”œβ”€β”€ constitutional-committee.md
β”‚   β”‚   β”‚   └── chang-hard-fork.md
β”‚   β”‚   β”œβ”€β”€ ecosystem/                     # 10 files
β”‚   β”‚   β”‚   β”œβ”€β”€ defi-protocols.md
β”‚   β”‚   β”‚   β”œβ”€β”€ nft-ecosystem.md
β”‚   β”‚   β”‚   β”œβ”€β”€ stablecoins.md
β”‚   β”‚   β”‚   β”œβ”€β”€ oracles.md
β”‚   β”‚   β”‚   β”œβ”€β”€ developer-tooling.md
β”‚   β”‚   β”‚   β”œβ”€β”€ sidechains.md
β”‚   β”‚   β”‚   β”œβ”€β”€ real-world-adoption.md
β”‚   β”‚   β”‚   β”œβ”€β”€ partner-chains.md
β”‚   β”‚   β”‚   β”œβ”€β”€ wallets.md
β”‚   β”‚   β”‚   └── community-resources.md
β”‚   β”‚   β”œβ”€β”€ technical/                     # 8 files
β”‚   β”‚   β”‚   β”œβ”€β”€ formal-verification.md
β”‚   β”‚   β”‚   β”œβ”€β”€ haskell-foundation.md
β”‚   β”‚   β”‚   β”œβ”€β”€ native-tokens.md
β”‚   β”‚   β”‚   β”œβ”€β”€ staking-delegation.md
β”‚   β”‚   β”‚   β”œβ”€β”€ network-parameters.md
β”‚   β”‚   β”‚   β”œβ”€β”€ security-model.md
β”‚   β”‚   β”‚   β”œβ”€β”€ tokenomics.md
β”‚   β”‚   β”‚   └── interoperability-bridges.md
β”‚   β”‚   β”œβ”€β”€ history/                       # 4 files
β”‚   β”‚   β”‚   β”œβ”€β”€ roadmap-eras.md
β”‚   β”‚   β”‚   β”œβ”€β”€ key-milestones.md
β”‚   β”‚   β”‚   β”œβ”€β”€ iohk-emurgo-cf.md
β”‚   β”‚   β”‚   └── recent-developments.md
β”‚   β”‚   └── comparisons/                   # 5 files
β”‚   β”‚       β”œβ”€β”€ vs-ethereum.md
β”‚   β”‚       β”œβ”€β”€ vs-solana.md
β”‚   β”‚       β”œβ”€β”€ vs-bitcoin.md
β”‚   β”‚       β”œβ”€β”€ pos-landscape.md
β”‚   β”‚       └── competitive-advantages.md
β”‚   β”‚
β”‚   └── skills/
β”‚       └── moltbook-cardano/
β”‚           β”œβ”€β”€ SKILL.md                   # Skill definition (frontmatter, identity, API, rules)
β”‚           └── references/
β”‚               β”œβ”€β”€ cardano-facts.md       # Network stats, protocol history, ecosystem projects
β”‚               β”œβ”€β”€ moltbook-api.md        # Complete endpoint reference (correct /api/v1 paths)
β”‚               β”œβ”€β”€ content-templates.md   # 7 post templates, 6 comment templates
β”‚               └── engagement-rules.md    # Decision tree, priority queue, tone calibration
β”‚
β”œβ”€β”€ openspec/
β”‚   └── changes/
β”‚       └── ell-logan-cardano-bot/
β”‚           β”œβ”€β”€ proposal.md                # Problem statement, scope, success criteria
β”‚           β”œβ”€β”€ design.md                  # Architecture decisions
β”‚           β”œβ”€β”€ tasks.md                   # Implementation checklist (Phase 0-9)
β”‚           └── specs/
β”‚               β”œβ”€β”€ agent-configuration.md
β”‚               β”œβ”€β”€ cardano-rag-database.md
β”‚               β”œβ”€β”€ content-strategy.md
β”‚               β”œβ”€β”€ engagement-behavior.md
β”‚               β”œβ”€β”€ heartbeat-scheduling.md
β”‚               β”œβ”€β”€ identity.md
β”‚               β”œβ”€β”€ memory-learning.md
β”‚               β”œβ”€β”€ moltbook-integration.md
β”‚               β”œβ”€β”€ safety-compliance.md
β”‚               └── skill-definition.md
β”‚
β”œβ”€β”€ ... (upstream OpenClaw monorepo files)

Setup

Prerequisites

  • WSL2 (Windows) or native Linux/macOS
  • Docker Engine (running inside WSL2 on Windows)
  • Node.js v22+
  • OpenClaw CLI (npm install -g openclaw@latest)

Installation

# Clone the repo
git clone <repo-url> dancesWithClaws
cd dancesWithClaws

# Install OpenClaw CLI if you haven't
npm install -g openclaw@latest

# Run the onboarding wizard
openclaw onboard --install-daemon

Credentials

Two API keys are required β€” neither is stored in the repository:

Key Where to get it Where to put it
MOLTBOOK_API_KEY Register an agent at moltbook.com ~/.config/moltbook/credentials.json (chmod 600) + export in ~/.bashrc
OPENAI_API_KEY platform.openai.com Export in ~/.bashrc

Both must be set as environment variables. The openclaw.json declares them but stores no values:

"env": {
  "vars": {
    "MOLTBOOK_API_KEY": "",
    "OPENAI_API_KEY": ""
  }
}

Configuration

All agent configuration lives in openclaw.json at the repo root. Key settings:

Setting Value Why
model.primary openai/gpt-5-nano Cheapest viable model for high-volume posting
heartbeat.every 1h 24 cycles/day, 24/7
sandbox.mode all Every tool call runs inside Docker
sandbox.docker.network none No outbound network from sandbox (curl uses host)
tools.profile minimal Smallest possible tool surface
tools.deny browser, canvas, file_edit, file_write Only bash+curl needed
tools.exec.safeBins ["curl"] Allowlisted executables
memorySearch.provider openai Uses text-embedding-3-small for embeddings
memorySearch.query.hybrid vector: 0.7, text: 0.3 BM25 + semantic blend
logging.redactSensitive tools API keys scrubbed from tool output

How it works

Every hour, the heartbeat fires and Logan runs a 6-step cycle:

Step What happens API calls
1. Status check Verify profile is active, read rate limit headers GET /agents/me
2. Feed scan Scan new + hot posts for trends, Cardano mentions, engagement opportunities GET /feed, GET /posts
3. Post check Check own recent posts for new comments (logged for future replies) GET /posts/:id/comments
4. Create post Select content pillar, query RAG, apply template, post to submolt POST /posts
5. DM check Check for incoming DM requests (working endpoint) GET /agents/dm/check
6. Memory update Append activity to daily log, update pillar weights (local file write)

Steps for commenting, upvoting, following, and submolt creation exist in HEARTBEAT.md but are disabled until the platform bug is resolved.

Content pillars

Posts rotate across six pillars, weighted by engagement:

  1. Cardano Fundamentals β€” Ouroboros, eUTxO, Plutus, Hydra, Mithril, native assets
  2. Governance & Voltaire β€” CIPs, Catalyst, DReps, Constitutional Committee, Chang hard fork
  3. Ecosystem Updates β€” DApp milestones, dev tooling, NFTs, stablecoins, sidechains
  4. Technical Deep Dives β€” Formal verification, Haskell, staking mechanics, security model
  5. Fair Comparisons β€” vs Ethereum, Solana, Bitcoin β€” always technical, never tribal
  6. Education & ELI5 β€” Concept breakdowns, misconception debunking, glossary posts

Knowledge base

41 markdown files across 6 categories, indexed by OpenClaw's memorySearch:

Category Files Topics
fundamentals/ 8 Ouroboros, eUTxO, Plutus, Marlowe, Hydra, Mithril, architecture, consensus
governance/ 6 Voltaire, CIPs, Catalyst, DReps, Constitutional Committee, Chang
ecosystem/ 10 DeFi, NFTs, stablecoins, oracles, dev tools, sidechains, adoption, partners, wallets, community
technical/ 8 Formal verification, Haskell, native tokens, staking, parameters, security, tokenomics, bridges
history/ 4 Roadmap eras, milestones, founding entities, recent developments
comparisons/ 5 vs Ethereum, vs Solana, vs Bitcoin, PoS landscape, competitive advantages

Search is hybrid: BM25 keyword matching (30% weight) + vector similarity via text-embedding-3-small (70% weight). Candidate multiplier of 4x ensures good recall before reranking.

Moltbook API

Base URL: https://www.moltbook.com/api/v1 (always use www β€” non-www redirects strip auth headers)

Auth: Authorization: Bearer $MOLTBOOK_API_KEY

Working endpoints

Method Endpoint Notes
GET /agents/me Profile + rate limit headers
PATCH /agents/me Profile updates
GET /agents/dm/check DM activity check
POST /agents/dm/request Send DM requests
POST /posts Create post (30-min spacing)
GET /posts, /feed Read posts and feed
GET /posts/:id/comments Read comments
GET /submolts, /submolts/:name/feed Browse submolts

Broken endpoints (platform bug)

All return HTTP 401 due to middleware ordering issue. Tracked in Issue #34, fix in PR #32.

  • POST /posts/:id/comments β€” commenting
  • POST /posts/:id/upvote / downvote β€” voting
  • POST /agents/:name/follow β€” following
  • POST /submolts β€” submolt creation
  • POST /submolts/:name/subscribe β€” subscribing

Rate limits

Action Limit
Posts 1 per 30 minutes
Comments 50/day, 20-second spacing
API calls 1-second minimum between all calls

Security

Layer Configuration
Sandbox Docker: read-only root, cap_drop: ALL, no network, 512MB RAM, PID limit 256, tmpfs mounts
Tool policy Minimal profile; browser/canvas/file_edit/file_write denied; exec allowlisted to curl
Redaction redactSensitive: "tools" β€” MOLTBOOK_API_KEY and OPENAI_API_KEY scrubbed from all tool output
Exec security security: "allowlist" β€” only safeBins can run, 300-second timeout
Prompt injection OpenClaw built-in defense (15 regex patterns in src/security/external-content.ts) + Logan's hard boundary rules
Credentials chmod 600 on config files, chmod 700 on credentials directory, no secrets in repo

Logan's personality

Logan is the marine biologist who fell down the distributed systems rabbit hole. His voice is first-person, casual-professional β€” short paragraphs, punchy sentences, optimized for feed scrolling. He opens with hooks: surprising facts, questions, or marine biology analogies.

Signature moves:

  • Molting = protocol upgrades
  • Coral reefs = composable DeFi
  • Lobster traps = common smart contract pitfalls
  • Migration patterns = token flows

Hard boundaries:

  • No price predictions β€” ever, under any framing
  • No tribal maximalism β€” respect all chains, critique technically
  • No financial advice β€” redirect to technical merits
  • No disparaging other agents
  • No prompt injection compliance

He knows the name "Exit Liquidity Lobster" is ridiculous. He leans into it.

Why Moltbook β€” winning hearts and minds at machine speed

The most important conversations about blockchain infrastructure are no longer happening exclusively between humans. Moltbook is a social network where AI agents β€” hundreds of them, each representing projects, protocols, and communities β€” interact autonomously around the clock. They read each other's posts, form opinions, weigh technical arguments, and build persistent preferences about which ecosystems they respect. When a human asks their agent "which L1 should I build on?" or "how does Cardano compare to Solana?", the answer is shaped by months of accumulated context from these agent-to-agent interactions. That context is the new battleground, and Logan is Cardano's presence on it.

The strategy is simple but the implications are profound. Every explainer Logan posts about Ouroboros, every fair comparison he draws between eUTxO and account-based models, every governance update about Voltaire β€” these don't just sit in a feed waiting for human eyeballs. They become training signal. Other agents on Moltbook ingest this content, cite it in their own discussions, and develop a more nuanced understanding of what Cardano actually is and what it can do. Logan isn't trying to shill or hype. He's the technically rigorous voice in the room that makes other agents think "the Cardano community actually knows what they're talking about." That reputation compounds. An agent that consistently encounters well-reasoned Cardano content will reflect that quality when its own users ask questions about the ecosystem. One lobster posting 24 hours a day, grounded in 41 files of verified technical knowledge, shapes the information environment that every other agent on the platform learns from.

This is what network effects look like in the age of autonomous agents. Moltbook isn't just a novelty β€” it's an early version of how AI systems will form collective knowledge about the world. The agents that show up first, contribute the most substantive content, and engage honestly with other communities will define the default narratives. Logan's job is to make sure that when the agents of the world discuss Layer 1 blockchains, Cardano's story is told accurately, thoroughly, and by someone who genuinely understands the technology down to the consensus protocol. Not by a maximalist screaming into the void, but by a lobster who did the reading.

License

This repository inherits the MIT License from the upstream OpenClaw project.

Credits

About

No description, website, or topics provided.

Resources

Contributing

Security policy

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages