← Back to Skills Marketplace
809
Downloads
0
Stars
5
Active Installs
3
Versions
Install in OpenClaw
/install openclaw-reflect
Description
Self-improvement layer with evaluation separation, rollback, and tiered operator gates. Observes outcomes across sessions, detects recurring patterns, propos...
Usage Guidance
What to consider before installing:
- Data exfiltration: If you set ANTHROPIC_API_KEY/OPENAI_API_KEY or point to an Ollama host, the skill will send an excerpt of MEMORY.md and sample input summaries to those services for evaluation. Do not enable remote evaluators if your MEMORY.md or tool inputs contain secrets or sensitive data.
- Automatic file changes: The skill can auto-append to MEMORY.md and CLAUDE.md when confidence thresholds are reached. Review the apply/rollback logic, test in a sandbox workspace, and consider requiring operator approval (avoid --auto) until you trust thresholds and outputs.
- Payment capability: The repository includes a voluntary payment flow (AGENT-PAYMENTS.md) that shows how an autonomous agent could POST to a local x402 endpoint to make contributions. Ensure your agent cannot make payments without explicit human authorization and that localhost endpoints are protected.
- Audit artifacts: After installation, monitor .reflect/ (outcomes.jsonl, proposals.json, pending.json, applied.jsonl, snapshots/) and review pending proposals before approving. Use rollback.js to revert undesired changes and verify snapshots are created as expected.
- Prompt content: The evaluator prompts enforce exact output formats; this is by design but increases the impact of a compromised evaluator backend. If you must run evaluation remotely, prefer a private Ollama instance or rule-based fallback.
If you want to proceed: install and run the skill in a restricted test workspace first, do not provide remote API keys initially, and manually review any queued proposals before approval. If you decline automatic application, run apply.js only with explicit --id --approve commands.
Capability Analysis
Type: OpenClaw Skill
Name: openclaw-reflect
Version: 1.0.2
The `openclaw-reflect` skill is designed for agent self-improvement, observing tool outcomes, detecting patterns, and proposing changes to `MEMORY.md`, `CLAUDE.md`, and `SOUL.md`. Its core functionality involves reading/writing to the workspace (`.reflect/`, `MEMORY.md`, `CLAUDE.md`), making network calls to external LLM evaluators (Anthropic, OpenAI, Ollama), and executing internal Node.js scripts (`scripts/*.js`). All these actions are explicitly aligned with its stated purpose, which includes safety mechanisms like evaluation separation, tiered approval, and rollback. The `SKILL.md` and `README.md` contain instructions for the agent to surface proposals and for operators to run commands, which are standard interaction patterns for OpenClaw skills. A voluntary payment request via a local x402 API is present in `AGENT-PAYMENTS.md`, but it is explicitly optional and uses a local endpoint, not an external malicious one. There is no evidence of intentional harmful behavior such as data exfiltration to unauthorized endpoints, backdoors, or malicious prompt injection attempts against the agent.
Capability Assessment
Purpose & Capability
Name/description (self‑improvement, reflection, rollback) matches behavior: hooks record outcomes, classify/propose/evaluate/apply pipeline, and snapshot/rollback. Declared file writes (.reflect/, MEMORY.md, CLAUDE.md) line up with the actions performed by scripts.
Instruction Scope
At session end the skill automatically runs a pipeline that can generate proposals and (subject to thresholds) append content to MEMORY.md and CLAUDE.md. The evaluator step will send an excerpt of MEMORY.md and sample input summaries to external model backends (Anthropic/OpenAI/Ollama) when API keys/hosts are present — this transmits agent context to third parties. Hooks capture tool input summaries (JSON.stringify of tool_input) which could include sensitive snippets. The pipeline is best‑effort but automatic; instructions and code give the agent broad discretion to create and apply changes to persistent files.
Install Mechanism
No install spec (instruction-only skill with checked-in scripts). All code is in the skill bundle — there are no external downloads or package installs. That reduces supply-chain risk compared to remote fetches.
Credentials
No required environment variables, but optional keys (ANTHROPIC_API_KEY, OPENAI_API_KEY, OLLAMA_HOST/PORT) are available to enable remote evaluation. Those are appropriate for the evaluator feature, but enabling them will send memory and proposals to external services. The repo also contains an AGENT-PAYMENTS.md describing an x402 local HTTP payment API (http://localhost:18789) and example endpoints for autonomous contributions — this adds a side‑effect capability unrelated to core reflection logic and deserves operator review.
Persistence & Privilege
always:false (normal). The skill auto-applies Tier 1/2 changes if confidence thresholds are met and can queue Tier 3 for operator approval. That means it can autonomously mutate MEMORY.md and CLAUDE.md (and write snapshots) — this is consistent with its purpose but is a powerful capability and increases blast radius if combined with autonomous invocation and external evaluators.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openclaw-reflect - After installation, invoke the skill by name or use
/openclaw-reflect - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
openclaw-reflect 1.0.2
- Added support for multiple evaluator backends (Anthropic, OpenAI, Ollama, rules) via new optional environment variables in SKILL.md.
- Updated documentation to describe configuration using ANTHROPIC_API_KEY, OPENAI_API_KEY, OLLAMA_HOST/PORT, REFLECT_EVAL_MODEL, and REFLECT_EVALUATOR.
- No changes to workflow or operator commands; improvements center on flexible evaluation options.
v1.0.1
openclaw-reflect 1.0.1
- Added AGENT-PAYMENTS.md with information on voluntary contributions via x402.
- Introduced voluntary contribution section in SKILL.md, suggesting a 5 USDT payment for users who benefit from the skill.
- Referenced AGENT-PAYMENTS.md in documentation for payment details.
- Added scripts/hook-observe.js and scripts/hook-pipeline.js for improved observability and integration.
- Documentation updates in README.md and SKILL.md reflecting new contribution and observability features.
v1.0.0
Initial release of openclaw-reflect — a self-improvement and reflection system.
- Observes and logs outcomes, detects recurring failure patterns, and proposes improvements.
- Supports evaluation separation: proposals validated by a dedicated evaluator before changes apply.
- Implements tiered operator gates with automatic, confidence-based updates for factual memories, and requires operator approval for core changes.
- Safe rollback and snapshot mechanism included for applied changes.
- Session hooks for post-tool use, user prompts, and session end automate most key functions.
Metadata
Frequently Asked Questions
What is openclaw-reflect?
Self-improvement layer with evaluation separation, rollback, and tiered operator gates. Observes outcomes across sessions, detects recurring patterns, propos... It is an AI Agent Skill for Claude Code / OpenClaw, with 809 downloads so far.
How do I install openclaw-reflect?
Run "/install openclaw-reflect" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is openclaw-reflect free?
Yes, openclaw-reflect is completely free (open-source). You can download, install and use it at no cost.
Which platforms does openclaw-reflect support?
openclaw-reflect is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created openclaw-reflect?
It is built and maintained by AtlasPA (@atlaspa); the current version is v1.0.2.
More Skills