概述

云效项目协作 API

通过云效 OpenAPI 管理工作项（任务、需求、缺陷等）。

🤖 AI 决策指南

用户意图识别

用户说法	意图	执行动作
----------	------	----------
"查看我的任务" / "我有什么工作项"	查询工作项	指定项目后调用 `list_workitems.py`
"查看任务详情"	查询单个工作项	调用 `get_workitem.py`
"创建一个任务" / "新建工作项"	创建工作项	先确认项目，再调用 `create_workitem.py`
"更新任务" / "修改任务标题"	更新工作项	调用 `update_workitem.py`
"完成任务" / "关闭任务"	更新状态	调用 `update_workitem.py --status`
"列出所有项目"	查看项目	调用 `list_projects.py`

⚠️ 创建任务时的交互流程

重要：创建工作项时，如果用户没有指定项目，必须先询问用户！

用户说："帮我创建一个任务"
AI 先查询项目列表：python3 list_projects.py
AI 展示可选项目，询问用户："要创建在哪个项目？"
用户选择后，再创建任务

不要在未确认项目的情况下直接使用默认项目创建！

📋 命令速查

查询项目列表

python3 ~/.openclaw/workspace/skills/yunxiao/scripts/list_projects.py

查询工作项详情

python3 ~/.openclaw/workspace/skills/yunxiao/scripts/get_workitem.py <workitem_id>

创建工作项

# 必须指定项目
python3 ~/.openclaw/workspace/skills/yunxiao/scripts/create_workitem.py \
  --subject "任务标题" \
  --project "AI 产研"

# 完整参数
python3 ~/.openclaw/workspace/skills/yunxiao/scripts/create_workitem.py \
  --subject "任务标题" \
  --project "AI 产研" \
  --type "任务" \
  --priority "高" \
  --desc "任务描述"

更新工作项

# 修改标题
python3 ~/.openclaw/workspace/skills/yunxiao/scripts/update_workitem.py <id> --subject "新标题"

# 修改描述
python3 ~/.openclaw/workspace/skills/yunxiao/scripts/update_workitem.py <id> --desc "新描述"

📁 脚本说明

脚本名	用途
--------	------
`yunxiao_api.py`	API 基础模块
`list_projects.py`	查询项目列表
`get_workitem.py`	查询单个工作项详情
`create_workitem.py`	创建工作项（需指定项目）
`update_workitem.py`	更新工作项
`list_workitems.py`	查询工作项列表（需指定项目）

🔧 API 端点

基础 URL: https://openapi-rdc.aliyuncs.com

认证方式: 请求头 x-yunxiao-token

操作	方法	路径
------	------	------
搜索项目	POST	`/oapi/v1/projex/organizations/{orgId}/projects:search`
查询详情	GET	`/oapi/v1/projex/organizations/{orgId}/workitems/{id}`
创建	POST	`/oapi/v1/projex/organizations/{orgId}/workitems`
更新	PUT	`/oapi/v1/projex/organizations/{orgId}/workitems/{id}`

📝 工作项类型

任务 (Task): 开发任务、测试任务等
需求 (Req): 产品需求
缺陷 (Bug): Bug 修复
风险 (Risk): 项目风险

⚠️ 权限要求

Token 需要以下权限：

项目协作 > 项目 > 只读（查询项目列表）
项目协作 > 工作项 > 只读（查询）
项目协作 > 工作项 > 读写（创建、更新）

最后更新: 2026-03-16

版本历史

共 1 个版本

v1.0.0 当前

2026-03-30 06:38 安全安全

安全检测

腾讯云安全 (Keen)

安全，无风险

查看报告

腾讯云安全 (Sanbu)