OpenBot 桌面个人版可以从官网下载 macOS 或 Windows 安装包。打开应用后，依次完成 Account、Install、AI 和 Start。Intel Mac 需要提前准备可用的容器引擎，首次设置还需要网络和模型凭据。
下载前确认系统和芯片
macos 用户点左上角苹果图标，选「关于本机」就能看到设备是 apple 芯片还是 intel 处理器，下载对应版本的安装包就行。windows 用户直接选官方提供的 x64 安装包。用intel芯片mac的用户，按照官方仓库说明得提前装好 docker desktop 或 podman desktop，确认容器引擎已经正常启动。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
Account 和 Install 同时进行时看什么？
打开桌面应用，从欢迎页开始走安装流程。账号环节会自动调起浏览器让你登录，安装环节会后台准备运行环境、拉取镜像，这两步可以并行执行，不用互相等。登录完切回安装窗口，如果没弹出本地评估条款，先检查安装进程那边是不是还在加载容器引擎。
下载镜像的时候能实时看到进度和速度。如果卡在某一步不动，先把当前步骤和报错文字记下来，再排查网络、磁盘剩余空间、容器引擎的运行状态。要是Intel Mac刚打开容器管理工具，等引擎完全就绪之后再重试就行。
在 AI 阶段选择模型，再启动工作区
选你打算用的模型提供商，照着界面提示填对应的密钥或者完成登录，走完之后就能进到启动环节。启动流程会先连接并拉起本地 Intelligence 服务，再启动 OpenBot 自动打开工作区。
要是启动环节报了和模型相关的错误，退回到 AI 页检查提供商和你填的凭据是不是对应匹配。如果问题出在镜像下载或者引擎启动这块，就回到 Install 页核对具体卡住的阶段，别乱改已经配置正确的模型参数。
安装完成后怎么验收？
先确认界面已经进到 OpenBot 工作区，能正常打开默认助理的会话窗口。随便输一个不需要调用外部工具的短问题，确认助理能正常返回回答。要是界面能正常打开，但发第一条消息就报错，优先检查 AI 配置和模型服务是不是正常可用。
按卡住的阶段排查
账号环节没完成时，先确认浏览器确实登录到了本次安装使用的账号，并回到桌面窗口查看状态。若账号已通过但还在等本地条款，转去看容器引擎的准备进度。安装环节若反复卡在同一个镜像，记下镜像名、错误内容和发生时间，便于区分网络拉取失败和容器引擎本身未就绪。
如果已经走到启动环节，先看失败项属于模型连接还是本地服务。改完配置后重新启动，再验证两件事：工作区是否能打开，默认助理是否能回答一条只需要调用模型的短问题。第二项通过后再测试搜索，可以把模型问题和工具问题分开定位。
