仓库脚本说明

scripts/ 目录包含本地工作流和运维任务的辅助脚本。

使用原则

• 脚本是可选的，除非文档或发布清单中明确引用
• 优先使用 CLI 接口（如认证监控使用 openclaw models status --check）
• 在新机器上运行前先阅读脚本内容

认证监控脚本

认证监控详见 gateway/authentication。scripts/ 下的脚本是 systemd/Termux 手机工作流的可选补充。

GitHub 读取辅助工具

使用 scripts/gh-read 时，gh 使用 GitHub App 安装令牌进行仓库范围的读取调用，同时保留个人登录用于写操作。

必需环境变量：

• OPENCLAW_GH_READ_APP_ID
• OPENCLAW_GH_READ_PRIVATE_KEY_FILE

可选环境变量：

• OPENCLAW_GH_READ_INSTALLATION_ID（跳过基于仓库的安装查找）
• OPENCLAW_GH_READ_PERMISSIONS（逗号分隔的读权限子集）

仓库解析顺序：

1. gh ... -R owner/repo
2. GH_REPO
3. git remote origin

使用示例：

scripts/gh-read pr view 123
scripts/gh-read run list -R openclaw/openclaw
scripts/gh-read api repos/openclaw/openclaw/pulls/123

添加新脚本的规范

• 保持脚本专注且有文档
• 在相关文档中添加简短说明（或创建新文档）

相关链接

• help-testing — 测试套件
• help-testing-live — 实时测试