Agent Workpress Skill

README

# OpenClaw × WordPress Skill

[English](./README.en.md)

让 OpenClaw 直接连接 WordPress，把内容运营中常见的发文、改稿、传图、审核评论、维护分类标签等动作，沉淀为可复用的 Skill 与脚本。

本项目包含两部分：
- **WordPress 插件**：为智能体提供专用 REST API
- **OpenClaw Skill**：为 OpenClaw 提供可调用的脚本、参数手册与复合流程

适合用于：
- AI 辅助内容运营
- WordPress 日常站点管理自动化
- 让 OpenClaw 执行标准化运营流程
- 为团队提供可控、可审计的 AI 操作入口

---

## 功能亮点

### 1. 面向运营的 WordPress 能力接入
通过插件暴露面向智能体调用的接口，支持：
- 授权码换取访问令牌
- 当前用户查询
- 能力查询
- 文章管理
- 页面管理
- 评论管理
- 媒体上传与媒体库查询
- 分类与标签管理

### 2. 面向 OpenClaw 的 Skill 封装
通过 `skills/` 目录提供 OpenClaw 可直接使用的 Skill 定义与脚本：
- `skills/SKILL.md`：Skill 说明与触发逻辑
- `skills/FORMS.md`：参数手册
- `skills/scripts/`：Node.js CLI 脚本
- `skills/examples/`：调用示例

### 3. 支持复合运营流程
除基础 CRUD 外，还支持复合技能流程：
- 上传图片并发布文章
- 创建分类后再发文
- 审核评论并回复
- 创建草稿并按需清理

---

## 目录结构

```text
.
├─ README.md
├─ skills/
│  ├─ SKILL.md
│  ├─ FORMS.md
│  ├─ examples/
│  └─ scripts/
└─ upload/
   ├─ agent-wordpress.php
   ├─ includes/
   ├─ agent-wordpress-接口示例.md
   └─ sdk/
```

---

## 快速开始

### 第一步：安装 WordPress 插件
将 `upload/` 中的插件文件安装到你的 WordPress 站点。

### 第二步：配置授权信息
在 WordPress 后台配置：
- 智能体操作用户 ID
- 固定授权码

### 第三步：接入 OpenClaw Skill
将本仓库的 `skills/` 目录接入 OpenClaw 的 Skill 目录。

### 第四步：开始调用
使用 OpenClaw 或直接运行 `skills/scripts/*.js`，即可完成 WordPress 运营动作。

---

## 功能介绍

### 文章管理
支持：
- 创建文章
- 查询文章列表
- 获取单篇文章
- 更新文章
- 删除文章
- 设置草稿或发布状态
- 指定分类、标签、摘要

相关接口与脚本：
- 插件接口示例：`upload/agent-wordpress-接口示例.md:42`
- Skill 脚本说明：`skills/scripts/README.md:137`

### 页面管理
支持：
- 创建页面
- 查询页面列表

相关位置：
- 插件主入口加载页面模块：`upload/agent-wordpress.php:26`
- Skill 脚本说明：`skills/scripts/README.md:217`

### 评论管理
支持：
- 查询评论
- 创建评论
- 编辑评论
- 删除评论
- 审核评论

相关位置：
- 插件主入口加载评论模块：`upload/agent-wordpress.php:27`
- Skill 脚本说明：`skills/scripts/README.md:250`

### 媒体管理
支持：
- 上传图片
- 查询媒体库
- 支持本地路径、远程 URL、Base64 三种图片输入方式

相关位置：
- 插件主入口加载媒体模块：`upload/agent-wordpress.php:24`
- Skill 脚本说明：`skills/scripts/README.md:319`

### 分类与标签管理
支持：
- 获取分类列表
- 创建分类
- 获取标签列表

相关位置：
- 插件主入口加载分类模块：`upload/agent-wordpress.php:28`
- Skill 脚本说明：`skills/scripts/README.md:359`

### 认证与能力发现
支持：
- 通过授权码换取访问令牌
- 查询当前用户
- 查询 Agent 可用能力

相关位置：
- 插件描述：`upload/agent-wordpress.php:5`
- 接口示例：`upload/agent-wordpress-接口示例.md:3`
- Skill 参数说明：`skills/FORMS.md:25`

---

## WordPress 安装方法

### 1. 环境要求
根据插件头信息，要求：
- WordPress >= 5.0
- PHP >= 7.2

参考：`upload/agent-wordpress.php:3`

### 2. 安装插件
本项目的 WordPress 插件核心文件位于：
- `upload/agent-wordpress.php`
- `upload/includes/`

推荐安装方式：

