系统设置 · grokcli-2api

修改管理员密码

本卡片独立保存（点「更新密码」）。密码哈希写入数据库（hybrid 的 PostgreSQL）。环境变量 GROK2API_ADMIN_PASSWORD 仅用于首次无密码时自动导入，之后鉴权以数据库为准。当前密码不会下发到前端，须手动输入。

—

版本与热更新

对照 GitHub Release / GHCR 最新版本；在容器内一键 pull 并 force-recreate（无需宿主机 watcher）。

—

当前版本

—

轮询与维护

账号选择策略与后台维护开关（立即生效）。间隔类改完保存后下一周期生效。

账号轮询模式

默认模型

健康探测模型列表

逗号分隔；后台每轮轮询其中一个，避免笛卡尔积打爆池子

Token 维护间隔（秒）

默认 90；大池子可适当调高减轻刷新风暴

Token 提前刷新窗口（秒）

到期前多少秒开始刷新；默认 120

模型健康探测间隔（秒）

0 = 仅手动；≥30 为周期探测。大号池建议 120–300。默认 180

探测每批账号数

每轮选取账号数；实际可能按 workers 自适应放大。默认 120

探测并发 workers

同时探测的账号数。大号池建议 8–16。默认 12

会话粘性 TTL（秒）

多轮对话绑定同一账号的缓存时长；默认 7200（2h）

Token 自动续期模型健康探测探测失败自动踢出/封禁会话粘性（同对话绑同一账号）

账号出站代理池

账号池请求上游（聊天 / 测活 / Token 续期）走代理。按账号粘性选代理，与会话粘性配合更稳。协议注册可共用同一列表，也可单独配置。

—

启用出站代理池

代理池

未配置时直连上游。策略 round_robin 会对账号 ID 做稳定哈希（同账号固定出口）。

代理用户名

代理密码

代理策略

Relay / sub2api 参数

影响 Claude Code / sub2api 工具流、reasoning 兼容与长上下文压缩。单工具 + 间隔可避免 “Content block not found”。

Reasoning 兼容模式

每轮最多工具数 · Claude/sub2api（0=不限）

sub2api / Claude Code 建议保持 1

每轮最多工具数 · OpenAI chat（0=不限）

仅 /v1/chat/completions；默认 0

工具 SSE 间隔（秒）

推荐 0.08；纯 OpenAI 客户端可设 0

SSE 保活间隔（秒）

自动压缩阈值（字符）

messages JSON 超过此长度时强制压缩；0=关闭（默认，优先智商）。仅当大会话导致上游失败时再设阈值

保留最近工具轮数

仅在开启压缩时生效：近乎完整保留最近 N 轮 tool；默认 32（智商优先）

单条 tool 结果上限（字符）

仅开启压缩时：最近轮次单条 tool 上限（head+tail）；默认 48000

历史压缩（长工具循环时缩小请求体）

Shell 参数调试日志（记录 cmd 投影前后，排查 [ ] 前缀等问题）

开启后服务端日志会打印 preferred_key / has_workdir / raw_cmd / projected_cmd（仅出站投影诊断，不改上游 prompt/cache）；平时请关闭

Codex App Shell 透传（已内置，无需开关）
自动识别 Codex App / CLI 的 exec_command/local_shell（支持 cmd 与 command）。进站 shell schema 仅允许单字符串 command（不再广告 argv 数组）；出站做 command/cmd 键名映射、残留数组扁平化（含空格 token 用双引号，避免 bash 单引号导致 PowerShell ParserError），并保留 workdir/timeout。不注入 PowerShell 规则、不改写命令正文。调试请用上方「Shell 参数调试日志」（默认关，含 input_kind）。

轮询 / 冷却 / 踢出策略

失败即进入冷却状态（无时长，仅测活成功或手动解除）；可配置模型封禁 TTL、探测踢出次数与故障切换上限。

临时模型软封禁 TTL（秒）

free-usage 耗尽时仅封禁该模型，到期自动恢复

模型不可用封禁 TTL（秒）

模型真正不可用时封禁时长，到期由探测自动复核

探测失败几次后冷却踢出

探测失败几次后硬踢出

单次最多故障切换账号数

请求/探测失败会把账号标记为冷却中（纯状态，没有倒计时）。仅下次测活成功或管理台手动解除后才回到轮询；临时额度错误可同时软封禁该模型；多次探测失败会进一步踢出或禁用。

sub2api 导入

—

配置 sub2api 管理端地址与登录后，可在「账号」页将本地 Grok 账号批量导入到指定分组（平台 grok / OAuth）。优先使用本地 access/refresh token 直推；无 token 时回退 SSO→OAuth。

启用 sub2api 导入

sub2api URL

登录邮箱

登录密码

默认分组 ID

默认分组名

分组不存在时自动创建

注册成功后自动入库 sub2api

勾选后会同时启用 sub2api 导入；协议注册入库本地后立刻推送到上方分组（需填好 URL/登录/分组）。点「保存设置」后生效。

推送并发

本地→sub2api 同时推送几个账号；默认 4

账号容量（concurrency）

写入 sub2api 每个账号的并发容量；在线推送与导出数据均生效。默认 3

账号优先级

sub2api account.priority；默认 50

倍率 rate_multiplier

sub2api 计费/限速倍率；默认 1.0

notes 前缀

保存后到「账号」页：可「导入 sub2api（选中/全部）」在线推送；或「导出 sub2api 数据」下载官方 sub2api-data 备份，在 sub2api 管理台「导入数据」上传。勾选「注册成功后自动入库 sub2api」后，协议注册导入本地账号会立刻推送到上方配置的分组。

CLIProxyAPI（CPA）导入

—

配置 CLIProxyAPI 的 Management API 后，可在「账号」页把本地号池账号同步导入到 CPA auth 目录 （POST /v0/management/auth-files，写入 xai-email.json 等文件）。需在 CPA config.yaml 开启 remote-management 并设置 management key。

启用 CLIProxyAPI 导入

CLIProxyAPI URL

管理 API 根地址（不要带 /v0/management）

Management Key

对应 CPA remote-management.secret-key；请求头 Authorization: Bearer … / X-Management-Key

注册成功后自动入库 CPA

勾选后会同时启用 CLIProxyAPI 导入；协议注册入库本地后立刻推送到 CPA（需填好 URL / Management Key）。点「保存设置」后生效。

推送并发

本地→CPA 同时上传几个账号；默认 4

写入 type

auth 文件 base_url

写入 CPA auth JSON 的上游；Grok Build 请保持 cli-chat-proxy，勿改成 api.x.ai 以免 402

notes 前缀

保存后到「账号」页：用「导入 CLIProxyAPI（选中/全部）」把库里的账号同步到 CPA。「导出 CLIProxyAPI」可下载 cliproxyapi-auth-bundle 备份（也可手动拆文件放进 CPA auth 目录）。