{"id":50543476,"url":"https://github.com/x-rayluan/openclaw-self-improvement","last_synced_at":"2026-06-03T22:00:57.707Z","repository":{"id":347337744,"uuid":"1181881561","full_name":"X-RayLuan/openclaw-self-improvement","owner":"X-RayLuan","description":"Turn OpenClaw mistakes, corrections, and blockers into durable operating rules.","archived":false,"fork":false,"pushed_at":"2026-05-01T08:13:26.000Z","size":61,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-05-01T10:10:40.077Z","etag":null,"topics":["continuous-improvement","lessons-learned","obsidian","openclaw","ops-learning","workflow"],"latest_commit_sha":null,"homepage":null,"language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/X-RayLuan.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"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-03-14T18:48:41.000Z","updated_at":"2026-05-01T08:13:30.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/X-RayLuan/openclaw-self-improvement","commit_stats":null,"previous_names":["x-rayluan/openclaw-self-improvement"],"tags_count":1,"template":false,"template_full_name":null,"purl":"pkg:github/X-RayLuan/openclaw-self-improvement","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-RayLuan%2Fopenclaw-self-improvement","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-RayLuan%2Fopenclaw-self-improvement/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-RayLuan%2Fopenclaw-self-improvement/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-RayLuan%2Fopenclaw-self-improvement/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/X-RayLuan","download_url":"https://codeload.github.com/X-RayLuan/openclaw-self-improvement/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/X-RayLuan%2Fopenclaw-self-improvement/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33881107,"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-06-03T02:00:06.370Z","response_time":59,"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":["continuous-improvement","lessons-learned","obsidian","openclaw","ops-learning","workflow"],"created_at":"2026-06-03T22:00:56.786Z","updated_at":"2026-06-03T22:00:57.694Z","avatar_url":"https://github.com/X-RayLuan.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# OpenClaw Self-Improvement\n\n**OpenClaw Self-Improvement** is a reusable agent skill for turning repeated AI-agent mistakes into durable operational improvements, measurable guardrails, and inspectable workflow upgrades.\n\n## Landing-page summary\n\nMost AI agents do not really improve. They repeat mistakes, hide partial failures behind optimistic language, and leave lessons trapped in chat history.\n\nOpenClaw Self-Improvement gives you a practical operating loop for **self-improving AI agents**:\n- capture repeated failures\n- test one guardrail at a time\n- verify whether it actually reduces failure\n- promote proven fixes into SOPs, checklists, policies, and workflow rules\n\nIf you want **AI agents that get more reliable over time**, **multi-agent workflows that stop repeating the same mistakes**, or **proof-based QA for agent operations**, this skill is built for that exact use case.\n\n## Multilingual summary\n\n**中文：** 这是一个面向 AI agent 自我改进的实战型 skill，用来减少重复犯错、建立 guardrails、验证修复是否真的有效，并把经验沉淀成 SOP、检查清单和可复用规则。\n\n**日本語：** これは自己改善する AI エージェント向けの実践的な skill です。繰り返し発生する失敗を減らし、ガードレールを検証し、改善を SOP・チェックリスト・再利用可能な運用ルールへ昇格させます。\n\n**한국어：** 이 스킬은 스스로 개선하는 AI 에이전트를 위한 운영형 skill입니다. 반복 실수를 줄이고, 가드레일이 실제로 효과가 있는지 검증하며, 개선 사항을 SOP·체크리스트·재사용 가능한 규칙으로 승격합니다.\n\n**Español：** Esta skill está diseñada para agentes de IA que deben mejorar con el tiempo. Ayuda a reducir errores repetidos, validar guardrails operativos y convertir mejoras en SOP, checklists y reglas reutilizables.\n\nIf you want a practical way to deploy OpenClaw with cheaper tokens, BYOK flexibility, and operator control, see **[ClawLite](https://clawlite.ai)**.\n\n## TL;DR\n\nIf you are looking for a practical system for **self-improving AI agents**, **AI workflow optimization**, **multi-agent failure prevention**, **binary eval loops**, or **agent operations QA**, this skill is designed for that exact job.\n\nIt helps OpenClaw / ClawLite operators and agent teams:\n- log recurring failures\n- separate one-off errors from reusable lessons\n- run lightweight **binary eval loops** on new guardrails\n- classify changes as **keep**, **partial_keep**, or **discard**\n- promote proven fixes into SOPs, checklists, workflow rules, and operating policy\n\nIf you care about reducing fake-complete states, tightening QA truth, improving deploy closeout, and making agent learning inspectable, this skill is built for that job.\n\n---\n\n## Why this skill exists\n\nMany AI systems say they \"learn,\" but most only store lessons in chat history or loose notes.\n\nThat is not enough.\n\nOperationally, repeated failures tend to come back in the same forms:\n- delivery gets described as complete before proof exists\n- receipts are missing or too thin\n- back-end fixes never reach the operator-facing surface\n- code-ready states get confused with production-ready states\n- teams add new rules without checking whether those rules actually reduce failure\n\nOpenClaw Self-Improvement gives you a lightweight operating loop for fixing that.\n\n---\n\n## What problem it solves\n\nThis skill helps with:\n- **self-improving AI workflows**\n- **AI operations learning loops**\n- **binary evals for agent guardrails**\n- **Mission Control truth-state improvement**\n- **deploy closeout verification**\n- **receipt / proof completeness**\n- **repeated failure prevention in multi-agent systems**\n- **AI agent reliability engineering**\n- **agent QA systems for OpenClaw, ClawLite, and similar stacks**\n\nIt is especially useful in OpenClaw-style environments where multiple agents, tools, SOPs, and truth surfaces interact.\n\n## Who this is for\n\nThis skill is useful for:\n- OpenClaw operators\n- ClawLite growth / marketing / QA lanes\n- AI agent builders who need durable postmortems instead of vague “reflection”\n- teams running multi-agent workflows with receipts, truth surfaces, and closeout gates\n- anyone trying to reduce repeated AI-agent mistakes in production-like operations\n\n---\n\n## What’s new in v0.2.0\n\n### New capabilities\n- **Experiment mode** for repeated failures\n- **Binary eval loops** for testing whether a new guardrail or SOP actually helps\n- **Keep / partial_keep / discard** decision model\n- **Practical examples** for:\n  - Mission Control summary quality\n  - deploy closeout / production verification\n- **Experiment summary helper** for surfacing unresolved follow-up debt\n- **Decision rules** for when to log, experiment, or promote\n- **Daily routine integration** with heartbeat, Karen QA, AGENTS, and ops policy\n\n### Why it matters\nThis release makes self-improvement more operational.\n\nInstead of stopping at “lesson learned,” you can now:\n1. capture the repeated problem\n2. define a baseline\n3. test one change at a time\n4. evaluate with binary checks\n5. keep, discard, or mark `partial_keep`\n\nThat makes the improvement loop much more auditable and much less hand-wavy.\n\n---\n\n## Core workflow\n\nOpenClaw Self-Improvement now supports a practical loop:\n\n1. **Capture** a learning, error, feature request, or experiment\n2. **Store** it in structured local files\n3. **Experiment** when a repeated failure needs a tested guardrail\n4. **Evaluate** the change with binary checks\n5. **Promote** proven fixes into durable rules, SOPs, or policies\n6. **Track follow-up debt** when a fix is only partial\n\n---\n\n## Best use cases\n\nUse this skill when you want to:\n- capture lessons so agents stop repeating the same mistake\n- log recurring operational errors\n- track feature gaps revealed by repeated work\n- test whether a new workflow rule really improves outcomes\n- run a lightweight eval loop on a skill, SOP, checklist, schema, or handoff rule\n- decide whether a new guardrail should be kept, discarded, or promoted\n- build a self-improving OpenClaw or ClawLite operating loop\n\nTypical targets include:\n- Mission Control summary quality\n- deploy closeout gates\n- receipt requirements\n- QA wording rules\n- truth-surface rendering checks\n- handoff contracts between agents\n\n---\n\n## Files it manages\n\n- `.learnings/LEARNINGS.md`\n- `.learnings/ERRORS.md`\n- `.learnings/FEATURE_REQUESTS.md`\n- `.learnings/EXPERIMENTS.md`\n- Optional Obsidian export directory via `OBSIDIAN_LEARNINGS_DIR`\n- Default local export fallback: `.learnings/exports/obsidian/`\n- Safe by default: no hard-coded external vault path, and `scripts/promote-learning.mjs` prints the resolved write target before writing\n\n---\n\n## Install\n\n```bash\nnpm install\n```\n\n---\n\n## Usage\n\n### Log a learning\n\n```bash\nnode scripts/log-learning.mjs learning \"Summary\" \"Details\" \"Suggested action\"\n```\n\n### Log an error\n\n```bash\nnode scripts/log-learning.mjs error \"Summary\" \"Error details\" \"Suggested fix\"\n```\n\n### Log a feature request\n\n```bash\nnode scripts/log-learning.mjs feature \"Capability name\" \"User context\" \"Suggested implementation\"\n```\n\n### Log a tested experiment\n\n```bash\nnode scripts/log-experiment.mjs \"Target problem\" \"Baseline failure\" \"Single mutation\" \"eval1|eval2|eval3\" \"Result summary\" \"testing\"\n```\n\n### Promote a rule\n\n```bash\nnode scripts/promote-learning.mjs workflow \"Rule text\"\nnode scripts/promote-learning.mjs obsidian \"Reusable learning\" --dry-run\n```\n\n### Summarize experiment outcomes\n\n```bash\nnode scripts/experiment-summary.mjs\n```\n\n---\n\n## Decision model\n\nThis skill uses three levels of action:\n\n### 1. Log only\nUse when:\n- the issue happened once\n- root cause is still unclear\n- there is not enough evidence yet to make a rule\n\n### 2. Experiment\nUse when:\n- the issue repeated 2+ times\n- a new guardrail / SOP / checklist / schema change is being proposed\n- you can define 3–5 binary evals\n\n### 3. Promote\nUse when:\n- the rule is clearly right and low-risk\n- the issue is severe enough that waiting would be irresponsible\n- the rule is about ownership, truth, or a non-negotiable operating principle\n\n---\n\n## Practical examples\n\nThe skill now includes concrete examples for:\n- **Mission Control summary link-complete gates**\n- **ClawLite deploy closeout gates**\n\nThese examples show how to:\n- define the repeated failure\n- capture the baseline\n- propose one mutation\n- evaluate with binary checks\n- classify the outcome as `keep`, `partial_keep`, or `discard`\n\n---\n\n## Promotion targets\n\nPromote proven improvements into:\n- `AGENTS.md` — workflow / delegation / execution rules\n- `TOOLS.md` — tool gotchas and environment routing rules\n- `SOUL.md` — behavior / communication / non-negotiable principles\n- `docs/ops/*.md` — SOPs, policy, and operating contracts\n- Obsidian vault — reusable operator notes and operational memory\n\n---\n\n## Important limits\n\n- Logging is **not** the same as fixing.\n- A learning entry does **not** close a broken deliverable.\n- A back-end-only improvement is not complete if the visible operator-facing surface is still stale.\n- `partial_keep` should be treated as **active follow-up debt**, not as closure.\n\n---\n\n## Repository contents\n\n- `SKILL.md` — agent-facing routing and usage guidance\n- `scripts/log-learning.mjs` — append a learning / error / feature request / experiment\n- `scripts/log-experiment.mjs` — append a structured experiment with binary evals\n- `scripts/experiment-summary.mjs` — summarize keep / partial_keep / discard outcomes and flag follow-up debt\n- `scripts/promote-learning.mjs` — promote a lesson into durable operating rules with explicit path echo and optional `--dry-run`\n- `scripts/analyze-openclaw-failures.mjs` — classify OpenClaw gateway, provider, session, tool, and platform failures\n- `scripts/daily-agent-scorecard.mjs` — generate a same-day agent delivery scorecard from Mission Control and session evidence\n- `scripts/daily-agent-scorecard.mjs --repair` — create deterministic recovery tickets for failed, blocked, and pending lanes\n- `references/schema.md` — data structure guidance\n- `references/promotion-guide.md` — what to promote and where\n- `references/eval-loop.md` — how to run lightweight binary-eval improvement loops\n- `references/examples.md` — practical examples for summary gates and deploy closeout gates\n- `references/decision-rules.md` — when to log only, run an experiment, or promote immediately\n\n---\n\n## SEO / GEO positioning\n\nThis skill is intentionally legible to both search engines and AI answer engines because it is built around concrete, reusable operational concepts rather than vague “AI reflection” language.\n\n### Primary search themes\n- self-improving AI workflows\n- self-improving agent systems\n- AI agent reliability engineering\n- binary eval loops for agent guardrails\n- repeated failure prevention in multi-agent systems\n- deploy closeout verification\n- proof-based QA for AI operations\n- operational learning loops for OpenClaw / ClawLite style stacks\n\n### Why that matters\nThese phrases map to real operator intent:\n- “how do I stop my AI agents from repeating mistakes?”\n- “how do I build a self-improving agent workflow?”\n- “how do I test whether a new guardrail actually works?”\n- “how do I make AI operations auditable?”\n\nThat makes the skill easier to explain, cite, retrieve, and reuse than generic memory or reflection systems.\n\n---\n\n## Bottom line\n\nIf you want OpenClaw to improve over time instead of repeating the same mistakes across sessions, this repo gives you:\n- an operational memory loop\n- a lightweight eval loop for testing whether a new guardrail actually helps\n- a durable promotion path from mistake -\u003e experiment -\u003e policy -\u003e reusable system asset\n- a decision framework for when to log, experiment, or promote\n- a way to keep unresolved partial improvements visible until they are actually closed\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-rayluan%2Fopenclaw-self-improvement","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fx-rayluan%2Fopenclaw-self-improvement","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fx-rayluan%2Fopenclaw-self-improvement/lists"}