构建与运行

了解 Worker 如何在 CoreClaw 平台上构建和运行。

无需构建——轻量脚本模式

CoreClaw 没有传统的 Build 步骤。与需要构建 Docker 镜像的容器化平台不同，CoreClaw 采用轻量级进程隔离——你的脚本直接在平台预置的运行环境中执行。

用户代码(ZIP) → 自动安装依赖 → 脚本运行环境 → 远程指纹浏览器池(CDP) → 目标网站

CoreClaw 通过平台级托管消除了构建步骤：

运行环境是平台预置的 — Python/Node.js 运行时和基础依赖已安装在共享环境中，无需构建或配置运行时镜像。
浏览器是远程托管的 — 无需在项目中打包浏览器，通过 ChromeWs 环境变量（CDP/WebSocket）连接远程指纹浏览器池。详见浏览器指纹。
依赖安装是自动的 — 平台读取 requirements.txt 或 package.json 并在执行前自动安装依赖，无需手动构建镜像。
网络是沙箱隔离的 — 运行环境是隔离的网络沙箱，HTTP 请求类脚本必须使用平台内置的 SOCKS5 代理（通过 PROXY_AUTH 环境变量）。详见代理支持。

简单来说：上传 ZIP 包 → 平台自动处理剩余工作。这就是 CoreClaw 的优势：上传即运行。

当你上传 ZIP 包到 CoreClaw 时：

此过程全自动，通常在数秒内完成。

每次 Run 是 Worker 的一次执行。生命周期如下：

READY → RUNNING → SUCCEEDED / FAILED / ABORTING

每次运行在轻量级进程隔离环境中执行，包含：

预装运行时 — Python 3.x 或 Node.js，取决于你的项目
自动依赖 — 来自 requirements.txt / package.json 的依赖包
环境变量：
- PROXY_AUTH — SOCKS5 代理凭据（username:password），用于 HTTP 请求
- ChromeWs — WebSocket 地址，用于连接远程指纹浏览器
SDK 通信 — 与 CoreClaw 平台的 gRPC 通道（127.0.0.1:20086）

你可以通过控制台或 API 管理运行：

CoreClaw 会保留你所有的 Worker 运行记录。每次运行都会保存：

你可以通过 GET /api/v1/runs 列出所有运行记录，也可以在控制台查看详细信息。