2026/10/28 21:10:20

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

OpenBot 首次启动设置完整指南:权限、Provider 与 Agent 的 3 步配置流程 桌面应用AI Agent人工智能多智能体代码智能体浏览器控制本地部署MCP 服务【免费下载链接】openbotA local-first desktop workspace for persistent AI teammates. Run Codex, Claude, and Grok with dedicated workspaces, task queues, file sharing, browser control, and agent-to-agent collaboration.项目地址https://gitcode.com/GitHub_Trending/openbo/openbot点击查看免费下载OpenBot 是一个本地优先local-first的桌面工作台让你在 Mac、Windows 或 Linux 上运行 Codex、Claude、Grok 等持久化 AI 队友。本文带你走完 OpenBot 首次启动设置的完整流程从安装启动、选择 ProviderAI 服务商到创建第一个 Agent只需 3 步即可完成配置全程不需要编写任何代码。第一次打开 OpenBot你会看到什么从官方发布渠道下载对应平台的安装包macOS 为.dmgWindows 为.exeLinux 为.AppImage安装并启动后首次启动向导会按以下顺序引导你语言选择通过语言转盘选择界面语言默认跟随系统启动方式选择在「免费开始」与「我有订阅」之间二选一Provider 连接如选择订阅路线登录一次之后所有 Agent 共享该订阅权限授权仅 macOS为可选的 Computer Use计算机操作功能授予权限。这套流程的界面逻辑定义在 FirstRunFlow.tsx 中语言选择页在 LanguageStep.tsx。 向导支持「Start free instead改为免费开始」随时切换路线选错了完全不用重装。步骤一选择启动路线 —— 免费模型还是已有订阅首屏只问一个问题你想从哪里开始路线适合人群需要做什么Start free免费开始想零成本先试试无需注册、无需 API KeyOpenBot 自动下载 OpenCode CLI 并提供免费模型I have a subscription我有订阅已有 ChatGPT / Claude / Grok 订阅在下一步选择 Provider 并登录一次选择「免费开始」后OpenBot 会在你浏览界面的同时后台预下载免费的 OpenCode 运行时选完几乎立刻就能进入工作台。选择订阅路线则会进入 Provider 选择页SetupProviderPicker.tsx内置的可选服务商包括CodexChatGPT 订阅ClaudeAnthropic 订阅GrokxAI 订阅或设置XAI_API_KEYOpenCode免费模型免登录付费 Go 模型需粘贴 API KeyGeminiGoogle AI Pro 或 Ultra 计划Cursor / Cline各自的订阅或 API Key。连接 Provider 的两种方式让 OpenBot 托管下载在对应 Provider 一行点击DownloadOpenBot 会自动下载并锁定pin对应 CLI 版本之后每小时自动检查更新无需你手动维护自己安装 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。步骤三创建你的第一个 AgentProvider 连接成功后应用自动打开此时就可以创建第一个 Agent 了。OpenBot 的 Agent 创建是提示词驱动的你用自然语言描述这个队友的职责它会生成可编辑的说明、头像保存前还能逐项审核。每个 Agent 都会获得独立、持久的工作区~/OpenBot/Agents/agent-id—— 该 Agent 的专属工作目录~/OpenBot/Shared—— 所有 Agent 共享的文件区含Transfers受管文件传输目录~/OpenBot/Downloads—— 内置浏览器的下载目录。创建之后你可以为每个 Agent 单独更换模型、Provider 和推理强度首次启动时选的只是默认值使用本地消息队列FIFO暂停、恢复或取消任务让多个 Agent 互相发消息、回复、传文件让 Agent 打开并操作内置的持久化浏览器。首次设置常见问题速查问题解决办法下载 Provider CLI 失败向导会显示失败原因点击重试即可检查网络后重新下载提示 OpenBot 无法读取设置本地数据未丢失先重试持续失败可从 docs/TROUBLESHOOTING.md 按「重置数据」步骤重建设置Linux (Ubuntu/Debian) 启动即退出需要安装随附的 AppArmor 配置方法见 README.md 的 Linux 章节登录后想更换 Provider设置里的Settings → Providers可随时修改也可按 Agent 单独设置忘记了数据存在哪里全部本地化事件数据库在 Electron 的userData/openbot.db工作区在~/OpenBot/延伸阅读安装与系统要求README.md故障排查、数据重置与卸载docs/TROUBLESHOOTING.md架构总览桌面端、云端 API 与数据边界docs/ARCHITECTURE.md产品术语表agent、thread、routine 等概念docs/glossary.md隐私与网络行为PRIVACY.md按以上 3 步走完后你的 OpenBot 工作台就正式跑起来了。剩下的交给 Agent 们吧 赞分享桌面应用AI Agent人工智能多智能体代码智能体浏览器控制本地部署MCP 服务【免费下载链接】openbotA local-first desktop workspace for persistent AI teammates. Run Codex, Claude, and Grok with dedicated workspaces, task queues, file sharing, browser control, and agent-to-agent collaboration.项目地址https://gitcode.com/GitHub_Trending/openbo/openbot点击查看免费下载相关推荐Koikatsu HF Patch核心插件解析BepInEx框架与Modding API深度剖析Koikatsu HF Patch核心插件解析BepInEx框架与Modding API深度剖析 Koikatsu HF Patch是一个专为《Koikatu游戏开发Jasna 视频马赛克修复1080p 只要 34 秒、快 Lada 3.6 倍这些数字经得起验证吗Jasna 视频马赛克修复1080p 只要 34 秒、快 Lada 3.6 倍这些数字经得起验证吗 Jasna 是一个开源视频马赛克修复工具主打全流程 G人工智能AI 应用计算机视觉视频处理图像处理深度学习baoyu-translate 首次配置完全指南EXTEND.md 偏好设置流程与实操详解baoyu translate 首次配置完全指南EXTEND.md 偏好设置流程与实操详解 导读 在 baoyu skills 项目的 baoyu transAI 技能AI 插件创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考