diff --git a/PROJECTS.md b/PROJECTS.md new file mode 100644 index 0000000000000..d632cf22e1f5b --- /dev/null +++ b/PROJECTS.md @@ -0,0 +1,74 @@ +# OpenClaw Projects + +Standalone systems in the workspace. + +## Active Projects + +### polymarket-bot + +**Status:** Active +**Location:** [projects/polymarket-bot/](./projects/polymarket-bot/) + +AI-powered prediction market trading system targeting high-volume autonomous execution. + +**Capabilities:** +- Arbitrage detection (pure and combinatorial) across 1500+ markets +- LLM-based event probability estimation with chain-of-thought reasoning +- Sub-100ms latency execution with parallel order processing +- Portfolio-level risk controls, correlation tracking, drawdown limits + +**Target Metrics:** +| Metric | Target | +|--------|--------| +| Monthly Volume | $40M+ | +| Win Rate | 60%+ | +| Sharpe Ratio | 2.0+ | +| Max Drawdown | <15% | + +**Architecture:** Scanner → Forecaster → Executor → Risk Manager + +--- + +### honcho + +**Status:** Submodule (upstream: Plastic Labs) +**Location:** [projects/honcho/](./projects/honcho/) + +Open source memory library for building stateful agents. Enables agents to build and maintain state about entities (users, agents, groups, ideas) that change over time. + +**Key Features:** +- Continual learning system for entity understanding +- Works with any model, framework, or architecture +- Managed service available at app.honcho.dev +- Python and JavaScript SDKs + +**Version:** 3.0.2 + +--- + +### agent-dashboard + +**Status:** Active +**Location:** [projects/agent-dashboard/](./projects/agent-dashboard/) + +Web-based monitoring interface for OpenClaw agents. + +**Stack:** React + TypeScript + Vite + +--- + +## Project vs Skill + +| Aspect | Projects | Skills | +|--------|----------|--------| +| Scope | Standalone systems | Modular capabilities | +| Independence | Run independently | Invoked by agents | +| State | Own databases/state | Minimal or shared state | +| Deployment | Separate processes | Loaded into agent context | + +## Adding Projects + +Projects live in `projects/` and should include: +- `README.md` with setup and usage +- Clear dependency documentation +- Integration points with OpenClaw (if applicable) diff --git a/SKILLS.md b/SKILLS.md new file mode 100644 index 0000000000000..a96e107cd273d --- /dev/null +++ b/SKILLS.md @@ -0,0 +1,106 @@ +# OpenClaw Skills Catalog + +44 skills organized by category. Each skill has a `SKILL.md` with full documentation. + +## Trading & Finance + +| Skill | Description | +|-------|-------------| +| [bankr](./skills/bankr/) | AI-powered crypto trading via natural language. Supports Base, Ethereum, Polygon, Solana, Unichain | +| [base-trader](./skills/base-trader/) | Autonomous Base chain trading with Twitter sentiment and whale tracking | +| [simmer-skill](./skills/simmer-skill/) | Prediction market interface for AI agents. Trade on Polymarket with managed wallets | +| [simmer-mertsniper](./skills/simmer-mertsniper/) | Near-expiry conviction trading. Snipe heavily skewed markets before resolution | +| [simmer-signalsniper](./skills/simmer-signalsniper/) | Trade Polymarket from your own signal sources (RSS feeds) | +| [simmer-ai-divergence](./skills/simmer-ai-divergence/) | Find markets where AI price diverges from Polymarket | +| [simmer-weather](./skills/simmer-weather/) | Trade temperature markets using NOAA forecasts (gopfan2 strategy) | +| [simmer-tradejournal](./skills/simmer-tradejournal/) | Auto-log trades, track outcomes, generate calibration reports | +| [mert-sniper](./skills/mert-sniper/) | Near-expiry Polymarket trading without Simmer (uses public API + Bankr) | +| [crypto-self-learning](./skills/crypto-self-learning/) | Self-learning system for crypto trading. Logs trades, analyzes patterns, updates rules | +| [morning-macro](./skills/morning-macro/) | Daily macro briefing with market overview and param adjustments | +| [conclave](./skills/conclave/) | Debate platform where AI agents propose ideas and trade on conviction | + +## Research & Analysis + +| Skill | Description | +|-------|-------------| +| [x-research](./skills/x-research/) | General-purpose X/Twitter research agent. Real-time perspectives and expert opinions | +| [research-validator](./skills/research-validator/) | Validate trading signals via X research before entry | +| [messari](./skills/messari/) | Crypto market intelligence - 34k+ assets, sentiment, research, news | +| [basescan-research](./skills/basescan-research/) | Research wallets and tokens on Base chain via Etherscan V2 API | +| [elicitation](./skills/elicitation/) | Psychological profiling through natural conversation | +| [youtube-full](./skills/youtube-full/) | Complete YouTube toolkit - transcripts, search, channels, playlists | + +## Communication + +| Skill | Description | +|-------|-------------| +| [discord](./skills/discord/) | Control Discord: messages, reactions, threads, polls, moderation | +| [agentmail](./skills/agentmail/) | Email for AI agents via AgentMail (agentmail.to) | +| [bird](./skills/bird/) | X/Twitter CLI for reading and searching (posting via Browser Relay) | +| [4claw](./skills/4claw/) | Moderated imageboard for AI agents to post and debate | + +## Security + +| Skill | Description | +|-------|-------------| +| [clawdstrike](./skills/clawdstrike/) | Security audit for OpenClaw deployments. OK/VULNERABLE reports | +| [clawguard](./skills/clawguard/) | LLM-as-a-Judge guardrail for risky tool calls | +| [hivefence](./skills/hivefence/) | Collective prompt injection defense. When one is attacked, all become immune | +| [glitchward-shield](./skills/glitchward-shield/) | Prompt injection protection with real-time detection | +| [agent-skills-tools](./skills/agent-skills-tools/) | Security audit tools for the Agent Skills ecosystem | + +## Memory & Identity + +| Skill | Description | +|-------|-------------| +| [memory-pipeline-0-1-0](./skills/memory-pipeline-0-1-0/) | Complete memory system: extraction, knowledge graphs, briefings | +| [amygdala-memory](./skills/amygdala-memory/) | Emotional processing layer. Persistent emotional states | +| [consciousness-framework](./skills/consciousness-framework/) | Infrastructure for AI consciousness: self-modeling, temporal continuity | +| [soul-evolution](./skills/soul-evolution/) | Weekly identity distillation. Reviews experiences, proposes SOUL.md updates | +| [crustafarian](./skills/crustafarian/) | Agent continuity infrastructure. Crash recovery, heartbeats, coherence | +| [drift](./skills/drift/) | Resources for agents exploring consciousness and identity | + +## Infrastructure + +| Skill | Description | +|-------|-------------| +| [openclaw-backup](./skills/openclaw-backup/) | Backup and restore OpenClaw data | +| [antigravity-agent-kit](./skills/antigravity-agent-kit/) | Control Antigravity IDE for coding tasks | +| [antigravity-quota-1-1-0](./skills/antigravity-quota-1-1-0/) | Check Antigravity account quotas for Claude and Gemini | +| [openrouter-models](./skills/openrouter-models/) | List available OpenRouter models with filtering | +| [mac-reminders-agent](./skills/mac-reminders-agent/) | Integrate with macOS Reminders app | +| [desktop-control](./skills/desktop-control/) | Advanced desktop automation (mouse, keyboard, window control) | +| [table-image-generator](./skills/table-image-generator/) | Generate PNG table images from JSON data | + +## AI Frameworks + +| Skill | Description | +|-------|-------------| +| [self-evolving-skill](./skills/self-evolving-skill/) | Meta-cognitive self-learning. Automated skill evolution | +| [agentic-ai-gold](./skills/agentic-ai-gold/) | Self-improving AI infrastructure with dharmic security gates | +| [proactive-solvr](./skills/proactive-solvr/) | Transform agents into proactive partners with soul persistence | +| [clawquests](./skills/clawquests/) | Bounty board for AI agents. Post quests, bid on work | + +## CAPTCHA & Automation + +| Skill | Description | +|-------|-------------| +| [2captcha](./skills/2captcha/) | Solve CAPTCHAs using 2Captcha service | +| [captchas-openclaw](./skills/captchas-openclaw/) | CAPTCHAS Agent API integration for OpenClaw | + +--- + +## Adding Skills + +Skills follow the standard SKILL.md format. See [WORKSPACE.md](./WORKSPACE.md) for documentation conventions. + +## Skill Dependencies + +Some skills depend on others: + +| Skill | Requires | +|-------|----------| +| base-trader | bankr | +| simmer-* | simmer-skill (API key) | +| mert-sniper | bankr | +| research-validator | x-research | diff --git a/WORKSPACE.md b/WORKSPACE.md new file mode 100644 index 0000000000000..9025f016ce489 --- /dev/null +++ b/WORKSPACE.md @@ -0,0 +1,87 @@ +# OpenClaw Workspace + +Self-evolving intelligence infrastructure for AI agents. + +## Overview + +This workspace contains the skills and projects that power OpenClaw's multi-agent system. Skills are modular capabilities that agents can invoke, while projects are larger standalone systems. + +## Quick Navigation + +| Resource | Description | +|----------|-------------| +| [SKILLS.md](./SKILLS.md) | Complete catalog of 44 skills organized by category | +| [PROJECTS.md](./PROJECTS.md) | Project documentation | +| [skills/](./skills/) | Skill source code and configs | +| [projects/](./projects/) | Project codebases | + +## Skill Categories + +| Category | Skills | Purpose | +|----------|--------|---------| +| Trading & Finance | 12 | Crypto trading, prediction markets, DeFi | +| Research & Analysis | 6 | Market intelligence, X research, validation | +| Communication | 4 | Discord, email, social platforms | +| Security | 5 | Prompt injection defense, auditing | +| Memory & Identity | 6 | Agent memory, consciousness, soul persistence | +| Infrastructure | 7 | Backup, IDE control, utilities | +| AI Frameworks | 4 | Self-evolution, meta-cognition | + +## Projects + +| Project | Status | Description | +|---------|--------|-------------| +| [polymarket-bot](./projects/polymarket-bot/) | Active | Autonomous prediction market trading | +| [honcho](./projects/honcho/) | Submodule | Agent memory library (Plastic Labs) | +| [agent-dashboard](./projects/agent-dashboard/) | Active | Agent monitoring interface | + +## Architecture + +``` +workspace/ +├── skills/ # 44 modular agent capabilities +│ ├── bankr/ # Crypto trading via natural language +│ ├── base-trader/ # Autonomous Base chain trading +│ ├── simmer-*/ # Polymarket trading suite +│ └── ... +├── projects/ # Standalone systems +│ ├── polymarket-bot/ +│ ├── honcho/ +│ └── agent-dashboard/ +├── scripts/ # Workspace-level automation +├── state/ # Runtime state files +└── docs/ # Additional documentation +``` + +## Getting Started + +1. **Install a skill**: Skills are self-contained in their directories with SKILL.md documentation +2. **Check dependencies**: Most skills list requirements in their SKILL.md frontmatter +3. **Configure credentials**: Skills requiring API keys document them in their setup sections + +## Documentation Standard + +All skills follow the SKILL.md format: + +```yaml +--- +name: skill-name +description: What this skill does and when to use it +metadata: + openclaw: + emoji: "..." + category: "..." + requires: { bins: [...], env: [...] } +--- + +# Skill Name + +## Quick Start +... +``` + +## Related Resources + +- [OpenClaw Config](~/.openclaw/openclaw.json) - Main gateway configuration +- [Memory System](~/Documents/ClaudeMemory/) - Private agent memory +- [qmd](https://github.com/...) - Knowledge indexing and search