常见问题

打开时被系统拦截？

早期构建可能未签名。macOS / Windows 请在系统设置中允许已下载的应用（仅在你信任来源时）。

数据保存在哪里？

对话、记忆、设置默认保存在当前网关主机的 ~/.okbot（自定义 okbot serve --data-dir 实例则在该目录）。模型请求发往你配置的供应商 baseURL。

模型从哪里来？

请自备供应商（BYO）。请求发往你配置的接口。OkBot 不托管推理。

如何切换网关 / 多机？

设置 → 客户端 → 网关列表切换已保存网关（部分切换需重启）。设置 → 电脑连接为一台网关登记多台电脑（含远程 sandbox-agent）。详见 服务网关 与 远程电脑。

可以开多个网关实例吗？

可以。okbot serve --port <端口> --data-dir <目录> 成对指定；桌面应用默认只附着 ~/.okbot。详见 服务网关。

网关令牌怎么管理？

设置 → 网关服务可创建多个命名令牌（用户 / 超管），并设置消息与 Token 限额；可查看每令牌对各助手 / 小队的用量。

定时任务为什么没触发？

定时任务只在拥有网关的进程在跑时检查（桌面拉起的网关或 okbot serve）。关掉后不会触发；再启动时会对已过期的下次时间补跑一次。详见 自主进化。

长程任务是什么？

助手用持久化任务清单拆解步骤、落盘进度、中断后恢复并继续推进（可多任务；未做 backlog / 进行中 / 结束）。与定时唤醒、HTML 笔记是三套能力。详见 自主进化。

笔记和任务有什么区别？

有明确时间点或周期 → 定时；当场要办或只记需求、无排期 → 长程任务；只要沉淀文档并维护 → HTML 笔记（资料库）。详见 助手 与 自主进化。

MCP 如何审批？

MCP 扩展总开关默认开启；MCP 工具每次都要人机审批。自动审批规则作用于内置工具。可在设置中关闭总开关；市场连接器预设写入后仍需单独启用该服务器。

导出助手包含什么？

.okbot 包含人设与技能（及名称 / 头像等）。会话、记忆与密钥留在网关主机。

「正在进化」在做什么？

跑后静默维护人设 / 技能 / 记忆（记忆先入候选再巩固为持久；提示只注入置顶与相关持久条），下一轮提示即生效。详见 自主进化。

安全防护覆盖什么？

路径前缀与危险命令 denylist 是软护栏，不是隔离——本机执行不是 OS 沙箱。相对读写默认在当前助手/小队工作根；run_shell 默认 cwd 为 temp/；资料库用 resources/…，并拦下对 session.jsonl 等持久状态的误覆盖。多数工具开箱自动允许（含 shell / 写文件）；把工具设为询问、或命中强制确认（定时 create/delete、记忆 forget）/ MCP 时才弹 HITL。设置 → 安全防护还有 Tool | Agent 页签：Agent 侧可选输入/输出与工具结果护栏（默认关）。更高安全姿态：危险工具设为询问，保持局域网绑定关闭，不要开 MCP，收紧允许路径。

助手市场现状？

应用内市场（助手 / 连接器）已可用。官网社区市场页即将开放。也可用导出 / 导入 .okbot，或粘贴公开 GitHub / .okbot 源。

如何备份？

桌面端（拥有本机网关时）可在设置 → 网关服务 → 数据中导出/恢复网关数据（默认可不含密钥）。恢复前请确认没有助手正在工作或等待批准。附着窗口 / Web UI 不提供备份路由。

更多

请到 GitHub Issues 反馈，或阅读仓库 GUIDE.md。