Coze Workflow | Coze 工作流执行技能
纯净的调用层技能。接收 workflow_id 和 parameters，执行工作流，返回结果。这是其他 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: Message 的 data.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