This is the repository-wide contract. Detailed implementation documents are read only for the task at hand. User working agreements still apply. Before editing, read the local AGENTS.md for each touched area and for both sides of an interface change. Read its README, then only the linked mechanism documents relevant to the task. Do not assume every client loads nested instructions from the root automatically. Code and tests establish shipped behavior; archive/proposal documents do not override it. Other area entry points…
Steady2 mentions in 2 weeks
No other project uses it yet
3.4k26d agoReviewMountCreate a free account to mount
Operating instructions for AI coding agents in this repository. Everything here applies to every task. Anything that applies only sometimes lives behind a link — follow the link when the…
No other project uses it yet
1.8k7mo agoReviewMountCreate a free account to mount
End-to-end Parallels smoke, upgrade, and rerun workflow for OpenClaw across macOS, Windows, and Linux guests. Use when Codex needs to run, rerun, debug, or interpret VM-based install, onboarding, gateway smoke tests, latest-release-to-main upgrade checks, fresh snapshot retests, or optional Discord roundtrip verification under Parallels.
Maintainer workflow for reviewing, triaging, preparing, closing, or landing OpenClaw pull requests and related issues. Use when Codex needs to validate bug-fix claims, search for related issues or PRs, apply or recommend close/reason labels, prepare GitHub comments safely, check review-thread follow-up, or perform maintainer-style PR decision making before merge or closure.
Run, watch, debug, and extend OpenClaw QA testing with qa-lab and qa-channel. Use when Codex needs to execute the repo-backed QA suite, inspect live QA artifacts, debug failing scenarios, add new QA scenarios, or explain the OpenClaw QA workflow. Prefer the live OpenAI lane with regular openai/gpt-5.4 in fast mode; do not use gpt-5.4-pro or gpt-5.4-mini unless the user explicitly overrides that policy.
Maintainer workflow for OpenClaw releases, prereleases, changelog release notes, and publish validation. Use when Codex needs to prepare or verify stable or beta release steps, align version naming, assemble release notes, check release auth requirements, or validate publish-time commands and artifacts.
3257mo agoReviewMountCreate a free account to mount
Investigate `pnpm test` memory growth, Vitest worker OOMs, and suspicious RSS increases in OpenClaw using the `scripts/test-parallel.mjs` heap snapshot tooling. Use when Codex needs to reproduce test-lane memory growth, collect repeated `.heapsnapshot` files, compare snapshots from the same worker PID, triage likely transformed-module retention versus likely runtime leaks, and fix or reduce the impact by patching cleanup logic or isolating hotspot tests.
3257mo agoReviewMountCreate a free account to mount
Run the macOS Parallels smoke harness with Discord end-to-end roundtrip verification, including guest send, host verification, host reply, and guest readback.
Triage GitHub security advisories for OpenClaw with high-confidence close/keep decisions, exact tag and commit verification, trust-model checks, optional hardening notes, and a final reply ready to post and copy to clipboard.
3257mo agoReviewMountCreate a free account to mount
Update and maintain the Electron desktop OpenClaw bundle script (prepare-openclaw-bundle.mjs). Use when openclaw core dependencies change, new native/CJS packages are added, esbuild bundling breaks, or the bundle size grows unexpectedly.
3257mo agoReviewMountCreate a free account to mount
This directory contains bundled plugins. Treat it as the same boundary that third-party plugins see. - Extension production code should import from openclaw/plugin-sdk/* and its own local barrels such as ./api.ts and ./runtime-api.ts. - Do not import core internals from src/, src/channels/, src/plugin-sdk-internal/, or another extension's src/. - Do not use relative imports that escape the current extension package root. - Keep plugin metadata accurate in openclaw.plugin.json and the package openclaw block so discovery and setup work without executing plugin…
3257mo agoReviewMountCreate a free account to mount
Set up and use 1Password CLI (op). Use when installing the CLI, enabling desktop app integration, signing in (single or multi-account), or reading/injecting/running secrets via op.
Manage Apple Notes via the `memo` CLI on macOS (create, view, edit, delete, search, move, and export notes). Use when a user asks OpenClaw to add a note, list notes, search notes, or manage note folders.
3257mo agoReviewMountCreate a free account to mount
Plain text files in a repository that tell a coding agent how the project works: commands to run, conventions to follow and things to avoid. CLAUDE.md, AGENTS.md, cursor rules and skills are the common kinds.
CLAUDE.md or AGENTS.md?
CLAUDE.md is read by Claude Code. AGENTS.md is an open format that Codex, Cursor and other agents read. Many projects keep one and point the other at it.
What is a skill?
A folder with a SKILL.md that describes one capability, such as filling PDFs or reviewing code. The agent loads it only when the task calls for it.
Can I search my own team's files too?
Your agents already can, over MCP, limited to the files you're allowed to read. Searching them from this page is coming.
AtomicBot-aiAGENTS.md