1. 新建插件目录，例如 `agent-wordpress`
2. 将以下内容放入该目录：
   - `agent-wordpress.php`
   - `includes/`
3. 将该目录压缩为 `agent-wordpress.zip`
4. 登录 WordPress 后台
5. 进入 **插件 → 安装插件 → 上传插件**
6. 上传压缩包并启用插件

你也可以直接将目录复制到：

```text
wp-content/plugins/agent-wordpress/
```

然后在 WordPress 后台启用。

### 3. 配置插件
插件启用后，请到后台配置以下内容：
- 智能体操作用户 ID
- 固定授权码

建议：
- 操作用户使用 `author`、`editor` 或更高权限账号
- 固定授权码使用高强度随机字符串
- 生产环境启用 HTTPS

### 4. 插件能力范围
插件会加载以下模块：
- 鉴权：`upload/agent-wordpress.php:23`
- 媒体：`upload/agent-wordpress.php:24`
- 文章：`upload/agent-wordpress.php:25`
- 页面：`upload/agent-wordpress.php:26`
- 评论：`upload/agent-wordpress.php:27`
- 分类标签：`upload/agent-wordpress.php:28`
- REST 注册：`upload/agent-wordpress.php:29`

### 5. 调试接口
安装完成后，可先用授权码换 token：

```bash
curl -X POST "https://你的站点/wp-json/agent-wordpress/v1/auth/exchange" \
  -H "Content-Type: application/json" \
  -d '{"auth_code":"你的固定授权码"}'
```

更多接口示例见：
- `upload/agent-wordpress-接口示例.md`

---

## OpenClaw 安装 Skill 方法

### 1. Skill 目录说明
本项目的 OpenClaw Skill 位于：
- `skills/`

关键文件：
- `skills/SKILL.md`
- `skills/FORMS.md`
- `skills/scripts/README.md`
- `skills/examples/`
- `skills/scripts/*.js`

### 2. 运行环境
Skill 脚本要求：
- Node.js 18+

而 SDK 目录声明：
- Node.js >= 20

如果你需要使用 `upload/sdk/` 中的构建与测试能力，请按 Node.js 20+ 准备环境。

参考：
- `skills/SKILL.md:74`
- `upload/sdk/package.json:6`

### 3. 安装 Skill
将本仓库 `skills/` 目录复制到 OpenClaw 的 Skill 目录中，保证至少包含：
- `SKILL.md`
- `FORMS.md`
- `examples/`
- `scripts/`

如果你的 OpenClaw 支持目录式加载，一般复制整个 `skills` 目录即可。

### 4. 使用前准备参数
所有脚本共用以下参数：
- `--base-url`：WordPress 站点地址或 API 地址
- `--token` 或 `--auth-code`：认证信息，至少提供一种
- `--verbose`：可选，输出详细日志

参考：`skills/FORMS.md:5`

### 5. 常用命令示例

#### 获取当前用户
```bash
node skills/scripts/users.js me --base-url http://your-site.com --token <TOKEN>
```

#### 查询能力
```bash
node skills/scripts/agent.js capabilities --base-url http://your-site.com --token <TOKEN>
```

#### 创建文章
```bash
node skills/scripts/posts.js create \
  --base-url http://your-site.com \
  --token <TOKEN> \
  --title "标题" \
  --content "正文" \
  --status draft
```

#### 上传图片并发布文章
```bash
node skills/scripts/skills.js publish-post-with-image \
  --base-url http://your-site.com \
  --token <TOKEN> \
  --image-url "https://example.com/cover.png" \
  --title "标题" \
  --content "正文" \
  --status publish
```

### 6. 推荐接入顺序
1. 先在 WordPress 安装并配置插件
2. 用 `auth-code` 交换 `token`
3. 运行 `users.js me` 验证鉴权
4. 再接入文章、媒体、评论等业务命令
5. 最后接入 `skills.js` 复合流程

参考：`skills/scripts/README.md:512`

---

## 使用示例

### 示例 1：运营同学让 OpenClaw 发一篇草稿
可由 OpenClaw 调用：
- `posts.js create`

适用场景：
- AI 写完初稿后直接进入 WordPress 草稿箱

### 示例 2：上传封面图并直接发布
可由 OpenClaw 调用：
- `skills.js publish-post-with-image`

适用场景：
- 图文内容一体化发布

### 示例 3：审核评论并自动回复
可由 OpenClaw 调用：
- `skills.js moderate-comment-and-reply`

适用场景：
- 评论区自动化运营

---

## 截图展示

### WordPress 插件设置页
![WordPress 插件设置](docs/plugin-settings.png)