openclaw/scripts at main · tta-lab/openclaw · GitHub

History

Name		Name	Last commit message	Last commit date
parent directory ..
clawdock		clawdock
cloudflare		cloudflare
dev		dev
docker		docker
docs-i18n		docs-i18n
e2e		e2e
fixtures		fixtures
github		github
k8s		k8s
lib		lib
mantis		mantis
perf		perf
podman		podman
pr-lib		pr-lib
pre-commit		pre-commit
qa		qa
secrets		secrets
systemd		systemd
AGENTS.md		AGENTS.md
CLAUDE.md		CLAUDE.md
README.md		README.md
agent-plugin-gateway-e2e.ts		agent-plugin-gateway-e2e.ts
analyze-plugin-sdk-usage.ts		analyze-plugin-sdk-usage.ts
android-app-i18n.ts		android-app-i18n.ts
android-pin-version.ts		android-pin-version.ts
android-release-signing.mjs		android-release-signing.mjs
android-release-upload.sh		android-release-upload.sh
android-release.sh		android-release.sh
android-screenshots.sh		android-screenshots.sh
android-sync-versioning.ts		android-sync-versioning.ts
android-version.ts		android-version.ts
anthropic-prompt-probe.ts		anthropic-prompt-probe.ts
apple-app-i18n.ts		apple-app-i18n.ts
apple-release-source-check.sh		apple-release-source-check.sh
audit-control-ui-dead-css.mts		audit-control-ui-dead-css.mts
audit-seams.mts		audit-seams.mts
auth-monitor.sh		auth-monitor.sh
bench-agent-concurrency-worker.ts		bench-agent-concurrency-worker.ts
bench-agent-concurrency.ts		bench-agent-concurrency.ts
bench-cli-startup.ts		bench-cli-startup.ts
bench-gateway-concurrency.ts		bench-gateway-concurrency.ts
bench-gateway-restart.ts		bench-gateway-restart.ts
bench-gateway-startup.ts		bench-gateway-startup.ts
bench-model.ts		bench-model.ts
bench-sqlite-reliability.ts		bench-sqlite-reliability.ts
bench-sqlite-state.ts		bench-sqlite-state.ts
bench-task-registry-sqlite-worker.ts		bench-task-registry-sqlite-worker.ts
bench-task-registry-sqlite.ts		bench-task-registry-sqlite.ts
bench-test-changed.mts		bench-test-changed.mts
bench-web-fetch.ts		bench-web-fetch.ts
build-all.mts		build-all.mts
build-and-run-mac.sh		build-and-run-mac.sh
build-diffs-viewer-runtime.mts		build-diffs-viewer-runtime.mts
build-discord-activity-sdk.mts		build-discord-activity-sdk.mts
build-stamp.mts		build-stamp.mts
bundle-a2ui.mts		bundle-a2ui.mts
bundled-plugin-assets.mts		bundled-plugin-assets.mts
changed-lanes.mjs		changed-lanes.mjs
changed-lanes.mts		changed-lanes.mts
changelog-to-html.sh		changelog-to-html.sh
check-built-plugin-control-plane-modules.mts		check-built-plugin-control-plane-modules.mts
check-changed.mjs		check-changed.mjs
check-changed.mts		check-changed.mts
check-changelog-attributions.mjs		check-changelog-attributions.mjs
check-changelog-attributions.mts		check-changelog-attributions.mts
check-channel-agnostic-boundaries.mts		check-channel-agnostic-boundaries.mts
check-cli-bootstrap-imports.mts		check-cli-bootstrap-imports.mts
check-cli-startup-memory.mjs		check-cli-startup-memory.mjs
check-codex-app-server-protocol.ts		check-codex-app-server-protocol.ts
check-coercion-helper-declarations.mts		check-coercion-helper-declarations.mts
check-composite-action-input-interpolation.py		check-composite-action-input-interpolation.py
check-control-ui-performance.mts		check-control-ui-performance.mts
check-control-ui-precompressed-assets.mts		check-control-ui-precompressed-assets.mts
check-database-first-legacy-stores.mts		check-database-first-legacy-stores.mts
check-deadcode-exports.mts		check-deadcode-exports.mts
check-deadcode-unused-files.mts		check-deadcode-unused-files.mts
check-dependency-pins.mts		check-dependency-pins.mts
check-deprecated-api-usage.mts		check-deprecated-api-usage.mts
check-deprecated-jsdoc.mts		check-deprecated-jsdoc.mts
check-docker-e2e-boundaries.mts		check-docker-e2e-boundaries.mts
check-docs-config-examples.mjs		check-docs-config-examples.mjs
check-docs-config-examples.mts		check-docs-config-examples.mts
check-docs-i18n-glossary.mts		check-docs-i18n-glossary.mts
check-docs-mdx.mjs		check-docs-mdx.mjs
check-docs-mdx.mts		check-docs-mdx.mts
check-doctor-deprecation-registry.ts		check-doctor-deprecation-registry.ts
check-duplicates.mjs		check-duplicates.mjs
check-duplicates.mts		check-duplicates.mts
check-dynamic-import-warts.mts		check-dynamic-import-warts.mts
check-env-var-count.mts		check-env-var-count.mts
check-export-name-collisions.mts		check-export-name-collisions.mts
check-extension-package-tsc-boundary.mts		check-extension-package-tsc-boundary.mts
check-extension-plugin-sdk-boundary.mts		check-extension-plugin-sdk-boundary.mts
check-extension-wildcard-reexports.mts		check-extension-wildcard-reexports.mts
check-file-utils.ts		check-file-utils.ts
check-gateway-cpu-scenarios.mts		check-gateway-cpu-scenarios.mts
check-gateway-watch-regression.mts		check-gateway-watch-regression.mts
check-import-cycles.ts		check-import-cycles.ts
check-ingress-agent-owner-context.mts		check-ingress-agent-owner-context.mts
check-kysely-guardrails.mts		check-kysely-guardrails.mts

