Coze Workflow

Coze Workflow | Coze 工作流执行技能

English: 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.

中文: 纯净的调用层技能。接收 workflow_id 和 parameters，执行工作流，返回结果。这是其他 Coze 工作流技能依赖的基础技能。

Dependencies | 依赖关系

This skill is a dependency for: | 本技能被以下技能依赖：

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

配置

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

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

职责边界

调用方式

输入

{
  "workflow_id": "string",
  "parameters": {}  // 任意 JSON，由业务技能定义
}

输出

返回 Coze API 的原始响应：

{
  "execute_id": "string",
  "status": "Success|Fail|Running",
  "output": "string",  // 工作流输出（JSON字符串，业务技能解析）
  "debug_url": "string"
}

执行方法

方法 1：流式执行（推荐）

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": {...}
  }'

响应：SSE 流，提取 event: Message 的 data.content 字段

方法 2：轮询查询

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

版本

• v1.1.1: 明确职责边界，纯净调用层
• v1.1.0: 流式执行 + 轮询
• v1.0.0: 初始版本