Coze 工作流执行 / Coze Workflow

# 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`：

```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

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

输出 / Output

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

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

---

执行方法 / Execution Methods

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

```bash 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

```bash 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