核心概念

三层架构

OkBot 分三层，关系如下：

桌面客户端 — 桌面应用或浏览器 Web UI。一个客户端可在设置 → 客户端 → 网关列表保存多套个人网关，并切换当前要连的那一套（客户端 1 : N 网关）。同一时间只附着一个当前网关；部分切换需重启后生效。
个人网关 — Personal Agent 宿主，拥有该主机上的数据根（默认 ~/.okbot）。可在你指定的机器上部署：由桌面应用拉起，或用 okbot serve 无界面运行（亦可 --port + --data-dir 开多实例）。
运行电脑 — 一套网关经设置 → 电脑连接登记多台运行电脑（本机 + 远程 sandbox-agent）（网关 1 : N 运行电脑）。工具可路由到其中一台执行。

一句话：一层客户端，一层个人网关，一层运行电脑——一个客户端可切换多套网关；一套网关可挂多台运行电脑。

网关部署并保持运行时，Personal Agent 可以持续服务；任务可以打到该网关下已登记的多台运行电脑。这样就能搭一套常开、并覆盖多台运行电脑的 Personal Agent（前提是网关在跑；没有运行中的网关就谈不上常开）。定时任务同样只在网关在跑时触发。

助手（Bot）

具名助手：名称、头像、人设（SOUL.md）、可选私有技能与记忆。侧栏管理会话花名册。可维护长程任务清单、定时任务与资料库 / HTML 笔记（见自主进化、助手）。

协作：Mesh 与小队

Mesh：在 1:1 会话中，助手可向花名册同伴求助（状态行 + 只读往来）。
小队（Squad）：需要时组建；你分配任务，队长编排，成员可并行。日常 1:1 更常用 Mesh。

会话

每位助手 / 每个小队有独立会话记录（jsonl）。支持分页上滑、引用、复制、重试发送、气泡表情回应（写在消息记录上，不新增时间线条）。

工具与审批

助手可调用本机或远程运行电脑上的工具（shell、读写文件、网页、定时、长程任务进度、HTML 笔记等）。开箱多数工具自动允许（含 run_shell / write_file / edit_file）；把工具设为「询问」才会弹人机审批（HITL）卡。强制确认动作（定时 create/delete、记忆 forget）以及启用 MCP 后的每次 MCP 调用也会审批。工具设为询问时，可单次允许、记住自动审批规则（AAR），或拒绝。

MCP 扩展总开关默认开启（已有显式关闭保持不变）；MCP 工具每次都要审批；自动审批规则作用于内置工具。

安全防护：路径前缀与危险命令 denylist 是软护栏，不是隔离——本机工具执行不是 OS 沙箱（默认无 seatbelt/容器）。相对读写默认落在当前助手/小队工作根（~/.okbot/data/<成员ID>）；run_shell 默认 cwd 为其下 temp/；资料库用 resources/…，并拦下对会话/记忆等持久状态文件的误覆盖。设置里另有可选 Agent 输入/输出与工具结果护栏（默认关）。更高安全姿态：把危险工具设为询问，保持局域网绑定关闭，不要开 MCP，并收紧允许路径。

数据目录

数据落在当前网关主机的数据根（默认 ~/.okbot/：助手、会话、记忆、网关设置、运行电脑列表等）。客户端壳层偏好（主题、语言、网关列表等）在本机 client.json；切换网关时，各网关各自保留自己的设置与数据。

密钥类文件权限收紧。网关可配置多个访问令牌（含限额与用量）。