owl

环境要求

• Python 3.10、3.11 或 3.12（README 建议用 3.10）
• pip 及 uv 包管理工具
• Node.js（使用 Playwright MCP 等 MCP 服务时需要）
• Docker 与 docker compose（仅在选用 Docker 方式时需要）

安装与启动步骤

1. 1检查 Python 版本

   README 要求 Python 3.10、3.11 或 3.12，先用该命令确认本机版本，未安装则去官网下载。

   python --version

   复制

2. 2安装 uv 工具

   用 pip 安装 uv，后面用它创建虚拟环境并安装依赖。

   pip install uv

   复制

3. 3创建虚拟环境

   在项目根目录下创建 Python 3.10 的 .venv 虚拟环境。

   uv venv .venv --python=3.10

   复制

4. 4安装项目依赖

   以可编辑模式安装 OWL 及 CAMEL 全部依赖；不使用 uv 时也可用 pip 方式。

   uv pip install -e .

   复制

5. 5设置环境变量

   OWL 需要多种服务的 API Key，README 未列出具体变量名，请按官方文档配置后再运行。

6. 6运行基础示例

   按 README 修改 examples/run.py 里的任务内容后运行，即可启动 OWL 智能体。

   python examples/run.py

   复制

7. 7安装 MCP 服务

   使用 MCP 功能前先安装 Node.js，再全局安装 Playwright MCP 服务并装依赖。

   npm install -g @executeautomation/playwright-mcp-server
   npx playwright install-deps

   复制

8. 8Docker 方式运行

   改用容器时先构建并启动服务，再进入容器激活环境运行示例。

   docker compose up -d --build
   docker compose exec owl bash
   cd .. && source .venv/bin/activate
   playwright install-deps
   xvfb-python examples/run.py

   复制

如何确认成功

执行 python examples/run.py 后无依赖或环境变量报错，并正常返回任务结果即说明部署成功。

常见问题

注意事项

• README 只说明需要配置各类 API Key，未列出具体环境变量名，务必查阅官方文档填写。
• 用 requirements.txt 安装时需加 --use-pep517 参数：pip install -r requirements.txt --use-pep517。
• Docker 方式还提供 build_docker.sh 与 run_in_docker.sh 脚本，可执行 chmod +x build_docker.sh 后自行构建镜像。
• Docker 内若无法访问 Docker Hub，可修改 docker-compose.yml 后执行 docker compose up -d --build。