系统参数
本页列出「系统参数」页的每一项:含义、默认值和取值范围。

使用方式
页面上半部分是开关(账号、团队、插件、演示),下半部分是数值参数。
- 开关即时生效,不需要点保存,切换后右上角提示结果。
- 数值参数按分组排列,每项右侧是数字步进框,单位写在框后。修改后该项前出现圆点,页面底部出现「已修改 N 项」保存条,点「保存」提交或「放弃」还原。未保存就离开页面时浏览器会提醒。超出取值范围的值会被拒绝保存。
- 保存后立即对新请求生效(「机器心跳间隔」除外,见下文),并写入 审计记录,记录每项的旧值和新值。
这里是平台默认值。团队管理员可以在「团队设置 → 参数」里为本团队覆盖部分参数(下表「团队可覆盖」一列);标有「群默认」的三项,群管理员还可以在群设置里为本群单独调整。没调整的团队、群沿用上一层的值。
「飞书自动开户」和「对外地址」在 飞书 页设置。
账号
| 开关 | 默认 | 说明 |
|---|---|---|
| 开放自助注册 | 关闭 | 开启后登录页显示注册入口,注册即成为普通成员;关闭后只能由管理员 创建账号,或凭团队邀请链接注册。同一 IP 每小时最多注册 5 个账号 |
团队
| 开关 | 默认 | 说明 |
|---|---|---|
| 单团队模式 | 开启 | 开启后不显示团队切换,新账号自动加入唯一的团队;仅在恰好有一个未归档团队时可开启 |
| 建团队权限 | 仅系统管理员 | 「所有人」或「仅系统管理员」。单团队模式下任何人都不能新建团队 |
开放了自助注册、关闭了单团队模式、建团队权限又是「仅系统管理员」时,页面会提示:自助注册的账号不能新建团队,需凭邀请链接加入团队。
插件
| 开关 | 默认 | 说明 |
|---|---|---|
| 插件 | 关闭 | 插件系统总开关。开启后,群管理员可在群设置里启用插件,群成员通过输入框的「创作」使用。关闭后不显示任何插件入口,也不向机器下发插件;已上传的插件保留 |
| 插件代码 | 关闭 | 允许插件在执行机器上运行代码,如本地 MCP 服务。开启后每个插件版本仍需机器主人在自己的机器上逐个授权 |
「平台插件」一行的「管理插件」按钮打开 配置中心 · 插件:内置插件随服务端自动安装,也可以上传自己的插件,对所有团队可见。插件的使用见 市场与插件。
演示
| 开关 | 默认 | 说明 |
|---|---|---|
| 演示模式 | 关闭 | 对外公开演示时开启,见下文 |
演示模式防止内容经内网穿透的域名流到互联网、访客破坏演示环境。开启后:
- 预览只能登录后在群内查看,不能创建公开链接,已发出的公开链接立即失效,预览卡片不同步到飞书。
- 实时画面只能观看不能操控。
- Bot 不能使用「完全访问」档位,已设为完全访问的按「工作区写入」运行。
- 除系统管理员外,不能改密码和昵称,不能解散群、移除成员、删除 Bot、吊销机器、归档团队。
运行与会话
| 参数 | 默认 | 范围 | 团队可覆盖 | 说明 |
|---|---|---|---|---|
| 会话恢复失败时补送的群聊上下文(token 上限) | 16000 token | 1000–100000 | 是 | Bot 恢复之前的会话时,一并备好最近的群消息(总量不超过此值),会话恢复不了时补给新会话;更早的消息 Bot 可以通过内置工具自己去读 |
| 每轮随消息附带的群聊上下文(token 上限) | 8000 token | 1000–100000 | 是 | 每轮运行随 @ 消息一起发给 Bot 的群消息总量上限(该 Bot 上次运行之后的新消息,从最新往前取,按字数估算 token,不限条数) |
| Bot 闲置后下次对话自动开新会话 | 6 小时 | 1–720 | 否 | Bot 在某个群(或话题)里超过这么久没有会话,下一轮自动开新会话。闲置太久的会话已没有提示词缓存,续接会按全价重读整个历史 |
| 提问卡片每张题数上限 | 4 题 | 1–4 | 是 | 当前版本不生效,每张提问卡片固定最多 4 题 |
附件
| 参数 | 默认 | 范围 | 团队可覆盖 | 说明 |
|---|---|---|---|---|
| 单个附件大小上限 | 50 MB | 1–50 | 否 | 上传单个附件的大小上限,也用于飞书消息里的附件 |
| 每条消息附件数 | 10 个 | 1–10 | 是 | 一条消息最多带几个附件 |
TIP
调整附件上限时,记得同步检查反向代理的请求体大小限制,见 反向代理。
机器连接
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 机器心跳间隔 | 15 秒 | 5–120 | daemon 向服务器发送心跳的间隔。服务器启动时读取,修改后需重启服务器才生效;环境变量 GONGGONG_HEARTBEAT_SEC 优先于此参数 |
| 机器离线判定(连续未收到心跳) | 3 次 | 2–10 | 连续这么多个心跳间隔没收到心跳,就判定机器离线 |
数据保留
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 完整运行过程保留 | 30 天 | 1–3650 | 运行结束超过这么多天后,删除该轮的完整过程(思考、工具调用、输出)和 diff;运行卡片上的摘要保留。服务器每小时清理一次 |
| 服务器备份(每日)保留 | 7 天 | 1–365 | 当前不生效:备份脚本固定保留最新 7 份,以及最近 7 个有备份的日子里每天最新的一份,见 备份与恢复 |
| 删群后存档保留 | 30 天 | 1–365 | 群被解散后存档的保留天数,群 页据此显示「归档 · N 天后清除」 |
群与 Bot 默认值
| 参数 | 默认 | 范围 | 团队可覆盖 | 说明 |
|---|---|---|---|---|
| 权限审批等待 · 群默认 | 30 分钟 | 1–1440 | 是 | Bot 发起权限请求后,等 Bot 主人批准的时间;超时自动拒绝,见 审批与提问 |
| 接力链长上限 · 群默认 | 3 跳 | 1–10 | 是 | Bot 在回复里 @ 另一个 Bot 接力时,一条接力链最多传递几次 |
| Bot 离线时请求等待上线 · 群默认 | 30 分钟 | 1–1440 | 是 | Bot 所在机器离线时,请求排队等待机器上线的时间;超时后请求作废并通知触发人 |
| Bot 并发上限 · 新建默认 | 2 个 | 1–10 | 是 | 新建 Bot 时「并发上限」的初始值;已有 Bot 不受影响 |
其他
| 参数 | 默认 | 范围 | 说明 |
|---|---|---|---|
| 预览无人访问后自动关闭 | 24 小时 | 1–720 | 预览连续这么久没人打开就自动关闭,并停止没有其他预览在用的托管服务,见 结果预览 |
| 预览公开链接最长有效期 | 30 天 | 1–365 | 生成公开链接时可选的最长有效期,见 公开分享 |