name: wordpress
description: OpenClaw 技能，提供基于纯 HTTP 的 WordPress REST API 命令行工具，支持文章、页面、分类、标签、用户及自定义请求操作。

WordPress REST API 技能（高级版）

目的

为 WordPress REST API 自动化提供生产就绪的命令行工具。本技能专注于内容工作流（文章/页面）、分类法（分类/标签）、用户读取以及无需外部 HTTP 库的安全自定义请求。

适用场景

• 您需要一个稳定的 CLI 用于自动化和机器人工作流。
• 您需要 JSON 输入/JSON 输出以适配流水线处理。
• 您倾向于使用简单 HTTP 且无额外依赖。

不适用场景

• 您必须处理 OAuth 流程或基于浏览器的复杂认证。
• 您需要高级媒体上传（多部分流式传输）。

要求

• Node.js 18+（需原生 fetch 支持）。

一次性设置

1. 启用 WordPress REST API（现代 WordPress 默认已开启）。
2. 为 WordPress 用户创建一个“应用程序密码”。
3. 确认该用户具有相应角色权限（例如编辑/管理员）。

安装

cd wordpress
npm install

运行

node scripts/wp-cli.js help
node scripts/wp-cli.js posts:list --query per_page=5
node scripts/wp-cli.js posts:create '@post.json'

也可使用 npm：

npm run wp -- posts:list --query per_page=5

认证凭证

支持的选项（按优先级匹配）：
- 基础认证令牌：WP_BASIC_TOKEN（用户名:应用密码 的 base64 编码）
- 用户名 + 应用密码：WP_USER + WP_APP_PASSWORD
- JWT 持有者令牌：WP_JWT_TOKEN

必需环境变量

• WP_BASE_URL（例如：https://example.com）

输入约定

• JSON 可内联输入，或通过 @文件路径 从文件加载。
• 查询参数使用 --query 键=值（可重复）或 --query 键1=值1,键2=值2 格式。

命令概览

文章：
- posts:list, posts:get, posts:create, posts:update, posts:delete

页面：
- pages:list, pages:get, pages:create, pages:update, pages:delete

分类法：
- categories:list, categories:create
- tags:list, tags:create

用户：
- users:list, users:get

高级：
- request（原始方法 + 路径）

操作指南

• 只读列表调用建议使用 context=view。
• 暂存内容时使用 status=draft。
• 在编排器中针对 429 和临时性 5xx 错误实施重试机制。

预期输出

• JSON 输出至标准输出；出错时返回非零退出码。

安全提示

• 切勿记录或提交令牌或应用程序密码。
• 尽可能使用专用的低权限 WordPress 账户。