| name | kweaver-admin |
| description | Use when managing KWeaver admin operations from CLI, including auth, org, user, role, model, audit, config, and call passthrough; especially when users ask for command parameters, examples, or routing/fallback behavior in kweaver-admin. |
KWeaver Admin CLI
Overview
kweaver-admin covers platform administration: authentication, org/user/role,
model config, audit, and raw API passthrough.
This skill uses progressive disclosure:
- Read this file for command-group selection.
- Read
references/*.md for exact command/parameter details.
- Read routing/fallback reference when debugging deployment differences.
references/ is the source of truth for this skill. When answering detailed
questions (flags, payload shape, fallback behavior), read the corresponding
reference first, then execute.
安装
npm install -g @kweaver-ai/kweaver-admin
npx -y @kweaver-ai/kweaver-admin --help
使用方式
kweaver-admin [--json] [--base-url <url>] [-k] <group> <subcommand> [options]
命令组总览
References 使用规则（关键）
references/ 是该 skill 的细节层，按以下顺序读取：
- 先看本文件，决定命令组与执行顺序。
- 再读对应
references/*.md，获取参数和示例。
- 遇到部署差异（404/501/errID）时，额外读
routing-and-fallbacks.md。
当用户问到参数语义、命令细节、实现逻辑时，必须先读对应 reference，再执行。
执行策略
- 先跑只读命令（
list/get/tree/status/whoami）确认环境。
- 写操作前记录关键 ID，并优先使用
--json。
- 每次写操作后立刻用读命令验收。
- 遇到 404/501/errID 错误时，按 routing reference 判断是否是后端可用性差异。
触发示例
/kweaver-admin 列出所有用户并按关键词过滤
/kweaver-admin 给用户分配角色并验证结果
/kweaver-admin 创建部门并查看组织树
/kweaver-admin 重置 testcli1 密码到默认值
/kweaver-admin 用 call 检查某个 REST 接口是否可达
