{"id":50312775,"url":"https://github.com/clawnchdev/openclawnch","last_synced_at":"2026-05-28T22:02:18.788Z","repository":{"id":356651194,"uuid":"1205471401","full_name":"clawnchdev/openclawnch","owner":"clawnchdev","description":"Crypto-native AI agent. OpenClaw for crypto — 48 tools, 118 commands, 7 channels.","archived":false,"fork":false,"pushed_at":"2026-05-21T23:47:51.000Z","size":3980,"stargazers_count":15,"open_issues_count":1,"forks_count":2,"subscribers_count":1,"default_branch":"master","last_synced_at":"2026-05-22T04:31:02.123Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://openclawn.ch","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/clawnchdev.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":"CONTRIBUTING.md","funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":"docs/SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-04-09T01:55:32.000Z","updated_at":"2026-05-21T23:47:55.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/clawnchdev/openclawnch","commit_stats":null,"previous_names":["clawnchdev/openclawnch"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/clawnchdev/openclawnch","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clawnchdev%2Fopenclawnch","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clawnchdev%2Fopenclawnch/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clawnchdev%2Fopenclawnch/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clawnchdev%2Fopenclawnch/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/clawnchdev","download_url":"https://codeload.github.com/clawnchdev/openclawnch/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/clawnchdev%2Fopenclawnch/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33627948,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-05-28T02:00:06.440Z","response_time":99,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-05-28T22:02:13.725Z","updated_at":"2026-05-28T22:02:18.777Z","avatar_url":"https://github.com/clawnchdev.png","language":"TypeScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenClawnch\n\n[![CI](https://github.com/clawnchdev/openclawnch/actions/workflows/ci.yml/badge.svg)](https://github.com/clawnchdev/openclawnch/actions/workflows/ci.yml)\n[![npm](https://img.shields.io/npm/v/@clawnch/openclawnch)](https://www.npmjs.com/package/@clawnch/openclawnch)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n\u003e **Mirror:** [gitlawb](https://gitlawb.com/z6MksiJ5TsUaVfn2ahEkGVRLKDxhnvBq2oiyZ31SrJCANwPK/openclawnch) — decentralized backup, IPFS-pinned\n\nA crypto-native AI agent with direct access to blockchain protocols, market data, and transaction execution. Built as an extension to [OpenClaw](https://github.com/openclaw/openclaw).\n\n48 tools. 118 commands. 76 services. Runs on Telegram, Discord, Slack, Signal, WhatsApp, iMessage, and LINE.\n\n## Quick Start\n\n```bash\ngit clone https://github.com/clawnchdev/openclawnch.git\ncd openclawnch\npnpm install \u0026\u0026 pnpm build\n\n# Interactive setup -- validates keys live, writes .env:\nopenclawnch init\n\n# Start:\nopenclawnch\n```\n\nMessage your bot. It walks you through onboarding (persona, capabilities, wallet). Run `/setup` in chat to see tool status, `/doctor` for diagnostics.\n\n### Other Install Methods\n\n**Already have OpenClaw?**\n```bash\nopenclaw plugins install @clawnch/openclaw-crypto\n```\n\n**Docker (self-hosted):**\n```bash\ncp deploy/.env.example deploy/.env   # fill in your keys\ndocker compose -f deploy/docker-compose.yml up -d\n```\n\n**Fly.io (one command):**\n```bash\nopenclawnch deploy --telegram-token \"BOT_TOKEN\" --fly-token \"FLY_TOKEN\" --llm-key \"sk-ant-...\"\n```\n\nFull setup guide with all options: **[docs/SETUP.md](docs/SETUP.md)**\n\n## Tools\n\n| Category | Tools | What it does |\n|----------|-------|-------------|\n| **Wallet** | `clawnchconnect`, `transfer`, `permit2`, `approvals` | WalletConnect pairing, ENS transfers, token approvals, spending policies |\n| **Trading** | `defi_swap`, `defi_balance`, `liquidity`, `manage_orders`, `bridge` | 6 DEX aggregators, limit/stop/trailing orders, DCA, cross-chain bridging |\n| **DeFi** | `defi_lend`, `defi_stake`, `yield` | Aave V3 supply/borrow, Lido/Rocket Pool staking, Yearn V3 vaults, live APYs via DeFiLlama |\n| **Market Data** | `defi_price`, `analytics`, `market_intel`, `cost_basis` | RSI/MACD/Bollinger bands, trending tokens, whale activity, FIFO P\u0026L tracking |\n| **Token Launches** | `clawnch_launch`, `clawnch_fees` | Deploy ERC-20s on Base via Clawnch launchpad with Uniswap V4 pools. Fee management |\n| **Bankr** | `bankr_launch`, `bankr_automate`, `bankr_polymarket`, `bankr_leverage` | Custodial wallet, automation rules, Polymarket predictions, leveraged positions |\n| **NFT \u0026 Airdrop** | `nft`, `airdrop` | ERC-721 mint/transfer/burn, airdrop eligibility checking, claim generation |\n| **Security** | `privacy`, `safe` | Privacy-preserving transfers, Gnosis Safe multisig management |\n| **Governance** | `governance`, `farcaster` | DAO proposal voting, Farcaster casting/search/notifications |\n| **On-chain Intel** | `block_explorer`, `herd_intelligence`, `watch_activity`, `browser` | Contract source, token audits, swap monitoring, web browsing |\n| **Automation** | `compound_action` | Multi-step plans with conditionals, time/price/on-chain triggers, cron, parallel execution |\n| **Agent** | `molten`, `clawnx`, `hummingbot`, `wayfinder` | X/Twitter posting, agent-to-agent matching, market-making, route optimization |\n| **Memory** | `agent_memory`, `skill_evolve`, `session_recall` | Persistent memory, self-improvement, session context recall |\n\nFull tool reference: **[docs/TOOLS.md](docs/TOOLS.md)** | All 118 commands: **[docs/COMMANDS.md](docs/COMMANDS.md)**\n\n## Channels\n\n| Channel | Status | Notes |\n|---------|--------|-------|\n| Telegram | Production | Tappable slash commands, deep links, webhooks, streaming responses |\n| Discord | Ready | Slash commands auto-register, thread bindings |\n| Slack | Ready | Works in channels and DMs |\n| Signal | Ready | Requires signal-cli bridge |\n| WhatsApp | Ready | Requires WhatsApp Web bridge |\n| iMessage | Ready | macOS only (bare metal Mac) |\n| LINE | Ready | Requires LINE Messaging API |\n\nAll tools and commands work identically on every channel.\n\n## Wallet Modes\n\n| Mode | Key custody | How it works |\n|------|------------|-------------|\n| **WalletConnect** | Your phone wallet | `/connect` generates a pairing link. Every write transaction goes to your phone for approval. Agent never holds keys. |\n| **Private key** | Local encrypted | BIP-39 mnemonic generated locally, encrypted with scrypt + AES-256-GCM, stored in macOS Keychain or encrypted file. Enables auto-signing below policy thresholds. |\n| **Bankr** | Custodial | `/connect_bankr` or `BANKR_API_KEY`. Multi-chain custodial wallet. Good for automation-heavy setups. |\n\nSpending policies control what the agent can auto-approve: `\"approve swaps under 0.05 ETH, max 10 per hour\"`.\n\nDetails: **[docs/SETUP.md#wallet-modes](docs/SETUP.md#wallet-modes)**\n\n## Automation\n\nThe compound operations engine lets users describe multi-step plans in natural language:\n\n- **Time triggers** -- \"every day at 9am, check ETH price\"\n- **Price triggers** -- \"when ETH drops below $2000, swap 1 ETH to USDC\"\n- **On-chain triggers** -- \"when gas is under 10 gwei, execute the pending swap\"\n- **Conditionals** -- \"if my portfolio is down more than 5%, alert me\"\n- **Loops and parallel execution** -- \"DCA $100 into ETH every week for 12 weeks\"\n\nPlans persist to disk and survive restarts. Managed via `/plans`, `/interrupt_plan`.\n\n## Security\n\n- Agent never holds unencrypted private keys (WalletConnect mode)\n- All write tools are `ownerOnly` -- only the paired account owner can invoke them\n- Credential leak detection on all LLM-bound output\n- Prompt injection resistance guardrails in the system prompt\n- Sequential execution -- never queues multiple transactions\n- Bounded approvals -- exact amounts, never unlimited\n- Endpoint allowlist -- outbound HTTP restricted to curated hosts\n- Transaction verification -- always shows what a tx will do before executing\n\nFull security model: **[docs/SECURITY.md](docs/SECURITY.md)**\n\n## Architecture\n\n```\nopenclawnch (CLI wrapper)\n  └── spawns openclaw gateway\n        └── loads @clawnch/openclaw-crypto (extension)\n              ├── 48 tools (registered via plugin API)\n              ├── 118 commands\n              ├── hooks: gateway_start, message_received, before_prompt_build, after_tool_call\n              └── 76 services (wallet, RPC, price, gas, plans, onboarding, ...)\n```\n\nTwo packages: `openclawnch` (CLI + deploy tooling) and `@clawnch/openclaw-crypto` (standalone extension). The extension registers tools, commands, and hooks through OpenClaw's plugin system. Each user runs their own instance.\n\nThe CLI wrapper handles config patching, `.env` loading, and spawning the OpenClaw gateway. The extension does everything else: wallet management, plan scheduling, onboarding, tool execution.\n\nDetails: **[docs/ARCHITECTURE.md](docs/ARCHITECTURE.md)**\n\n## Configuration\n\n### Required\n\nYou need at least one LLM key and one channel token:\n\n```bash\n# LLM (pick one)\nANTHROPIC_API_KEY=sk-ant-...      # recommended\nOPENROUTER_API_KEY=sk-or-...\nOPENAI_API_KEY=sk-...\nBANKR_LLM_KEY=...                 # pay with crypto\n\n# Channel (pick one)\nTELEGRAM_BOT_TOKEN=123456:ABC...  # from @BotFather\nDISCORD_TOKEN=...\nSLACK_BOT_TOKEN=xoxb-...\n```\n\n### Optional\n\nRPC, DEX APIs, block explorers, price feeds, X/Twitter credentials, and more. See [deploy/.env.example](deploy/.env.example) for the full reference with comments.\n\nThe setup wizard (`openclawnch init`) walks through everything interactively with live key validation.\n\n## Development\n\n```bash\npnpm install\npnpm build                # builds CLI wrapper + crypto extension\npnpm typecheck            # TypeScript 6.0 strict mode\npnpm test                 # 1547 pass, 31 skip, 0 fail (vitest 4)\n```\n\n### Project Structure\n\n```\nbin/openclawnch.mjs           CLI entry point\nsrc/init.ts                   Setup wizard\nsrc/deploy.ts                 Fly.io provisioning\nsrc/wrapper.ts                Library export\nextensions/crypto/\n  index.ts                    Plugin entry -- registers all tools, commands, hooks\n  src/tools/                  48 tool implementations\n  src/commands/               Command handlers\n  src/services/               75 service modules\n  src/hooks/                  Prompt builder, message interceptors\n  src/lib/                    Shared utilities\n  skills/                     Agent skills (bundled)\ndeploy/\n  Dockerfile                  Production container\n  docker-compose.yml          Self-hosted orchestration\n  openclaw.json               Channel + gateway + model config\n  entrypoint.sh               Container bootstrap\n  fly.template.toml           Fly.io template for new deploys\ntests/                        1547 tests across 44 files\n```\n\n### Adding a Tool\n\n```bash\n# 1. Create the tool\ntouch extensions/crypto/src/tools/my-tool.ts\n\n# 2. Register it in index.ts\nimport { myTool } from './src/tools/my-tool.js';\napi.registerTool(myTool);\n\n# 3. Add tests\ntouch tests/my-tool.test.ts\npnpm test\n```\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for the full guide including tool interface shape, service patterns, and testing conventions.\n\n## Issue Reporting\n\nOpenClawnch includes built-in issue reporting. When opted in, the agent proactively suggests filing GitHub issues when it encounters bugs or unexpected behavior.\n\n```\n/report_opt_in              Enable issue reporting\n/report \u003ctitle\u003e | \u003cdesc\u003e    File an issue\n/report_opt_out             Disable\n```\n\n## Tech Stack\n\n| Component | Version |\n|-----------|---------|\n| OpenClaw | 2026.3.28 |\n| Node.js | \u003e= 22.14.0 |\n| TypeScript | 6.0 |\n| viem | 2.47 |\n| MetaMask Delegation SDK | 1.0.0 |\n| vitest | 4.1 |\n\n## Contributing\n\nSee [CONTRIBUTING.md](CONTRIBUTING.md) for development guidelines, testing patterns, and how to add new tools.\n\n## License\n\nMIT -- see [LICENSE](LICENSE).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclawnchdev%2Fopenclawnch","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fclawnchdev%2Fopenclawnch","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fclawnchdev%2Fopenclawnch/lists"}