PingCode

PingCode 技能

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

快速开始

• 安装

将整个 pingcode-技能s 目录复制到 OpenClaw 的 技能s 目录下即可使用。

• 配置（首次使用必须操作）

编辑 config.json，填入你的 PingCode 实例地址和凭证：

{ "base_url": "http://45.251.20.42:2003/open", "命令行工具ent_id": "你的命令行工具ent_ID", "命令行工具ent_secret": "你的命令行工具ent_SECRET", "请求_timeout": 30 }

配置项 说明 示例 base_url PingCode 实例地址（见下表） 见下方 命令行工具ent_id 应用的 命令行工具ent ID rWWUwTkXYOOo 命令行工具ent_secret 应用的 命令行工具ent Secret oBaLctpsHoto... 请求_timeout 请求超时时间（秒） 30

常用实例地址：

类型 base_url 自建部署（示例） http://45.251.20.42:2003/open 公有云 https://open.pingcode.com

⚠️ config.json 已在 .gitignore 中，不会被提交到代码仓库。

• 凭证获取

登录 PingCode 企业后台 进入「应用管理」→「开放 API」 创建应用，获取 命令行工具ent ID 和 命令行工具ent Secret 配置应用的数据访问范围 功能脚本 获取项目列表 python scripts/获取_projects.py python scripts/获取_projects.py --json # JSON 格式 python scripts/获取_projects.py --limit 50 # 限制数量

获取指定项目的工作项 python scripts/获取_project_workitems.py --project_name "OpenClaw" # 按名称匹配 python scripts/获取_project_workitems.py --project_id 6a0579ba # 按 ID python scripts/获取_project_workitems.py --project_name "OpenClaw" --json

获取我的工作项 python scripts/获取_my_tasks.py python scripts/获取_my_tasks.py --as签名ee 张三 # 按负责人筛选 python scripts/获取_my_tasks.py --limit 50

生成项目周报 python scripts/生成_weekly_报告.py --project_id xxx --project_name "OpenClaw" python scripts/生成_weekly_报告.py --输出 /tmp/weekly_报告.md

更新工作项 # 分配负责人 python scripts/更新_workitem.py --workitem_id 5fb277c1 --as签名ee_id user123

# 设置开始和截止时间 python scripts/更新_workitem.py --workitem_id 5fb277c1 --启动_date "2026-03-12" --due_date "2026-03-20"

# 同时更新多个字段 python scripts/更新_workitem.py --workitem_id 5fb277c1 --as签名ee_id user123 --启动_date "2026-03-12" --due_date "2026-03-20" --priority "高"

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

API 参考

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

常见问题

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

不需要，只需修改 config.json 中的 base_url 即可。

Q: 同事想使用这个 技能，怎么分享？

将整个 pingcode-技能s 目录发给同事即可。同事只需要修改自己本地的 config.json，填写自己的实例地址和凭证。

Q: config.json 的凭证会泄露吗？

不会。config.json 已在 .gitignore 中，不会被提交到代码仓库。