coze-workflow

What This Skill Does

The coze-workflow skill enables OpenClaw users to trigger Coze Workflow executions directly from their chat interface. By acting as a bridge to the Coze v1 streaming API, this skill allows for complex task automation, such as analyzing creative content risks or processing data, leveraging pre-built workflows. It is designed for seamless integration with Coze's infrastructure, supporting streaming responses to ensure users receive real-time updates on task status and final results.

Installation

To integrate this skill into your environment, use the following terminal command:

clawhub install openclaw/skills/skills/chocolatemale/coze-workflow-api

Ensure you have configured your Coze Personal Access Token (PAT) by exporting it as an environment variable:

export COZE_PAT_KEY="your_pat_token_here"

This setup allows the agent to authenticate securely with the Coze platform without hardcoding sensitive credentials into your scripts.

Use Cases

• Automated Content Analysis: Run workflows that scan advertising or creative assets for policy compliance or potential risks.
• Complex Data Processing: Offload data transformation or ingestion tasks to a pre-defined Coze workflow, handling outputs directly in the chat.
• Enterprise Task Orchestration: Integrate external business logic or API interactions hosted within Coze to perform multi-step operations initiated by a simple user prompt.

Example Prompts

1. "Coze workflow, please analyze the creative material with ID 1859150663345201 for any policy risks using the standard audit workflow."
2. "Run the latest workflow to process our weekly data summary; here are the parameters: {'date': '2023-10-27'}."
3. "Call the Coze workflow ID 7566546276516642834 to extract and format the key information from the provided input parameters."

Tips & Limitations

• Timeout Management: Since workflows can take time, ensure you use the --max-time 120 flag if running custom curl commands to prevent premature connection termination.
• Handling Responses: The tool provides streaming output. Look for the event: Message block to find the processed content and the event: Done block to confirm the final status.
• Error Handling: If you encounter a 401 error, verify that your PAT key hasn't expired. For 404 errors, double-check that your workflow_id matches the one configured in your Coze dashboard.
• Network Stability: Ensure your machine has consistent access to the Coze API endpoints, as regional network fluctuations might impact streaming connectivity.