OpenBot 首次启动设置完整指南：权限、Provider 与 Agent 的 3 步配置流程

• 桌面应用
• AI Agent
• 人工智能
• 多智能体
• 代码智能体
• 浏览器控制
• 本地部署
• MCP 服务

OpenBot 是一个本地优先（local-first）的桌面工作台，让你在 Mac、Windows 或 Linux 上运行 Codex、Claude、Grok 等持久化 AI 队友。本文带你走完 OpenBot 首次启动设置的完整流程：从安装启动、选择 Provider（AI 服务商）到创建第一个 Agent，只需 3 步即可完成配置，全程不需要编写任何代码。

第一次打开 OpenBot：你会看到什么？

从官方发布渠道下载对应平台的安装包（macOS 为.dmg，Windows 为.exe，Linux 为.AppImage），安装并启动后，首次启动向导会按以下顺序引导你：

1. 语言选择：通过语言转盘选择界面语言，默认跟随系统；
2. 启动方式选择：在「免费开始」与「我有订阅」之间二选一；
3. Provider 连接（如选择订阅路线）：登录一次，之后所有 Agent 共享该订阅；
4. 权限授权（仅 macOS）：为可选的 Computer Use（计算机操作）功能授予权限。

这套流程的界面逻辑定义在 FirstRunFlow.tsx 中，语言选择页在 LanguageStep.tsx。

💡 向导支持「Start free instead（改为免费开始）」随时切换路线，选错了完全不用重装。

步骤一：选择启动路线 —— 免费模型还是已有订阅？

首屏只问一个问题：你想从哪里开始？

选择「免费开始」后，OpenBot 会在你浏览界面的同时后台预下载免费的 OpenCode 运行时，选完几乎立刻就能进入工作台。选择订阅路线则会进入 Provider 选择页（SetupProviderPicker.tsx），内置的可选服务商包括：

• Codex：ChatGPT 订阅；
• Claude：Anthropic 订阅；
• Grok：xAI 订阅，或设置XAI_API_KEY；
• OpenCode：免费模型免登录，付费 Go 模型需粘贴 API Key；
• Gemini：Google AI Pro 或 Ultra 计划；
• Cursor / Cline：各自的订阅或 API Key。

连接 Provider 的两种方式

1. 让 OpenBot 托管下载：在对应 Provider 一行点击Download，OpenBot 会自动下载并锁定（pin）对应 CLI 版本，之后每小时自动检查更新，无需你手动维护；
2. 自己安装 CLI：先在系统里装好codex、claude或grok并完成登录，OpenBot 会复用你本地已有的登录态，不会复制任何凭据。

各服务商的详细登录机制与自定义端点说明，可查阅 docs/architecture/providers.md 和 README.md 中的Agent setup章节。

步骤二：macOS 权限授权（其他系统可跳过）

如果你启用了 Computer Use（让 AI 直接操作你的电脑），只有macOS会在这一步弹出系统权限请求：

• Screen Recording（屏幕录制）：让 Agent 能看到屏幕内容；
• Accessibility（辅助功能）：让 Agent 可以模拟鼠标和键盘输入。

在系统弹窗中点击允许即可，授权面板逻辑位于 ComputerUseSetup.tsx。Windows 和 Linux 用户不需要额外授权。

⚠️重要安全提示：OpenBot 当前处于开发预览阶段，Agent 以danger-full-access模式运行——它们可以读写文件、执行命令、访问网络并控制内置浏览器，且默认不再逐条确认操作。请只运行你信任的 Agent 和任务，并定期备份数据。详细说明见 SECURITY.md。

步骤三：创建你的第一个 Agent

Provider 连接成功后，应用自动打开，此时就可以创建第一个 Agent 了。OpenBot 的 Agent 创建是提示词驱动的：你用自然语言描述这个队友的职责，它会生成可编辑的说明、头像，保存前还能逐项审核。

每个 Agent 都会获得独立、持久的工作区：

• ~/OpenBot/Agents/<agent-id>—— 该 Agent 的专属工作目录；
• ~/OpenBot/Shared—— 所有 Agent 共享的文件区（含Transfers受管文件传输目录）；
• ~/OpenBot/Downloads—— 内置浏览器的下载目录。

创建之后，你可以：

• 为每个 Agent 单独更换模型、Provider 和推理强度（首次启动时选的只是默认值）；
• 使用本地消息队列（FIFO）暂停、恢复或取消任务；
• 让多个 Agent 互相发消息、回复、传文件；
• 让 Agent 打开并操作内置的持久化浏览器。

首次设置常见问题速查

延伸阅读

• 安装与系统要求：README.md
• 故障排查、数据重置与卸载：docs/TROUBLESHOOTING.md
• 架构总览（桌面端、云端 API 与数据边界）：docs/ARCHITECTURE.md
• 产品术语表（agent、thread、routine 等概念）：docs/glossary.md
• 隐私与网络行为：PRIVACY.md

按以上 3 步走完后，你的 OpenBot 工作台就正式跑起来了。剩下的交给 Agent 们吧 🤖

• 桌面应用
• AI Agent
• 人工智能
• 多智能体
• 代码智能体
• 浏览器控制
• 本地部署
• MCP 服务