bytebot

用大白话指挥电脑干活，自动完成重复操作

Bytebot 是一个自托管的 AI 桌面代理，通过自然语言指令自动执行计算机任务，运行在容器化的 Linux 桌面环境中。它解决了传统自动化脚本难以适应复杂、动态界面操作的问题，让用户可以用日常语言描述意图，由 AI 代理理解并操作鼠标、键盘和屏幕，完成文件管理、网页浏览、软件操作等任务。核心能力包括：基于视觉的界面理解、自然语言到操作序列的转换、容器化隔离执行环境、可扩展的插件机制，以及支持多步骤任务规划。项目采用 TypeScript 编写，强调安全性和可控性，用户可完全掌控运行环境。

开源 free 开源模型

访问官网 ↗ GitHub ↗ 文档 ↗

GitHub 星标 ★ 11087

维护状态低维护

是否开源是

定价模式 free

项目数据

分类开源模型

开发团队bytebot-ai

所属国家

官网地址https://www.bytebot.ai

GitHubhttps://github.com/bytebot-ai/bytebot

定价模式free

价格说明开源项目，Apache-2.0 许可证，可自行部署，完全免费。

访问状态

是否开源是

开源协议Apache-2.0

主要语言TypeScript

技术栈/模型agent,agentic-ai,agents,ai,ai-agents,ai-tools,anthropic,automation,bytebot,computer-use,computer-use-agent,cua,desktop,desktop-automation,docker,gemini,llm,mcp,openai

GitHub 星标★ 11087

30天Star增速

HF 下载量

上线时间2025-02-03 00:00:00

最近更新2026-09-22 00:00:00

维护状态低维护

中文支持

访问方式

移动端支持

综合评分

收录时间2026-08-09

浏览次数5

使用教程

难度：入门约 10 分钟部署方式：Docker 5 步

环境要求

安装 Docker 与 Docker Compose
准备 AI 服务商的 API Key（如 ANTHROPIC_API_KEY、OPENAI_API_KEY 或 GEMINI_API_KEY）
可访问 GitHub 与容器镜像仓库的网络环境
本地需预留运行容器化 Linux 桌面的资源

安装与启动步骤

1克隆仓库

从 GitHub 拉取 bytebot 源码到本地，后续所有 Docker 配置都在该目录下操作。
```
git clone https://github.com/bytebot-ai/bytebot.git
```
2进入项目目录

切换到克隆下来的 bytebot 目录，确认能看到 docker 子目录。
```
cd bytebot
```
3写入 API Key

在 docker/.env 中写入所用 AI 服务商的密钥，三选一即可，密钥需替换为真实值。
```
echo "ANTHROPIC_API_KEY=sk-ant-xxxxxxxx" > docker/.env
```
4启动服务

用 Docker Compose 后台启动 Bytebot 全部容器，首次运行会拉取镜像，需等待几分钟。
```
docker-compose -f docker/docker-compose.yml up -d
```
5查看运行状态

确认容器已正常启动，检查是否有容器处于退出或反复重启状态。
```
docker-compose -f docker/docker-compose.yml ps
```

关键配置

配置项	必填	说明	示例
`ANTHROPIC_API_KEY`	否	Anthropic Claude 服务密钥，与 OpenAI、Gemini 密钥三选一	`sk-ant-xxxxxxxx`
`OPENAI_API_KEY`	否	OpenAI 服务密钥，用于驱动代理推理	`sk-xxxxxxxx`
`GEMINI_API_KEY`	否	Google Gemini 服务密钥，另一种模型后端选择	`your-gemini-key`

如何确认成功

执行 docker-compose ps 看到各服务状态为 Up，且能打开 Bytebot 的 Web 界面即表示启动成功。

常见问题

Q：必须配置 API Key 吗？

A：必须，README 明确要求加入 AI 服务商密钥，否则代理无法调用模型执行任务。可用 Anthropic、OpenAI 或 Gemini 中任意一个。

Q：不会 Docker 有更简单的部署方式吗？

A：有。README 提供 Railway 一键部署选项，点击后填入 API Key 即可，无需本地安装 Docker。

Q：企业环境如何部署？

A：可用 Kubernetes 加 Helm 部署，README 给出了 helm install 命令，详细说明见官方文档的 Helm 部署指南。

注意事项

docker/.env 中按 README 做法只写入一个服务商的 API Key 即可
启动命令需在克隆后的 bytebot 目录下执行，路径为 docker/docker-compose.yml
首次启动需拉取镜像，耗时较长属正常现象
更详细的部署与使用说明请查阅官方文档 docs.bytebot.ai

核心亮点

容器化隔离，任务执行安全可控，不污染宿主机
基于视觉理解界面，不依赖特定应用 API，通用性强
支持自然语言多步骤任务规划，降低自动化门槛

不足之处

仅支持 Linux 桌面环境，Windows/macOS 用户无法直接使用
文档/社区待观察，生态尚在早期

适用场景

自动化日常办公操作，如整理文件、填写表单
软件测试中的 GUI 自动化操作
辅助残障人士通过语音/文本控制电脑

替代项目

OpenInterpreter、Self-Operating Computer、UI-TARS

项目介绍

bytebot 是智能体领域的开源项目，由 bytebot-ai 开发，2025 年首次发布。

在全站 13,109 个收录项目中，它的 GitHub 星标数（11,087）位列前 5%，在智能体分类的 2,520 个项目里位列前 5%。

项目已超过三个月没有代码更新，维护节奏明显放缓，最近一次代码更新于 2026-09-22。Apache-2.0 许可证，可自行部署，完全免费。

它主要面向的使用场景是：自动化日常办公操作，如整理文件、填写表单。同类可对比的替代方案包括 OpenInterpreter、Self-Operating Computer、UI-TARS。

上一篇：humanlayer

下一篇：prompt-master