OpenBot怎么用 开源个人AI机器人使用教程

OpenBot是一个开源的个人AI机器人框架，可以在本地运行，支持自定义AI助手和自动化任务。它更像一个可改造的模板：给AI助手配置浏览器、文件和工具，再通过界面管理任务。下面按电脑端从下载安装到首次运行来操作；需要准备Docker、Bun 1.3及以上版本、CopilotKit Intelligence项目和模型API密钥。

第一步：准备运行环境

先安装Docker Desktop并启动，确认状态显示运行中；再安装Bun 1.3或更新版本。打开终端输入bun --version，能看到版本号就行。模型服务也要先准备好API密钥，首次配置会用到。OpenBot的本地启动还依赖CopilotKit Intelligence项目，提前准备该项目的API地址和密钥，别把密钥发到公开聊天或提交到代码仓库。

第二步：下载OpenBot项目

打开终端，切换到你准备存放项目的文件夹，然后粘贴以下命令并回车。下载完成后进入项目目录，复制环境配置模板，并安装依赖。等待命令运行结束再继续；如果终端提示权限或网络错误，先检查Docker、Bun是否已装好，以及当前网络能否访问GitHub。

git clone https://github.com/CopilotKit/OpenBot.git
cd OpenBot
cp .env.example .env
bun install

第三步：填写模型和项目配置

用文本编辑器打开项目根目录里的.env，找到模型和CopilotKit Intelligence相关配置项，填入对应服务的地址、项目密钥及模型API密钥。变量名以模板为准，不要随意删行或改名。保存后回到终端；密钥不要加到代码仓库，示例密钥也不要直接用于正式部署。

第四步：启动本地服务

确认Docker仍在运行，终端当前目录是OpenBot项目目录，再执行启动脚本。首次启动可能需要下载容器或构建资源，稍等片刻，留意终端有没有报错。启动成功后，按终端提示在浏览器打开本地地址；如果页面打不开，先看终端日志，并确认相关端口没有被其他程序占用。

bash scripts/start.sh

第五步：创建自己的AI助手

进入页面后打开Agents区域，选择新建或编辑示例助手，填写名称、头像和角色说明。角色说明尽量写具体：例如“整理指定目录里的会议纪要，先列出待处理文件，再按日期归类”。保存后打开对应频道发一条测试消息，确认它能理解任务、给出符合预期的回复。

第六步：配置任务和工具

按实际用途给助手启用所需能力，例如浏览器、工作区文件或已配置的工具，不需要的权限先别开。要接入MCP服务，就从插件或工具配置入口添加服务，再回到助手设置授权。先用无敏感内容的小任务测试；遇到读写文件、执行命令等动作时，检查目标和权限边界是否合适。

第七步：测试自动化流程

先从一步一确认的任务开始，比如让助手读取一份测试文档并输出摘要。检查结果后，再逐步尝试多步骤流程；若页面提供Routines入口，可在那里配置重复执行的任务，并先用短周期验证触发是否正常。失败时检查模型密钥、工具连接和终端日志，修好后再重跑。

第八步：排错或选择替代方案

若安装失败，先在终端确认Docker和Bun可用，再检查.env是否填全、脚本是否在项目根目录执行；仍启动不了，就根据报错逐项排查，不要盲目重复运行。想少折腾本地环境、直接体验国内替代方案，可以了解Agent Space，打开官网入口查看使用方式；润灭也可以把它作为入门体验的备选。