π¦ ClawHub
pmtools
by @taoxiang-org
Operate Feishu OKR via Feishu OpenAPI (periods, OKR list, progress records, images, reviews). Invoke when you need to query or update OKR progress.
TERMINAL
clawhub install pmtoolsπ About This Skill
name: "pmtools" description: "Operate Feishu OKR via Feishu OpenAPI (periods, OKR list, progress records, images, reviews). Invoke when you need to query or update OKR progress." user-invocable: true metadata: openclaw: emoji: "π―" category: "productivity" requires: anyBins: ["python3", "python"] env: ["FEISHU_ACCESS_TOKEN"]
pmtools
Safety
Setup
FEISHU_ACCESS_TOKEN (either tenant_access_token or user_access_token) for most endpoints./reviews/query, set FEISHU_TENANT_ACCESS_TOKEN because the doc requires tenant_access_token.Auto-update
Auto-update is executed automatically before every command (with a 7-day local whitelist cache). To force-run and see the update result, run:
python3 scripts/pm_tools.py self-update
This checks for updates at most once per 7 days (local whitelist cache). If a newer version is detected, it updates first, then proceeds.
Commands
All commands print JSON to stdout.
Periods
python3 scripts/pm_tools.py periods-create --period_rule_id --start_month
python3 scripts/pm_tools.py periods-update-status --period_id --status <1|2|3>
python3 scripts/pm_tools.py periods-list [--page_token ] [--page_size ]
python3 scripts/pm_tools.py period-rules-list
OKRs
python3 scripts/pm_tools.py user-okrs-list --user_id --offset --limit [--user_id_type open_id|union_id|user_id|people_admin_id] [--lang zh_cn|en_us] [--period_id ...]
python3 scripts/pm_tools.py okrs-batch-get --okr_id ... [--user_id_type open_id|union_id|user_id|people_admin_id] [--lang zh_cn|en_us]
Progress records
python3 scripts/pm_tools.py progress-create --source_title --source_url --target_id --target_type <2|3> (--text | --content_json | --content_file ) [--percent ] [--status <-1|0|1|2>] [--source_url_pc ] [--source_url_mobile ]
python3 scripts/pm_tools.py progress-update --progress_id (--text | --content_json | --content_file )
python3 scripts/pm_tools.py progress-delete --progress_id
python3 scripts/pm_tools.py progress-get --progress_id
Images
python3 scripts/pm_tools.py image-upload --file --target_id --target_type <2|3>
Reviews
python3 scripts/pm_tools.py reviews-query --user_id ... --period_id ... [--user_id_type open_id|union_id|user_id|people_admin_id]
βοΈ Configuration
FEISHU_ACCESS_TOKEN (either tenant_access_token or user_access_token) for most endpoints./reviews/query, set FEISHU_TENANT_ACCESS_TOKEN because the doc requires tenant_access_token.