README.md

summary

Repository script entry points and compatibility notes

read_when

Looking for an existing script before adding a new one

Running repository checks, tests, docs, Docker, release, or GitHub helper scripts

Updating package scripts or CI workflow script references

title

Scripts Directory

The scripts/ directory contains repository tooling used by local development, CI, docs publishing, releases, Docker proof, and maintainer operations. Prefer the package-script entry points in package.json when one exists, then read the underlying script before running it directly.

Compatibility

Many scripts are stable paths referenced by package.json, GitHub Actions, docs, and maintainer runbooks. Do not move, rename, or regroup scripts only to improve taxonomy. A directory migration needs an explicit maintainer-approved compatibility plan for package scripts, workflows, docs snippets, and any raw script paths users may have copied.

This index is a discovery aid for the current flat layout. It does not define a new directory taxonomy.

Common Entry Points

Area	Prefer	Notes
Build	pnpm build	Runs scripts/build-all.mts; use specific build scripts only when debugging a build stage.
Changed checks	pnpm changed:lanes --json, pnpm check:changed	Lane classification lives in scripts/changed-lanes.mjs; changed-file checks live in scripts/check-changed.mjs.
Docs	pnpm docs:list, pnpm docs:check-mdx, pnpm docs:check-links	Backed by scripts/docs-list.js, scripts/check-docs-mdx.mjs, and scripts/docs-link-audit.mjs.
Formatting docs	pnpm format:docs:check	Uses scripts/format-docs.mts; use write mode only when intentionally formatting docs.
Lint	pnpm lint, pnpm lint:core, pnpm lint:all	Wrapper scripts keep oxlint behavior aligned with repo config.
Targeted tests	pnpm test <path-or-filter> or node scripts/run-vitest.mjs <path-or-filter>	Avoid bare vitest; it can start watch mode.
Changed tests	pnpm test:changed	Uses the repo's changed-test resolver instead of a broad Vitest run.
Docker proof	pnpm test:docker:all, pnpm test:docker:rerun, pnpm test:docker:timings	Use the planner/rerun helpers before launching broad Docker work.
Live proof	pnpm test:live	Live checks require the matching environment and credentials.
Release checks	pnpm release:check, pnpm release:beta, pnpm release:candidate	Release scripts are maintainer workflows; read release docs before use.
GitHub reads	scripts/gh-read	Uses a GitHub App read token when configured, leaving normal gh login for writes.
Commits	git add <files...> then git commit -m "<message>"	Stage only the intended files for each commit.
Remote proof	node scripts/crabbox-wrapper.mjs ...	Agent default for tests and heavy work; pre-warm by source trust, sync each run, reuse the lease.

Script Families

check-*.mts / check-*.ts / retained check-*.mjs: guardrails for architecture, docs, package contents, boundaries, workflows, and generated artifacts.
run-*.mjs / run-*.mts: stable wrappers and typed implementations for Node, Vitest, oxlint, tsgo, and environment setup.
test-*.mts / retained test-*.mjs / test-*.sh / test-*.ts: test planners, Docker lanes, live checks, and focused validation helpers.
docs-* and check-docs-*: docs listing, link auditing, MDX checks, spellcheck, sync, and i18n glossary checks.
release-*, openclaw-npm-*, and plugin-*-release-*: release preparation, package verification, and publishing helpers.
docker-*, test-docker-*, and test-live-*-docker.sh: Docker E2E planning, rerun, timing, and live/package lane helpers.
gh-read*, label-*, sync-labels.ts, and PR helpers: GitHub read, labeling, and maintainer workflow support.
generate-*, write-*, copy-*, and sync-*: generated docs, metadata, package surfaces, and build artifact support.
lib/: shared helpers imported by script entry points.

Maintenance Rules

Read scripts/AGENTS.md before changing scripts.
Keep package scripts, generators, generated-artifact checks, docs references, and workflow references aligned when touching a script path.
Prefer existing wrappers instead of introducing a raw tool invocation.
Add or update focused tests under test/scripts/ when changing script behavior.

See also Scripts for public-facing script guidance.

openclaw/scripts at main · tta-lab/openclaw · GitHub

Expand file tree

Breadcrumbs

scripts

Directory actions

More options