Install
openclaw skills install @hanjin714/coze-workflow-runneropenclaw skills install @hanjin714/coze-workflow-runner通过 Coze API 调用工作流,执行自动化任务。目前支持生成宠物知识卡片等图像生成工作流。
服务令牌存储在:~/workspace-prod/coze/coze-tokens.md
首次使用时确认令牌有效。
工作流列表存储在:~/workspace-prod/coze/workflows.md
包含每个工作流的 ID、链接和用途说明。
使用 cozepy 库调用:
import cozepy
# 认证
auth = cozepy.TokenAuth(token='你的服务令牌')
coze = cozepy.Coze(auth=auth, base_url='https://api.coze.cn')
# 调用工作流
response = coze.workflows.runs.create(
workflow_id='工作流ID',
parameters={'input': '输入参数'}
)
调用示例:
import cozepy
auth = cozepy.TokenAuth(token='你的服务令牌')
coze = cozepy.Coze(auth=auth, base_url='https://api.coze.cn')
response = coze.workflows.runs.create(
workflow_id='7610429408704413759',
parameters={'input': '7:/ xxx:】'}
)
调用示例:
import cozepy
auth = cozepy.TokenAuth(token='你的服务令牌')
coze = cozepy.Coze(auth=auth, base_url='https://api.coze.cn')
response = coze.workflows.runs.create(
workflow_id='7610527662062665754',
parameters={'input': '布偶猫宠物知识卡片:布偶猫又称布拉多尔猫,是体型和体重最大的猫品种之一。'}
)
# 返回: {"output": ["https://s.coze.cn/t/xxx/", ...]}
工作流返回的是短链接,需要跟随跳转才能获取真实图片 URL:
import subprocess
urls = response['data']['output']
for i, url in enumerate(urls, 1):
# curl -L 自动跟随跳转,直接下载图片
subprocess.run(['curl', '-sL', url, '-o', f'pet_card_{i}.png'])
~/workspace-prod/coze/coze-tokens.md - 服务令牌~/workspace-prod/coze/workflows.md - 工作流列表最后更新:2026-03-24