从插件连接到流水线运行，一次看懂 ecommclaw

平台是什么

ecommclaw 是一个电商自动化编排平台。它不只是浏览器插件，也不只是几个脚本，而是把电商工作拆成可追踪的模块，再按业务顺序编排成流水线。每次运行都会形成工单，平台保存输入参数、阶段输出、数据袋、错误、人工处理状态和最终结果。

先理解三个核心名词

浏览器 Agent 为什么重要

很多电商操作必须发生在真实浏览器中：页面搜索、登录后台、上传图片、处理验证码、读取用户已登录页面。ecommclaw 的插件把用户浏览器变成一个 Agent，云端编排平台只负责调度，不保存平台登录密码。

AI 在流水线里做什么

AI 不是只负责聊天。它可以作为流水线中的判断器、生成器、审计器和开发助手。

第一步：安装插件并连接账号

Agent UUID
ffffffff-ffff-ffff-ffff-ffffffffffff

第二步：运行一条流水线

下面以电商上架类流水线为例，说明从配置到启动工单的完整路径。

第三步：配置多浏览器并行

当商品数量变大时，单个浏览器会成为瓶颈。ecommclaw 支持在模块配置里选择 agent pool，让多个浏览器 Agent 共同处理任务。

第四步：查看结果与排错

工单详情页是排查问题的入口。你可以看到每个阶段的输入、输出、HTML 视图、数据袋字段和错误原因。

示例：货源商品参考目标平台信息上架

这是一个典型电商自动化流水线。它以货源平台的商品和规格结构为主，同时从目标电商平台获取本地化标题、简介、特征参考，再生成可上架的数据。

后续可替换成真实录屏

当前页面已经使用系统界面示意图展示关键流程。你录好真实素材后，把文件放进 www.ecommclaw.com/assets/，我再替换对应示意图。

自定义模块开发

当内置模块不能覆盖你的业务时，可以开发自己的模块。模块需要声明输入 schema、输出 schema、能力标签和数据袋写入规则。平台可以把模块放进流水线，也可以根据模块声明生成配置界面。

defineModule({
  id: "my_shop_scraper",
  name: "抓取我的店铺数据",
  version: "1.0.0",
  type: "browser-agent",
  inputSchema: {
    type: "object",
    properties: {
      shop_url: { type: "string", title: "店铺链接" }
    },
    required: ["shop_url"]
  },
  outputSchema: { type: "object" },
  capabilities: ["browser:navigate", "databag:patch"],
  async run(ctx) {
    await ctx.browser.navigate(ctx.input.shop_url);
    const items = await ctx.browser.extract(".product-card", ["text", "href"]);
    await ctx.databag.addItems(items.map((item, index) => ({
      id: "item_" + index,
      type: "product",
      status: "done",
      module_outputs: {
        my_shop_scraper: { raw: item }
      }
    })));
    return { status: "success", metrics: { total: items.length } };
  }
});

用 AI 工具辅助开发模块

ecommclaw 已提供 MCP server，外部开发者可以在 Claude、Cursor 或其他支持 MCP 的 AI 工具中读取平台模块规范、生成模块模板、校验模块源码。

MCP 包内置模块 SDK。通过 scaffold_module 生成模块时，SDK 会被复制到模块目录，开发者只需在该目录执行 npm install。

npm install -g @ecommclaw/ops-mcp-server

MCP 配置示例：

{
  "mcpServers": {
    "ecommclaw-ops": {
      "command": "ecommclaw-ops-mcp",
      "env": {
        "ECOMMCLAW_API_BASE": "https://www.ecommclaw.com",
        "ECOMMCLAW_API_KEY": "ECOMMCLAW_AGENT_ID"
      }
    }
  }
}

MCP 可以读取模块规范、生成模块、校验源码、提交审核、创建流水线、运行 dry-run 或真实工单并查询状态。真正的浏览器操作、图片处理和视频处理仍由平台调度到已连接的侧边栏 Agent 执行，MCP 不直接操作开发者本机浏览器。

常见问题