Skip to content

系统参数 ​

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

管理后台 · 系统参数

使用方式 ​

页面上半部分是开关(账号、团队、插件、演示),下半部分是数值参数。

  • 开关即时生效,不需要点保存,切换后右上角提示结果。
  • 数值参数按分组排列,每项右侧是数字步进框,单位写在框后。修改后该项前出现圆点,页面底部出现「已修改 N 项」保存条,点「保存」提交或「放弃」还原。未保存就离开页面时浏览器会提醒。超出取值范围的值会被拒绝保存。
  • 保存后立即对新请求生效(「机器心跳间隔」除外,见下文),并写入 审计记录,记录每项的旧值和新值。

这里是平台默认值。团队管理员可以在「团队设置 → 参数」里为本团队覆盖部分参数(下表「团队可覆盖」一列);标有「群默认」的三项,群管理员还可以在群设置里为本群单独调整。没调整的团队、群沿用上一层的值。

「飞书自动开户」和「对外地址」在 飞书 页设置。

账号 ​

开关默认说明
开放自助注册关闭开启后登录页显示注册入口,注册即成为普通成员;关闭后只能由管理员 创建账号,或凭团队邀请链接注册。同一 IP 每小时最多注册 5 个账号

团队 ​

开关默认说明
单团队模式开启开启后不显示团队切换,新账号自动加入唯一的团队;仅在恰好有一个未归档团队时可开启
建团队权限仅系统管理员「所有人」或「仅系统管理员」。单团队模式下任何人都不能新建团队

开放了自助注册、关闭了单团队模式、建团队权限又是「仅系统管理员」时,页面会提示:自助注册的账号不能新建团队,需凭邀请链接加入团队。

插件 ​

开关默认说明
插件关闭插件系统总开关。开启后,群管理员可在群设置里启用插件,群成员通过输入框的「创作」使用。关闭后不显示任何插件入口,也不向机器下发插件;已上传的插件保留
插件代码关闭允许插件在执行机器上运行代码,如本地 MCP 服务。开启后每个插件版本仍需机器主人在自己的机器上逐个授权

「平台插件」一行的「管理插件」按钮打开 配置中心 · 插件:内置插件随服务端自动安装,也可以上传自己的插件,对所有团队可见。插件的使用见 市场与插件。

演示 ​

开关默认说明
演示模式关闭对外公开演示时开启,见下文

演示模式防止内容经内网穿透的域名流到互联网、访客破坏演示环境。开启后:

  • 预览只能登录后在群内查看,不能创建公开链接,已发出的公开链接立即失效,预览卡片不同步到飞书。
  • 实时画面只能观看不能操控。
  • Bot 不能使用「完全访问」档位,已设为完全访问的按「工作区写入」运行。
  • 除系统管理员外,不能改密码和昵称,不能解散群、移除成员、删除 Bot、吊销机器、归档团队。

运行与会话 ​

参数默认范围团队可覆盖说明
会话恢复失败时补送的群聊上下文(token 上限)16000 token1000–100000是Bot 恢复之前的会话时,一并备好最近的群消息(总量不超过此值),会话恢复不了时补给新会话;更早的消息 Bot 可以通过内置工具自己去读
每轮随消息附带的群聊上下文(token 上限)8000 token1000–100000是每轮运行随 @ 消息一起发给 Bot 的群消息总量上限(该 Bot 上次运行之后的新消息,从最新往前取,按字数估算 token,不限条数)
Bot 闲置后下次对话自动开新会话6 小时1–720否Bot 在某个群(或话题)里超过这么久没有会话,下一轮自动开新会话。闲置太久的会话已没有提示词缓存,续接会按全价重读整个历史
提问卡片每张题数上限4 题1–4是当前版本不生效,每张提问卡片固定最多 4 题

附件 ​

参数默认范围团队可覆盖说明
单个附件大小上限50 MB1–50否上传单个附件的大小上限,也用于飞书消息里的附件
每条消息附件数10 个1–10是一条消息最多带几个附件

TIP

调整附件上限时,记得同步检查反向代理的请求体大小限制,见 反向代理。

机器连接 ​

参数默认范围说明
机器心跳间隔15 秒5–120daemon 向服务器发送心跳的间隔。服务器启动时读取,修改后需重启服务器才生效;环境变量 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生成公开链接时可选的最长有效期,见 公开分享

相关页面 ​

基于 Apache License 2.0 开源