快速入门

前提条件

一个已启用 Outposts 的组织
一个具有相应 Outposts 作用域的 v3 API 令牌：
- account.outposts.orchestrator，用于管理 outpost 的协调器 (包含 machine 作用域)
- account.outposts.machine，供工作器读取队列并认领/释放会话
一台机器 (VM 或容器) ，并满足：
- 已安装 Devin CLI
- 具备机器依赖项
- 已克隆你的代码仓库，并已配置远程仓库
- 可访问你的会话所需的构建工具、软件包仓库、secrets 和内部服务

你的主机
Docker

会话会直接在拥有你用户权限的机器上执行。我们建议在你愿意让 Agent 自由操作的专用目录下运行工作器——更好的是，在一台专门用于长期运行以 Agent 为核心任务的机器上运行，例如你桌上的 Mac Mini。

安装 Devin CLI

下载并安装 Devin CLI：

curl -fsSL https://cli.devin.ai/install.sh | bash

创建一个 outpost

在 Devin Cloud 中，前往 Settings → Environment → Outposts，然后点击 “Create Outpost” 按钮。

为你的 Outpost 命名，并选择它将提供服务的机器类型 (例如 Linux、Windows 或 Mac) 。然后点击 “Create” 按钮。

创建 Outpost 后，你会获得一个 Outpost 令牌，分配给它的工作器将使用该令牌向 Devin 进行身份验证。复制该令牌并将其保存在安全的地方，以便后续使用。该令牌只会在你创建 Outpost 时显示一次。

运行你的 Outpost 工作器

进入你希望工作器运行的目录：

cd /path/to/worker/directory

然后使用你之前复制的 Outpost 名称和令牌运行 devin worker start 命令：

devin worker start --outpost=<your-outpost-name> --token=<your-outpost-token>

启动一个新的 Outpost 会话

在 Devin Cloud 中，启动一个新会话并将其配置为在你的 Outpost 上运行。在 “Configuration” → “Virtual environment” 下，你会看到新创建的 Outpost 已列出。选择它即可让会话在其上运行。

现在你可以让 Devin 开始在你的机器上进行构建了！试试这样一个简单的请求：

Create a "hello world" python script for me

然后你就会看到脚本出现在工作器的目录中！

后续步骤

在你的代码所在目录中启动工作器，然后让 Devin 在其基础上进行构建。会话可以看到工作器工作目录下已检出的代码仓库。要同时处理更多会话，请在更多机器上运行指向同一 outpost 的工作器：N 个工作器可处理 N 个并发会话，其余会在队列中等待。

编排

在会话进入队列时自动预配机器，而不是始终保留长期运行的工作器。

集成

在你已经使用的平台上运行你的 outpost——Namespace、Modal、E2B 等。

创建 outpost

在 Devin Cloud 中，前往 Settings → Environment → Outposts，然后点击 “Create Outpost” 按钮。

为你的 Outpost 命名，并选择 Linux 作为平台 (你的容器运行在 Linux 上) 。然后点击 “Create” 按钮。

创建 Outpost 后，你会获得一个 Outpost 令牌；你想分配给它的工作器将使用该令牌向 Devin 进行身份验证。复制该令牌并将其保存在安全的位置，以便后续使用。该令牌只会在创建 Outpost 时显示一次。

构建工作器镜像

基于官方 Devin CLI 镜像 (public.ecr.aws/e0h8a4b6/devin-cli) 构建，并添加机器依赖项以及会话所需的任何代码仓库或工具：

Dockerfile

# Devin CLI 已预装，是该镜像的 entrypoint。
# 使用 :stable，或固定到特定的 CLI 版本标签。
FROM public.ecr.aws/e0h8a4b6/devin-cli:stable

# git 为必需项；ffmpeg 可启用屏幕录制功能
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates git ffmpeg \
    && rm -rf /var/lib/apt/lists/*

# 工作器运行所在的目录
WORKDIR /repos

# 可选：克隆你的 session 所需的代码仓库：
# RUN git clone https://github.com/your-org/app.git \
#     && git clone https://github.com/your-org/infra.git

CMD ["worker", "start"]

或者让 Devin 帮你创建一个 Dockerfile：

Write a Dockerfile for a Devin Outposts worker image. Base it on
public.ecr.aws/e0h8a4b6/devin-cli:stable, which has the Devin CLI preinstalled
as the image's entrypoint. Install git and ffmpeg. Clone these repositories
into the working directory the worker runs in: <your repos>. The default
command should be ["worker", "start"].

Browser 功能需要在镜像中安装 Chrome 或 Chromium，并将 DEVIN_CHROME_PATH 指向该二进制程序。基础镜像是 Ubuntu，而 Ubuntu 的 chromium apt 软件包只是一个 snap 占位包，在容器中无法工作——对于 amd64 镜像，请改为安装 Google Chrome：

RUN apt-get update && apt-get install -y --no-install-recommends curl \
    && curl -fsSL https://dl.google.com/linux/direct/google-chrome-stable_current_amd64.deb -o /tmp/chrome.deb \
    && apt-get install -y --no-install-recommends /tmp/chrome.deb \
    && rm /tmp/chrome.deb && rm -rf /var/lib/apt/lists/*
ENV DEVIN_CHROME_PATH=/usr/bin/google-chrome

对于私有代码仓库，请通过你偏好的方式 (例如 build secrets) 将凭据内置到镜像中，以便在运行时能够正常执行克隆和远程仓库操作。当你对 Dockerfile 满意后，构建该镜像：

docker build -t devin-worker .

启动你的 Outpost 工作器

使用 worker start 命令，基于你的镜像运行一个容器，并传入你的 Outpost 名称以及你之前复制的令牌 (该镜像的 entrypoint 是 Devin CLI，因此参数会直接传递给 devin) ：

docker run devin-worker \
  worker start --outpost=<your-outpost-name> --token=<your-outpost-token>

启动新的 Outpost 会话

在 Devin Cloud 上，新建一个会话，并将其配置为在你的 Outpost 上运行。在 “配置” → “虚拟环境” 下，你会看到新建的 Outpost 已显示在列表中。选择它，即可让会话在该 Outpost 上运行。

现在你可以让 Devin 在你的容器中开始构建了！先试试一些简单的任务，比如

Create a "hello world" python script for me

然后，你会看到脚本出现在容器的工作目录中！

后续步骤

将你希望 Devin 使用的代码仓库预置到 image 中，让 Devin 在此基础上进行构建——session 将在工作器的工作目录下看到已检出的代码仓库。如需同时处理更多 session，可运行更多指向同一 outpost 的 container：N 个工作器可并发服务 N 个 session，其余 session 在队列中等待。

编排

在会话进入队列时自动预配容器，无需一直保留长期运行的工作器。

集成

在你已经使用的平台上运行 outpost——如 Namespace、Modal、E2B 等。

开始使用

核心指南

部署并接入 Devin

与 Devin 协作

产品使用指南

集成

Admin

发布说明

后续步骤

编排

集成

后续步骤

编排

集成

​后续步骤

编排

集成

​后续步骤

编排

集成

后续步骤

后续步骤