PingCode

PingCode 研发管理平台 API 集成。支持查询工作项、生成周报、管理项目进度等。使用场景:研发管理自动化、团队协作、数据分析。

Audits

Warn

Install

openclaw skills install pingcode-skills-zhaohenanhai

PingCode Skill

通过 PingCode Open API 操作研发管理平台数据。支持公有云自建部署两种实例类型。

快速开始

1. 安装

执行上面的安装命令 或 将整个 pingcode-skills 目录复制到 OpenClaw 的 skills 目录下即可使用。

2. 配置(首次使用必须操作)

可以直接发消息配置

如:"帮我把 PingCode 配置改成base_url是http://192.168.1.203/open,client_id 是rWWUwTkXYOOo,client_secret 是hwhjFMRXZChJycKUkppHxxxx"

也可以直接编辑 config.json,填入你的 PingCode 实例地址和凭证:

{
  "base_url": "http://192.168.1.203/open",
  "client_id": "你的Client_ID",
  "client_secret": "你的Client_SECRET",
  "request_timeout": 30
}
配置项说明示例
base_urlPingCode 实例地址(见下表)见下方
client_id应用的 Client IDrWWUwTkXYOOo
client_secret应用的 Client SecrethwhjFMRXZChJ...
request_timeout请求超时时间(秒)30

常用实例地址:

类型base_url
自建部署(示例)http://192.168.1.203/open
公有云https://open.pingcode.com

3. 凭证获取

  1. 登录 PingCode 企业后台
  2. 进入「应用管理」→「开放 API」
  3. 创建应用,获取 Client IDClient Secret
  4. 配置应用的数据访问范围

功能脚本

获取项目列表

python scripts/get_projects.py
python scripts/get_projects.py --json           # JSON 格式
python scripts/get_projects.py --limit 50       # 限制数量

获取指定项目的工作项

python scripts/get_project_workitems.py --project_name "openclaw"   # 按名称匹配
python scripts/get_project_workitems.py --project_id 6a0579ba      # 按 ID
python scripts/get_project_workitems.py --project_name "openclaw" --json

获取我的工作项

python scripts/get_my_tasks.py
python scripts/get_my_tasks.py --assignee 张三      # 按负责人筛选
python scripts/get_my_tasks.py --limit 50

生成项目周报

python scripts/generate_weekly_report.py --project_id xxx --project_name "openclaw"
python scripts/generate_weekly_report.py --output /tmp/weekly_report.md

更新工作项

# 分配负责人
python scripts/update_workitem.py --workitem_id 5fb277c1 --assignee_id user123

# 设置开始和截止时间
python scripts/update_workitem.py --workitem_id 5fb277c1 --start_date "2026-03-12" --due_date "2026-03-20"

# 同时更新多个字段
python scripts/update_workitem.py --workitem_id 5fb277c1 --assignee_id user123 --start_date "2026-03-12" --due_date "2026-03-20" --priority "高"

# 更新状态
python scripts/update_workitem.py --workitem_id 5fb277c1 --status "进行中"

API 参考

详见 references/api_docs.md 或访问 https://open.pingcode.com/

常见问题

Q: 切换实例需要修改代码吗?

不需要,只需直接发消息变更配置信息 或手动配置修改 config.json 中的 base_urlclient_idclient_secret即可。