用途:该工具供 ClawHub 员工执行审核操作,需在检出(checkout)的 ClawHub 仓库根目录运行,用于管理技能、用户、组织发布者、插件包、可信发布者与官方身份,并处理举报。它封装现有 ClawHub CLI 认证/配置与 HTTP API,不应直接调用 Convex 内部 mutation 执行员工操作。
主要能力:命令组包括 auth、users、plugins|plugin、packages|package、org、email、skills|skill。技能侧支持 hard-delete、unhide、revoke-version、rescan、reports、triage-report;用户侧支持 ban、unban、lift-moderation-hold、set-role、reclassify-ban、remediate-autobans;组织侧支持 official 增删、create、profile update、remove-member、delete、repair-scoped-packages;包侧支持 moderate、status、queue、reports、triage-report、hard-delete、transfer、repair-name、migrations、set-migration、trusted-publisher。
使用方式:先执行 bun run admin -- --help 查看帮助,用 bun run admin -- login 或 bun run admin -- whoami 完成认证或校验令牌。写操作前需展示确切命令并请求确认,除非用户已表示继续或提供 --yes。破坏性、恢复、所有权或审核类写操作必须提供原因。destructive 命令默认 dry-run,需用 dry-run 返回的确切确认令牌配合 --apply --confirm 执行。邮箱仅可在用户明确要求并确认最终收件人、主题与正文后发送,且需 --send --confirm-user-request --confirm-user-signoff。写操作后应通过 CLI/API 验证状态并报告结果。
安全与限制:不得绕过 API 令牌认证、服务器角色检查或审计日志。人类目标优先使用 handle,仅在用户提供用户 id 时使用 --id,仅在用户要求模糊匹配或 handle 有歧义时用 --fuzzy。org create 必须指定 --member,且不得把执行命令的审核员隐式加为 owner;org delete 仅适用于空组织且默认 dry-run。packages hard-delete 仅限管理员,要求包已软删除、精确 owner handle、原因与 dry-run 令牌。users unban 与 lift-moderation-hold 仅限管理员,被撤销的 API 令牌不会恢复。clawhub-admin 没有独立的技能 hide 命令,应通过举报 triage 的 --action hide 处理。若验证受认证或权限阻塞,应如实报告命令结果与阻塞原因。具体返回字段、错误码、平台与价格等资料暂未提供。