核心用法
coze_workflow 是一个基础设施层技能，定位为 Coze（字节跳动旗下 AI 应用开发平台）工作流的纯净执行代理。用户需提供 workflow_id 和自定义参数，技能负责发起 HTTP 请求并返回 Coze API 的原始响应。
两种执行模式：
1. 流式执行（推荐）：通过 /v1/workflow/stream_run 端点建立 SSE 连接，实时获取工作流输出，适合长耗时任务
2. 轮询查询：先获取 execute_id，再轮询 /v1/workflows/{id}/run_histories/{execute_id} 查询最终状态
配置要求：
- 在
~/.openclaw/skills/coze_workflow/config.json中配置api_key（需 Coze 平台个人访问令牌pat_xxx）和base_url - 国内版默认
https://api.coze.cn，国际版为https://api.coze.com
显著优点
- 职责单一：严格遵循"调用层"定位，不介入参数构建、结果解析或业务逻辑，便于上层技能复用
- 流式支持：原生 SSE 实现，降低长工作流的心理等待成本
- 官方生态：直接对接字节跳动 Coze 官方 API，功能迭代与平台同步
潜在缺点与局限性
- 前置成本高：需用户自行准备 Coze 账号、创建工作流、获取 API Key，对非 Coze 用户形成门槛
- 零封装：返回原始 JSON 字符串，需上层业务技能自行解析
output字段 - 网络依赖：国内版 API 存在潜在访问稳定性问题，需自备网络环境
- 无重试机制：文档未体现内置指数退避或错误恢复策略
适合人群
- 已在 Coze 平台搭建工作流的开发者
- 需要快速将 Coze 能力集成到 OpenClaw 生态的上层技能作者
- 偏好"薄封装"、追求极致灵活度的基础设施使用者
常规风险
| 风险类型 | 说明 |
|---------|------|
| **密钥泄露** | API Key 以明文形式存储于本地配置文件，需确保文件系统权限控制 |
| **计费不可控** | Coze 平台对工作流执行按 token 或次数计费，本技能无额度限制或预警机制 |
| **数据出境** | 若使用国际版 API，需注意数据合规性；国内版受字节跳动服务条款约束 |
| **调试困难** | 仅返回 `debug_url`，错误排查需跳转 Coze 平台，打断本地开发流 |
---
技能版本：v1.1.2 | License: MIT