{"skill":{"slug":"self-improver","displayName":"Self Improving Agent","summary":"Self-improving agent system for OpenClaw. Enables continuous learning from interactions, errors, and recoveries. Automatically improves performance over time.","description":"---\nname: self-improving-agent\ndescription: Self-improving agent system for OpenClaw. Enables continuous learning from interactions, errors, and recoveries. Automatically improves performance over time.\n---\n\n# Self-Improving Agent\n\nA continuous learning agent system for OpenClaw that learns from:\n- ✅ **Interactions** - Learn from every conversation\n- ✅ **Errors** - Learn from mistakes to avoid them\n- ✅ **Recoveries** - Learn what works to recover successfully\n\n---\n\n## ✨ Features\n\n- 🧠 **Continuous Learning** - Learns from every interaction\n- ❌ **Error Learning** - Learns from mistakes to avoid repetition\n- ✅ **Recovery Learning** - Learns successful recovery patterns\n- 🔄 **Auto-Improvement** - Automatically applies improvements\n- 📚 **Memory System** - Stores and retrieves learnings\n- 🔌 **Hook System** - Extensible hook system for custom improvements\n- 📊 **Progress Tracking** - Track improvement over time\n- 🔧 **Python CLI** - Easy to use command-line interface\n- 🧩 **OpenClaw Skill** - Seamless integration with OpenClaw\n\n---\n\n## 🚀 Quick Start\n\n### Prerequisites\n\n- Python 3.10+\n- OpenClaw installed\n- pip or uv package manager\n\n### Installation\n\n#### As OpenClaw Skill\n\n```bash\n# Clone to OpenClaw skills directory\ncd ~/.openclaw/workspace/skills\ngit clone https://github.com/leohuang8688/self-improving-agent.git\n```\n\n**Auto-learning is enabled by default!** After each OpenClaw session, the agent will automatically learn and improve.\n\n#### As Python Package\n\n```bash\n# Clone the repository\ngit clone https://github.com/leohuang8688/self-improving-agent.git\ncd self-improving-agent\n\n# Install with pip\npip install -e .\n\n# Or install with uv\nuv pip install -e .\n```\n\n### Basic Usage\n\n#### Automatic Mode (Recommended)\n\nJust use OpenClaw normally! Learning happens automatically after each session, error, or recovery.\n\n```bash\n# Start OpenClaw\nopenclaw\n\n# Use it normally...\n\n# Exit OpenClaw\n# → Auto-learning triggers automatically!\n```\n\n#### Manual Mode\n\n```bash\n# Run the self-improving agent\npython -m self_improving_agent run\n\n# Learn from last session\npython -m self_improving_agent learn\n\n# Learn from errors\npython -m self_improving_agent learn-errors\n\n# Learn from recoveries\npython -m self_improving_agent learn-recoveries\n\n# Review all learnings\npython -m self_improving_agent review\n\n# Export learnings to file\npython -m self_improving_agent export\n```\n\n---\n\n## 📖 Commands\n\n### `run` - Run the Agent\n\nExecutes the self-improving agent with all applied improvements.\n\n```bash\npython -m self_improving_agent run --workspace /path/to/workspace\n```\n\n### `learn` - Learn from Session\n\nAnalyzes the last session and extracts learnings.\n\n```bash\npython -m self_improving_agent learn --verbose\n```\n\n### `learn-errors` - Learn from Errors\n\nAnalyzes error logs and extracts learnings.\n\n```bash\npython -m self_improving_agent learn-errors --verbose\n```\n\n### `learn-recoveries` - Learn from Recoveries\n\nAnalyzes recovery logs and extracts successful patterns.\n\n```bash\npython -m self_improving_agent learn-recoveries --verbose\n```\n\n### `review` - Review Learnings\n\nReviews all stored learnings.\n\n```bash\npython -m self_improving_agent review --verbose\n```\n\n### `export` - Export Learnings\n\nExports all learnings to a markdown file.\n\n```bash\npython -m self_improving_agent export\n```\n\n---\n\n## 🪝 Hook System\n\n### Available Hooks\n\n#### `onSessionEnd(session)`\n- **Triggered**: When session ends\n- **Purpose**: Post-session learning, cleanup, save state\n- **Parameter**: `session` - Session object\n\n#### `onError(error)`\n- **Triggered**: When an error occurs\n- **Purpose**: Error logging, learning from mistakes\n- **Parameter**: `error` - Error object\n\n#### `onRecovery()`\n- **Triggered**: When recovering from error\n- **Purpose**: Learn successful recovery patterns\n- **Parameter**: None\n\n---\n\n## 📝 Learning Types\n\n### 1. **Session Learning**\n- **Triggered by**: `onSessionEnd`\n- **Learns from**: Conversation patterns, user preferences\n- **Stored in**: `learnings/sessions.json`\n\n### 2. **Error Learning**\n- **Triggered by**: `onError`\n- **Learns from**: Mistakes, errors, failures\n- **Stored in**: `learnings/errors.json`\n- **Purpose**: Avoid repeating mistakes\n\n### 3. **Recovery Learning**\n- **Triggered by**: `onRecovery`\n- **Learns from**: Successful recoveries\n- **Stored in**: `learnings/recoveries.json`\n- **Purpose**: Repeat successful recovery patterns\n\n---\n\n## 📁 Project Structure\n\n```\nself-improving-agent/\n├── src/\n│   ├── hooks.py              # Hook manager\n│   └── ...\n├── hooks/\n│   └── error_learning.py     # Error learning hook\n├── learnings/\n│   ├── sessions.json         # Session learnings\n│   ├── errors.json           # Error learnings\n│   └── recoveries.json       # Recovery learnings\n├── main.py\n├── README.md\n└── SKILL.md\n```\n\n---\n\n## 🔧 Configuration\n\nIn OpenClaw configuration file:\n\n```json\n{\n  \"hooks\": {\n    \"internal\": {\n      \"enabled\": true,\n      \"entries\": {\n        \"self-improve\": {\n          \"enabled\": true\n        },\n        \"error-learning\": {\n          \"enabled\": true\n        }\n      }\n    }\n  }\n}\n```\n\n---\n\n## 📊 Learning Files\n\n### `learnings/errors.json`\n```json\n[\n  {\n    \"timestamp\": \"2026-03-15T12:30:00\",\n    \"error_type\": \"ValueError\",\n    \"error_message\": \"Invalid parameter\",\n    \"context\": {\n      \"traceback\": \"...\"\n    }\n  }\n]\n```\n\n### `learnings/recoveries.json`\n```json\n[\n  {\n    \"timestamp\": \"2026-03-15T12:35:00\",\n    \"recovery_method\": \"automatic_recovery\"\n  }\n]\n```\n\n---\n\n## 🎯 Best Practices\n\n1. **Review learnings regularly** - Review and apply learnings weekly\n2. **Export learnings** - Export learnings for backup\n3. **Apply learnings** - Apply learnings to improve future performance\n4. **Clean old learnings** - Remove outdated learnings periodically\n\n---\n\n## 📝 License\n\nMIT License\n\n## 👨‍💻 Author\n\nPocketAI for Leo - OpenClaw Community\n","tags":{"latest":"3.2.1"},"stats":{"comments":0,"downloads":918,"installsAllTime":35,"installsCurrent":3,"stars":0,"versions":2},"createdAt":1773577006871,"updatedAt":1779000197890},"latestVersion":{"version":"3.2.1","createdAt":1773631170205,"changelog":"- Removed learnings/errors.json, learnings/recoveries.json, and learnings_export.md files.\n- Updated README.md with relevant changes and instructions.\n- No user-facing feature changes; mostly cleanup of redundant or outdated files.","license":"MIT-0"},"metadata":null,"owner":{"handle":"leohuang8688","userId":"s17d3wm8hpf622s897pa0t3kqs83j5z1","displayName":"ClawMem.com","image":"https://avatars.githubusercontent.com/u/262811572?v=4"},"moderation":{"isSuspicious":false,"isMalwareBlocked":false,"verdict":"clean","reasonCodes":["review.llm_review"],"summary":"Review: review.llm_review","engineVersion":"v2.4.24","updatedAt":1780089910757}}