模型与设置

设置左侧分 客户端 / 网关端 两组。客户端偏好留在本机；网关端配置写在当前网关主机。

模型接入（自备）

设置 → 模型接入：添加自定义供应商（名称、BaseURL、API Format：Chat Completions 或 Responses、API Key）与模型目录；设全局默认；单个助手也可覆盖。

自备模型供应商：请求发往你配置的接口；可用连通测试。可接入多家兼容网关。OkBot 不托管推理。

工具授权

设置 → 工具授权：网页搜索与 自动审批规则（AAR）（允许 / 先询问、关键词）始终可见。逐工具「工具管理」列表（启用 / 自动允许 / 询问，含 shell / 文件、read_skill、manage_schedule、manage_task_progress、manage_note、manage_memory、web_fetch / web_search、文生图等）仅在开发者模式下显示；未开启时仍按默认「开启 + 自动允许」生效——含 run_shell / write_file / edit_file。把工具设为「询问」才会弹 HITL 卡。

网页搜索可配置 Tavily / Brave / Serper / 自定义。web_fetch 默认可阻止内网地址（设置里可放开）。

强制确认（与工具审批 / AAR 无关）：定时 create / delete、记忆 forget。MCP 工具不适用自动审批，启用后每次调用都要审批。

安全防护

设置 → 安全防护 分 Tool | Agent 两个页签（均受总开关约束）：

Tool：拦截模式、家目录限制、允许/拒绝路径前缀、可编辑危险 shell 正则。
Agent（默认各项关闭）：输入侧可选拒绝空输入、限制长度、越狱/指令覆盖启发式、注入标记清理、粘贴密钥/PII 拦截；输出侧可选对最终回复含密钥中断；工具结果可对 run_shell / read_file 脱敏后再回模型。

路径前缀与危险命令 denylist 是软护栏，不是隔离：run_shell 走本机（或所选运行电脑）shell 与用户环境，不是 OS 沙箱（默认无 seatbelt/容器）。HITL/AAR 仅在工具设为询问（或强制确认 / MCP）时参与。Agent 护栏按需开启。更高安全姿态：把危险工具设为询问，保持局域网绑定关闭，不要开 MCP，并收紧允许路径。

助手 / 小队工作根：相对路径的 read_file / write_file / edit_file 默认落在当前成员数据目录（~/.okbot/data/<成员ID>，或自定义 data 根下的同名目录）。run_shell 省略 cwd 时默认在其下 temp/。交付进资料库写 resources/…；临时脚本与产出写 temp/…。写/改以及廉价 shell 重定向会拦下对 session.jsonl / resources.jsonl / tasks.jsonl / memory.md / bot.json / SOUL.md 等持久状态文件的覆盖——这仍是软护栏，不是 OS 隔离；绝对路径与 ~/… 仍可用。

MCP扩展

设置 → MCP扩展：总开关默认开（已有显式 enabled: false 的配置保持关闭）。可添加本地命令（stdio）或 HTTP 服务器；市场「连接器」预设一点即写入，但仍需你手动启用该服务器。从备份恢复后总开关会关掉，需检查后再自行打开。

MCP 工具每次调用都要审批；自动审批规则仅作用于内置工具，MCP 工具卡不提供「总是允许」。只接 MCP 工具，不接 resources / prompts。

客户端：网关列表

设置 → 客户端 → 网关列表：本机与已保存的远程网关；切换当前网关（部分场景需重启）。详见服务网关。

网关服务与令牌

设置 → 网关端 → 网关服务：端口、局域网、Web UI、多个命名网关令牌（用户 / 超管、消息与 Token 限额、每令牌用量）、电脑连接入口、数据备份。详见服务网关。

其它常用项

通用设置：主题、语言、时区（供定时任务等回退）、半透明、麦克风、硬件加速、系统通知、关闭窗口行为；高级里可开开发者模式（默认关；打开后显示系统指令——可编辑模板 + 只读「其他」硬编码提示词、工具授权里的工具管理列表，以及助手表单高级 / 会话请求地址 / 查看上下文 / 消耗统计 / 链路追踪等调试入口）
全局记忆：跨助手共享的记忆条目
用量分析：轻量 Token 统计；分项页签含成员与模型（亦有按网关令牌的用量）
自动更新：检查 / 下载 / 安装（桌面应用）
上下文压缩：见上下文管理
运行 Watchdog（settings.json → watchdog，默认开）：瞬时模型失败的回合内重试次数（transientRetries，默认 3）、轮询间隔（intervalMs，默认 30000）。暂无单独设置页，需要时直接改该文件。