Coze Workflow Skill
直接在 OpenClaw 中调用 Coze Workflow API。
前置配置
设置 PAT Key 环境变量：
export COZE_PAT_KEY="your_pat_token_here"
使用方法
直接使用 curl
curl -s --location --request POST 'https://api.coze.com/v1/workflow/stream_run' \
--header "Authorization: Bearer $COZE_PAT_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"workflow_id": "your_workflow_id",
"parameters": {
"key": "value"
}
}' \
--max-time 120
保存结果到文件
curl -s --location --request POST 'https://api.coze.com/v1/workflow/stream_run' \
--header "Authorization: Bearer $COZE_PAT_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"workflow_id": "your_workflow_id",
"parameters": {
"key": "value"
}
}' \
--max-time 120 > /tmp/coze_result.txt
参数说明
| 参数 | 位置 | 说明 |
|---|---|---|
workflow_id | data-raw | Coze Workflow ID |
parameters | data-raw | Workflow 输入参数 (JSON 对象) |
COZE_PAT_KEY | header | PAT Token，通过环境变量传入 |
示例
示例: 分析创意素材风险
export COZE_PAT_KEY="your_pat_token_here"
curl -s --location --request POST 'https://api.coze.com/v1/workflow/stream_run' \
--header "Authorization: Bearer $COZE_PAT_KEY" \
--header 'Content-Type: application/json' \
--data-raw '{
"workflow_id": "7566546276516642834",
"parameters": {
"id": "1859150663345201",
"id_type": "creative"
}
}' \
--max-time 120
响应格式
流式响应，每行一个事件：
id: 0
event: PING
data: {...}
id: 1
event: Message
data: {"content":"...","node_type":"End",...}
id: 2
event: Done
data: {"debug_url":"..."}
关键字段：
event: Message- 包含 workflow 执行结果event: Done- 执行完成node_type: End- 结束节点
故障排查
超时 (28)
- 原因: API 响应较慢（通常 30-60 秒）
- 解决: 增加
--max-time 120
HTTP 401
- 原因: PAT Key 无效
- 解决: 检查 PAT Key 是否正确
HTTP 404
- 原因: Workflow ID 不存在
- 解决: 确认 workflow_id
连接失败
- 国内网络可能不稳定，重试即可