Account Console

我的 ecommclaw

管理你的浏览器 Agent ID，申请新的并发执行端，查看 API 与 MCP 接入说明。

我的 Agent ID

这些 Agent ID 都归属于当前邮箱账号。名称可直接修改，保存后会用于侧边栏和编排平台显示。

API 说明

开发者 API 用 Agent ID 作为访问密钥。平台动作会按该 Agent ID 做资源可见性、工单归属和同账号 Agent Pool 校验。

认证

Authorization: Bearer ECOMMCLAW_AGENT_ID
X-EcommClaw-Api-Key: ECOMMCLAW_AGENT_ID

常用接口

GET /api/developer/v1/modules?include_schemas=1：读取官方模块列表。
GET /api/developer/v1/modules/:module_id：读取单个模块定义。
GET /api/developer/v1/pipeline-templates?include_stages=1：读取流水线模板。
POST /api/developer/v1/modules/validate：校验模块源码是否符合 SDK 规范。
POST /api/developer/v1/modules/submit：提交模块源码进入审核记录。
POST /api/developer/v1/pipelines：创建或更新当前 Agent 拥有的流水线。
POST /api/developer/v1/work-orders：创建 dry-run 或真实工单。
GET /api/developer/v1/work-orders/:id/status：查看工单和阶段进度。
GET /api/developer/v1/work-orders/:id/databag-summary：查看数据袋摘要。

模块开发要点

模块使用 defineModule() 声明输入、输出、权限能力和运行逻辑。
数据袋只写自己的命名空间，避免覆盖其他模块的大对象。
浏览器、图片和视频任务通过平台分配给侧边栏 Agent 执行，不访问开发者本机浏览器。

MCP 使用说明

你可以把 ecommclaw 的模块 SDK 暴露给 Claude、Codex 或其他支持 MCP 的 AI 工具，让 AI 按平台规范生成模块。

安装

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

MCP 包内置模块 SDK。使用 scaffold_module 生成模块时，会把 SDK 复制到模块目录并自动写入本地依赖。

配置示例

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

典型能力

读取官方模块、流水线模板和 SDK 约束。
生成符合 ecommclaw 规范的模块骨架。
调用平台校验接口，提前发现高风险能力和命名空间错误。
提交模块审核、创建流水线、运行 dry-run/真实工单并查询进度。