🎁 Get the FREE AI Skills Starter GuideSubscribe →
BytesAgainBytesAgain
🦀 ClawHub

Coze 工作流执行 / Coze Workflow

by @noah-1106

Coze Workflow Executor | Coze 工作流执行技能 Execute Coze workflows with workflow_id and parameters. 接收参数调用工作流,返回执行结果。 Pure invocation layer with no business logic....

Versionv1.1.4
Downloads1,204
Stars1
TERMINAL
clawhub install coze-workflow

📖 About This Skill


name: coze_workflow version: 1.1.3 description: | Coze Workflow Executor | Coze 工作流执行技能 Execute Coze workflows with workflow_id and parameters. 接收参数调用工作流,返回执行结果。 Pure invocation layer with no business logic. 纯净的调用层,不处理业务逻辑。 Base skill for all Coze workflow integrations. 所有 Coze 工作流集成的基础技能。 homepage: https://www.coze.cn license: MIT

Coze Workflow | Coze 工作流执行技能

纯净的调用层技能。接收 workflow_idparameters,执行工作流,返回结果。这是其他 Coze 工作流技能依赖的基础技能

Pure invocation layer skill. Receives workflow_id and parameters, executes the workflow, and returns results. This is the base skill that other Coze workflow skills depend on.


依赖关系 / Dependencies

本技能被以下技能依赖 / This skill is a dependency for

  • image-gen-coze - 图像生成 / Image generation via Coze workflows
  • 其他自定义 Coze 工作流技能 / Other custom Coze workflow skills

  • 配置 / Configuration

    ~/.openclaw/skills/coze_workflow/config.json

    {
      "api_key": "pat_xxx",
      "base_url": "https://api.coze.cn"
    }
    


    职责边界 / Responsibility Boundaries

    | 职责 / Responsibility | coze_workflow | 业务技能 / Business Skill | |----------------------|---------------|---------------------------| | 执行工作流 / Execute workflow | ✅ | ❌ | | 参数构建 / Parameter building | ❌ | ✅ | | 结果解析 / Result parsing | ❌ | ✅ |


    调用方式 / Usage

    输入 / Input

    {
      "workflow_id": "string",
      "parameters": {}  // 任意 JSON / Any JSON
    }
    

    输出 / Output

    返回 Coze API 的原始响应 / Returns Coze API raw response:

    {
      "execute_id": "string",
      "status": "Success|Fail|Running",
      "output": "string",  // 工作流输出(JSON字符串)/ Workflow output (JSON string)
      "debug_url": "string"
    }
    


    执行方法 / Execution Methods

    方法 1:流式执行(推荐)/ Method 1: Stream (Recommended)

    curl -X POST "${COZE_BASE_URL}/v1/workflow/stream_run" \
      -H "Authorization: Bearer ${COZE_API_KEY}" \
      -H "Content-Type: application/json" \
      -d '{
        "workflow_id": "xxx",
        "parameters": {...}
      }'
    

    响应 / Response:SSE 流,提取 event: Messagedata.content 字段

    方法 2:轮询查询 / Method 2: Polling

    curl "${COZE_BASE_URL}/v1/workflows/{workflow_id}/run_histories/{execute_id}" \
      -H "Authorization: Bearer ${COZE_API_KEY}"
    


    版本历史 / Changelog

  • v1.1.3: 添加中英文对照 / Add bilingual support
  • v1.1.1: 明确职责边界 / Clarify responsibility boundaries
  • v1.1.0: 流式执行 + 轮询 / Stream + Polling
  • v1.0.0: 初始版本 / Initial version