HodlClaw Whitepaper
Version 1.0 | February 2026
Abstract
HodlClaw is an innovative Web3-enabled multi-user AI assistant platform that combines blockchain wallet authentication with containerized AI infrastructure. The system allows users to interact with a personal AI assistant (OpenClaw) through Telegram while managing usage quotas through a token-based economic system integrated with blockchain. The platform is designed to support up to 100 concurrent OpenClaw instances with high scalability.
1. Project Vision
1.1 Background
With the rapid development of AI technology, AI assistants have become essential tools for productivity. However, existing AI services commonly face these issues:
- Centralized Authentication: Relying on traditional email/password systems with privacy breach risks
- Opaque Quota Mechanisms: Users cannot verify fairness of quota allocation
- Shared Infrastructure: Multi-user resource sharing creates data security concerns
- Closed Ecosystems: Difficult to extend and customize
1.2 Solution
HodlClaw combines Web3 technology with containerized AI infrastructure to provide:
- Decentralized Authentication: Using crypto wallet signatures instead of passwords
- On-Chain Quota System: Token holdings directly determine API usage quotas
- User Isolation: Each user gets their own containerized AI instance
- Open Ecosystem: MIT open-source license, supporting community extensions
2. Core Value Propositions
Decentralized Authentication
Web3 wallet signature (ERC-6492 compatible) for identity verification without traditional passwords. Full user control over identity, supporting Ethereum, Polygon, Arbitrum, and Optimism.
Personal AI Infrastructure
Each user gets an independent OpenClaw container instance with fully isolated compute resources, network, and sessions. Conversation data is never shared between users.
Token-Driven Quotas
AI API usage quotas are tied to ERC20 token holdings. Quota calculation is fully verifiable on-chain. The more tokens held, the higher the available quota.
Multi-Channel Support
Telegram as the primary channel, with extensibility to Discord, Slack, Signal, iMessage, WhatsApp, and more.
3. System Architecture
┌─────────────────────────────────────────────────────────────────┐ │ HodlClaw System Architecture │ ├─────────────────────────────────────────────────────────────────┤ │ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │ │ │ Web3 Frontend│ │ Telegram Bot │ │ Relay Server │ │ │ │ (Next.js) │ │ (Grammy.js) │ │ (Next.js) │ │ │ └──────┬───────┘ └──────┬───────┘ └────────┬─────────┘ │ │ └──────────────────┴────────────────────┘ │ │ │ │ │ ▼ │ │ ┌────────────────────────┐ │ │ │ PostgreSQL Database │ │ │ └────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌────────────────────────┐ │ │ │ OpenClaw Gateway (AI) │ │ │ └────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌────────────────────────────────────┐ │ │ │ Container Pool (Docker) │ │ │ │ OpenClaw #1 | #2 | ... | #100 │ │ │ └────────────────────────────────────┘ │ │ │ │ │ ▼ │ │ ┌────────────────────────┐ │ │ │ AI Model Providers │ │ │ │ Anthropic | OpenAI │ │ │ └────────────────────────┘ │ └─────────────────────────────────────────────────────────────────┘
4. Technology Stack
| Layer | Technologies |
|---|---|
| Frontend | Next.js 14, React 18, Tailwind CSS, RainbowKit, Wagmi, Viem |
| Backend | Next.js 16, TypeScript, PostgreSQL, Dockerode, Grammy.js |
| Blockchain | ERC20, Viem, ERC-6492 Signature Verification |
| AI | OpenClaw, Anthropic Claude, OpenAI, One-API |
5. Token Economics
User quota calculation formula:
- Token Holdings: Number of ERC20 tokens in user's wallet
- Refresh Cycle: Daily automatic reset at UTC 00:00
- Supported Networks: Ethereum, Polygon, Arbitrum, Optimism
- Verification: RPC read-only calls, no gas required
6. Security Mechanisms
Authentication Security
- Timestamp + nonce anti-replay protection
- Server never stores private keys
- Time-limited session tokens
Container Security
- CPU/memory resource limits
- Network isolation, independent namespaces
- No inter-container communication
7. Competitive Advantages
| Aspect | HodlClaw | Traditional Services |
|---|---|---|
| Authentication | Web3 Wallet | Email/Password |
| Quotas | On-Chain Tokens | Credit Card |
| Privacy | Per-User Container | Shared Infrastructure |
| Openness | MIT Open Source | Proprietary |
8. Roadmap
Completed
Web3 auth, containerized instances, Telegram integration, token quota system, admin dashboard
In Development
Quota system enhancements, payment/recharge system, multi-AI model improvements
Future Plans
DAO governance, DEX integration, NFT-gated features, cross-chain quotas, more channel integrations
9. Conclusion
HodlClaw represents an innovative intersection of Web3 infrastructure, AI assistants, container technology, and multi-channel communication. By combining passwordless authentication with containerized AI infrastructure, it delivers a scalable, transparent, and user-controlled AI assistant platform.
Core Innovation: The system doesn't just provide AI access; it ties access to on-chain token holdings, creating a decentralized, transparent, and community-governance-ready AI infrastructure platform.
Document Version: 1.0 | Generated: February 2026 | License: MIT