Scripts

The

directory contains helper scripts for local workflows and ops tasks. Use these when a task is clearly tied to a script; otherwise prefer the CLI.

Conventions

• Scripts are optional unless referenced in docs or release checklists.
• Prefer CLI surfaces when they exist (example: auth monitoring uses
  text

  Copy

  openclaw models status --check
  ).
• Assume scripts are host‑specific; read them before running on a new machine.

Auth monitoring scripts

Auth monitoring is covered in Authentication. The scripts under

are optional extras for systemd/Termux phone workflows.

GitHub read helper

Use

when you want to use a GitHub App installation token for repo-scoped read calls while leaving normal on your personal login for write actions.

Required env:

• text

  Copy

  OPENCLAW_GH_READ_APP_ID
• text

  Copy

  OPENCLAW_GH_READ_PRIVATE_KEY_FILE

Optional env:

• text

  Copy

  OPENCLAW_GH_READ_INSTALLATION_ID
  when you want to skip repo-based installation lookup
• text

  Copy

  OPENCLAW_GH_READ_PERMISSIONS
  as a comma-separated override for the read permission subset to request

Repo resolution order:

• text

  Copy

  gh ... -R owner/repo
• text

  Copy

  GH_REPO
• text

  Copy

  git remote origin

Examples:

• text

  Copy

  scripts/gh-read pr view 123
• text

  Copy

  scripts/gh-read run list -R openclaw/openclaw
• text

  Copy

  scripts/gh-read api repos/openclaw/openclaw/pulls/123

When adding scripts

• Keep scripts focused and documented.
• Add a short entry in the relevant doc (or create one if missing).

Related

• Testing
• Testing live