openclaw/nix-openclaw
openclaw/nix-openclaw
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity
87f883a6c8
nix-openclaw/AGENTS.md
joshp123 5e186c192f docs: split maintainer agent guidance 
Move public maintainer policy and automation guidance into maintainers/, shrink root AGENTS.md into an audience router, and ignore internal .agent scratch state.

Delete tracked internal ExecPlans from .agent and scrub personal/private references from public RFC examples.

Checks: git diff --cached --check; scripts/check-flake-lock-owners.sh; node scripts/select-openclaw-release.test.mjs; bash -n scripts/update-pins.sh; ruby -e 'require "yaml"; YAML.load_file(".github/workflows/yolo-update.yml"); YAML.load_file(".github/workflows/ci.yml")'
2026-05-06 09:29:46 +02:00

2.7 KiB
Raw Blame History

AGENTS.md - nix-openclaw

PRs

We are not accepting PRs from non-maintainers. If your handle is not in the Maintainers list below or on https://github.com/orgs/openclaw/people, do not open a PR.

Describe your problem and talk with a maintainer human-to-human on Discord instead. Join https://discord.gg/clawd and use #golden-path-deployments.

Maintainers

Source: https://github.com/orgs/openclaw/people

  • @Asleep123
  • @badlogic
  • @bjesuiter
  • @christianklotz
  • @cpojer
  • @Evizero
  • @gumadeiras
  • @joshp123
  • @mbelinky
  • @mukhtharcm
  • @obviyus
  • @onutc
  • @pasogott
  • @sebslight
  • @sergiopesch
  • @shakkernerd
  • @steipete
  • @Takhoffman
  • @thewilloftheshadow
  • @tyler6204
  • @vignesh07

Audience Routing

  • Consumer agents installing or configuring OpenClaw: start with README.md and templates/agent-first/flake.nix.
  • Maintainer agents changing packaging, release automation, pins, or CI: read maintainers/AGENTS.md first.
  • Plugin authors: read docs/plugins-maintainers.md and examples/hello-world-plugin/.
  • Private deployments, bots, hosts, local worktrees, tokens, and personal automation details do not belong in this public repo.

Public Repo Rules

  • README.md is the source of truth for product direction and user-facing behavior.
  • Keep documentation surface area small. Update README.md first, then adjust references.
  • Keep committed guidance about public nix-openclaw behavior, public upstream OpenClaw releases, public artifacts, and public CI.
  • Keep consumer setup docs in README.md, templates, and module docs.
  • Keep maintainer runbooks in maintainers/.
  • Never add internal ExecPlans or agent scratch history to this repo. .agent/ is ignored for this reason.
  • If a private deployment exposes a public packaging bug, fix the public package here and keep deployment-specific repair elsewhere.

Packaging Defaults

  • Nix-first, no sudo.
  • Declarative config only.
  • Batteries-included install is the baseline.
  • Breaking changes are acceptable pre-1.0.0; no deprecations.
  • No inline scripts or inline file contents in Nix code. Use repo scripts and explicit file paths.
  • The gateway package must include Control UI assets.
  • User-facing docs should lead with one package: openclaw. Treat openclaw-gateway and openclaw-app as component outputs for modules, checks, and debugging.
  • QMD is the Nix-supported batteries-included local memory backend. Keep qmd internal to the openclaw wrapper PATH; users opt in with upstream config.

Safety

  • Never send messages, email, SMS, or other external communications without explicit confirmation showing the full message text.
  • No force push. No destructive git operations unless explicitly requested.
  • Before deleting tracked files, list them in the summary so maintainers can verify.