Coze Workflow

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