什么是 PCO CLI - Planning Center Services？

PCO CLI 是一个专门为与 Planning Center Services API 交互而设计的技术接口。该工具针对 Openclaw Skills 进行了优化，允许教会管理员和开发人员直接从终端管理礼拜规划、排程和媒体组织的复杂细节。它弥补了宗教组织手动 Web 管理与自动化数据处理之间的差距。

通过将其纳入您的 Openclaw Skills 库，您将能够编写教会工作流脚本、获取实时排程数据，并使用高性能 CLI 命令搜索广泛的歌曲数据库。无论您是在为周日礼拜做准备还是审计团队分配，PCO CLI 都为数据管理提供了结构化且高效的路径。

下载入口:https://github.com/openclaw/skills/tree/main/skills/rubyrunsstuff/pco

安装与下载

1. ClawHub CLI

从源直接安装技能的最快方式。

2. 手动安装

将技能文件夹复制到以下位置之一

优先级：工作区 > 本地 > 内置

3. 提示词安装

将此提示词复制到 OpenClaw 即可自动安装。

PCO CLI - Planning Center Services 应用场景

• 自动检索即将到来的周日礼拜计划和项目列表。
• 查询志愿者排程以识别未来日期的团队缺口。
• 在教会歌曲库中搜索特定的编曲和媒体附件。
• 将礼拜数据批量导出为 JSON 格式，用于外部报告或仪表板显示。

1. 通过为基于 TypeScript 的 CLI 设置别名来初始化环境。
2. 执行交互式身份验证设置，将凭据安全地存储在本地配置中。
3. 查询组织（Organization）和礼拜类型（Service Type）端点以映射事工结构。
4. 利用过滤搜索命令定位特定的计划、人员或媒体项目。
5. 使用 --json 或 --table 等全局标志处理输出，以便立即在其他应用程序中使用。

PCO CLI - Planning Center Services 配置指南

要在您的 Openclaw Skills 环境中开始使用此工具，请按照以下步骤操作：

# 定义别名以便轻松访问
alias pco="tsx /Users/ruby/Projects/pco-cli/pco.ts"

# 配置您的 Planning Center 凭据
pco auth setup

# 验证您的身份验证状态
pco auth status

PCO CLI - Planning Center Services 数据架构与分类体系

该技能使用分层分类法组织 Planning Center 数据。以下是支持的主要数据结构：

PCO CLI - Planning Center Services

CLI for the Planning Center Services API. Used for Shadow's church work (FBC Gulfport).

Repository

https://github.com/rubysworld/pco-cli

Location

/Users/ruby/Projects/pco-cli/pco.ts

Running

tsx /Users/ruby/Projects/pco-cli/pco.ts 

Or create an alias:

alias pco="tsx /Users/ruby/Projects/pco-cli/pco.ts"

Authentication

Credentials stored in ~/.config/pco-cli/config.json

# Check auth status
pco auth status

# Setup (interactive)
pco auth setup

# Logout
pco auth logout

Global Options

All list commands support:

• --json - Output as JSON (default)
• --table - Output as table
• --quiet - Output only IDs
• --limit - Limit results (default: 25)
• --offset - Offset results
• --all - Fetch all pages

Commands

Organization

pco org get                    # Get org info

Service Types

pco service-types list         # List all service types
pco st list                    # Alias
pco service-types get      # Get specific service type

Plans

# List plans (service-type required)
pco plans list --service-type 
pco plans list --service-type  --filter future
pco plans list --service-type  --filter past

# Get specific plan
pco plans get  --service-type 
pco plans get  --service-type  --include items,team_members

Filters: future, past, after, before, no_dates

Plan Items

pco items list --service-type  --plan 
pco items get  --service-type  --plan 

Scheduled People (Team Members)

pco scheduled list --service-type  --plan 

People

pco people list
pco people list --search "John Doe"
pco people get 

Teams

pco teams list --service-type 
pco teams get  --service-type 

Songs

pco songs list
pco songs list --search "Amazing Grace"
pco songs get 
pco songs arrangements 

Media

pco media list
pco media get 

Folders

pco folders list
pco folders get 

Series

pco series list
pco series get 

Tag Groups

pco tag-groups list
pco tag-groups tags 

Email Templates

pco email-templates list

Attachment Types

pco attachment-types list

Report Templates

pco report-templates list

Raw API

# Direct API access
pco api GET /service_types
pco api POST /endpoint --data '{"key": "value"}'
pco api PATCH /endpoint --file data.json
pco api DELETE /endpoint

Common Workflows

Get This Sunday's Service Plan

# 1. Find service type ID
pco st list --table

# 2. Get future plans
pco plans list --service-type  --filter future --limit 1

# 3. Get plan details with includes
pco plans get  --service-type  --include items,team_members

Who's Scheduled This Week?

pco scheduled list --service-type  --plan  --table

Search for a Song

pco songs list --search "Great Are You Lord"

Notes

• This is for PCO Services only (not People, Giving, etc.)
• API docs: https://developer.planning.center/docs/#/apps/services
• Context: Church work only — don't mix with Buape stuff

Updated: 2026-01-08