dify-flow-access — dify 流访问
v1使用支持多轮上下文和流式响应的Dify API 查询和交互公司知识库或工作流。
by 运行时依赖
安装命令
点击复制技能文档
Dify 工作流 - OpenClaw CLI for Dify API 使用 OpenClaw 查询公司知识库或通过 Dify API 执行工作流。支持多轮对话和流式响应。
触发条件 当用户需要访问内部知识库、文档查询、Q&A 系统或执行特定工作流时，此技能处理这些请求，例如 "帮助我检查知识库" 或 "查询 Dify 工作流"。
功能 ✅ 调用 Dify Workflow API（工作流模式） ✅ 调用 Dify ChatApp API（聊天模式） ✅ 多轮对话上下文管理 ✅ 支持流式响应（逐步显示结果） ✅ 自动超时和错误处理 ✅ 可配置的请求参数
快速开始 # 基本 ChatApp 模式查询（推荐，无需工作流 ID） /dify-workflow "如何部署项目？" --chat # 工作流模式查询（需要指定工作流 ID） /dify-workflow "查询 AI 助手信息" --wf wf_123456abcdef # 多轮对话（使用之前响应的 conversation_id） /dify-workflow "那退款流程呢？" --conv conv_xyz789 # 流式响应（逐步显示结果） /dify-workflow "解释一下这个概念" --stream # 综合使用 /dify-workflow "查询中电港 AI 助手相关信息" --chat
配置 基础 URL：http://10.10.10.159/v1 API 密钥：app-jUhDcPj3lcnEG04JW4gRsfyy 环境变量（可选覆盖） 可以通过环境变量覆盖默认值： export DIFY_BASE_URL="http://your-dify-server/v1" export DIFY_API_KEY="your-api-key-here" export DEFAULT_TIMEOUT=120
命令行选项 选项 描述 示例 --chat 使用 ChatApp 模式（默认） --chat --wf ID 指定工作流 ID 以使用工作流模式 --wf wf_xxx --conv ID 指定对话 ID 以使用多轮对话 --conv conv_xxx --stream 启用流式响应模式 --stream
API 端点 工作流：POST /v1/workflows/run - 执行预定义工作流 聊天接口：POST /v1/chat-messages - 与知识库交互的聊天接口
请求格式示例 聊天模式 { "inputs": {}, "query": "用户查询", "conversation_id": "conv_xxx", // 可选，用于多轮对话 "response_mode": "blocking", // 或 "streaming" "user": "openclaw-user", "files": [] } 工作流模式 { "workflow_id": "wf_xxx", "inputs": { "query": "用户查询" }, "response_mode": "blocking", "user": "openclaw-user" }
响应提取 脚本自动从不同 Dify 响应格式中提取答案： 聊天接口：.data.answer 工作流：.data.outputs.answer 或 .data.outputs.* 高级聊天：.answer（顶级）
常见用例
- 知识库查询
- 多轮对话
- 执行特定工作流
- 流式输出大数据
故障排除 常见错误和解决方案 "not_workflow_app" 原因：使用工作流模式进行聊天接口 解决方案：使用 --chat 标志：/dify-workflow "query" --chat "conversation_id_invalid" 原因：过期或无效的对话 ID 解决方案：重新开始，不使用 --conv 选项 "workflow_not_found" 原因：无效的工作流 ID 解决方案：验证工作流 ID 是否存在于 Dify 应用中（应以 wf_ 开头） "query missing parameter" 原因：查询参数未包含在有效负载中 解决方案：确保查询正确指定
从 Dify Dashboard 获取 ID 聊天模式：无需额外设置 对话 ID 自动在响应中返回 工作流模式：打开 Dify 工作流应用 转到 "API Access" 或检查 URL 查找以 wf_ 开头的 ID
技术细节 Unicode 支持 自动解码 Unicode 转义序列（例如 \u4f60\u597d → 你好） 支持中文和其他多语言响应 错误处理 清晰的错误消息，带有可执行的建议 超时保护（默认 120 秒） 缺失依赖项的优雅降级
依赖项 Python 3.x（用于 JSON 解析和 Unicode 解码） curl（用于 HTTP 请求） jq（可选，用于高级输出格式）
版本信息 版本：1.0.0 最后更新：2026-05-20 作者：OpenClaw 团队 许可证：仅限内部使用
支持 对于问题或疑问： 检查上述故障排除部分 验证 Dify API 凭证和配置 确保与 Dify 服务器的网络连接：http://10.10.10.159/v1 注意：默认超时时间为 120 秒，以适应复杂的工作流执行。如有需要，可通过 DEFAULT_TIMEOUT 环境变量进行调整。