OpenClaw AI for WordPress
将你自托管的 OpenClaw AI 网关集成到 WordPress，把本地 AI 能力带到你的 WordPress 网站。
项目地址：https://cnb.cool/code_free/openclaw-wordpress
作者：陌涛
功能特性
- 📝 内容创作工具
- AI 自动生成文章大纲
- 根据大纲生成完整文章 → 一键生成整篇博客
- AI 优化文章标题 → 一键生成 5 个可选标题
- 自动生成 SEO 标题、描述、聚焦关键词
- 自动文章摘要
- 支持自定义风格改写内容
- 生成结果支持一键插入编辑器
- 支持 HTML/Markdown 两种插入格式
- 同时兼容古登堡编辑器 + 经典编辑器
- 全部通过你本地的 OpenClaw 网关处理
- 🖼️ 媒体自动化
- 上传图片自动生成 SEO 友好的 ALT 文本
- 节省图片 SEO 时间
- 🤖 自动定时发布
- 开启后每天自动生成指定数量文章
- 基于热门话题自动创作发布
- 支持设置 1-10 篇/天
- 💬 开发中的功能
- ⚠️ AI 评论审核（开发中）
- ⚠️ 自动回复访客评论（开发中）
- ⚠️ 基于网站内容的访客 AI 聊天机器人（开发中）
- 以上功能默认关闭，请勿在生产环境启用
环境要求
- WordPress 5.8+
- PHP 7.4+
- 运行中的 OpenClaw 网关并开启 API 访问
- OpenClaw API 密钥
安装方法
- 下载 最新发行版
- 上传到你的 WordPress 插件目录
- 激活插件
- 进入 设置 → OpenClaw AI
- 按下面说明填写配置
- 保存并测试连接
- 在文章编辑器开始使用 AI 工具！
配置说明
⚠️ 重要：模型名填写规则
OpenClaw 网关要求插件里的默认模型必须填 openclaw/main，不要直接填模型 ID！
模型已经在 OpenClaw 服务端配置好了，插件只需要指定 agent 即可。
| 配置项 | 填写说明 |
|---|---|
| OpenClaw 网关地址 | IP 或域名，不要加不要加 http:// 和端口，例：xxx.xxx.xxx.xxx 或 example.com |
| 网关端口 | OpenClaw 网关端口，默认 23057 |
| 协议 | 绝大多数是 HTTP，配置 SSL 证书后改为 HTTPS |
| 基础路径 | 如果 OpenClaw 配置了 gateway.controlUi.basePath，请选择「自定义」并填写基础路径：• 根路径（默认）→ 大多数情况选这个 • 自定义 → 如果你配置了自定义basePath，填写对应路径，例如 /llm |
| API 密钥 | 你的 OpenClaw 网关 token，在 ~/.openclaw/openclaw.json → gateway.auth.token |
| 默认模型 | ✅ 必须填 openclaw/main，不要直接填模型 ID |
| 请求超时时间 | API 请求超时秒数，默认 600（10分钟），生成长文章建议 600-900 |
| 单次生成字数 | ⭐ 新增！ 每次生成文章的字数（300-1500字）。服务器性能一般设 300-500，性能好设 800-1000。系统会自动分段生成并拼接。 |
| 自动发布分类 | 自动发布的文章默认分到哪个分类 |
| 每天自动发布篇数 | 1-10，推荐 3 |
功能开关
- SEO 优化 – 在文章编辑器启用 SEO 工具
- 自动 ALT 文本 – 上传图片时自动生成 ALT 文本
- 自动发布 – 开启每日自动发布 AI 文章
使用方法
文章编辑器
激活后，你会在文章编辑器侧边栏看到「OpenClaw AI 工具」：
- 生成大纲 – 从文章标题生成文章结构大纲，选择 HTML/Markdown 格式，生成后点击「插入到编辑器」
- 根据大纲生成完整文章 – 大纲插入后，点击这里直接生成完整文章
- 优化文章标题 – 根据原标题生成 5 个优化后的标题供选择，选好插入
- 生成摘要 – 从内容自动生成文章摘要，自动填入摘要框
- 优化 SEO – 生成 SEO 标题、描述和关键词建议
✅ 同时支持 古登堡编辑器 和 经典编辑器，插入按钮会自动识别插入。 ✅ 可以选择输出 HTML 格式（适合经典编辑器）或 Markdown 格式（适合 Markdown 编辑器）
自动 ALT 文本
只需要开启功能，之后你上传的每一张新图片都会自动由 AI 生成 ALT 文本。
自动发布文章
- 在设置中勾选「启用定时自动发布 AI 文章」
- 设置每天发布数量（1-10）
- WordPress 通过 WP-Cron 每天自动执行，生成文章并发布
- 测试方法：登录管理员后访问
你的网站/?openclaw-trigger-auto即可手动触发一次
常见问题
Q: 测试连接返回 Invalid model. Use openclaw or openclaw/<agentId>
A: 默认模型必须填 openclaw/main，不要直接填模型ID，模型已经在 OpenClaw 配置好了。
Q: 请求超时（HTTP 554）
症状：
- 点击生成按钮后显示 “⏱️ 请求超时，可能是网络波动或内容过长”
- 提供”重试”按钮，但重试后仍然超时
- OpenClaw 网关实际上已经返回了结果，但 WordPress 显示超时
原因分析：
- PHP 执行时间限制 – PHP 脚本执行时间超过了配置的超时时间
- 前端 AJAX 超时 – JavaScript 等待时间不足
- 内容过长 – 单次生成的内容太多，处理时间超过限制
- 服务器资源不足 – CPU/内存占用过高导致响应慢
解决方案（按优先级尝试）：
方案 1：使用诊断工具（推荐）⭐
插件提供了完整的诊断工具，可以自动检查所有配置并给出优化建议。
使用步骤：
- 上传诊断文件
# 将 diagnostic.php 上传到 WordPress 根目录 cp diagnostic.php /path/to/wordpress/ - 访问诊断页面
https://your-site.com/diagnostic.php（需要管理员登录）
- 查看诊断报告
- 📦 插件信息
- ⚙️ PHP 配置（max_execution_time, memory_limit 等）
- 🔧 OpenClaw 配置（网关 URL, API Key, 超时设置）
- 🌐 连接测试结果
- 📋 最近的 OpenClaw 日志
- 💡 优化建议
- 按照建议优化配置
- 删除诊断文件（安全考虑）
rm /path/to/wordpress/diagnostic.php
方案 2：手动优化配置
步骤 1：增加 PHP 执行时间
编辑 php.ini：
sudo nano /etc/php/8.x/fpm/php.ini # Ubuntu/Debian
# 或
sudo nano /etc/php.ini # CentOS/RHEL
修改以下配置：
max_execution_time = 900
max_input_time = 900
memory_limit = 512M
post_max_size = 64M
upload_max_filesize = 32M
重启 PHP-FPM：
sudo systemctl restart php8.x-fpm
步骤 2：启用 WordPress 调试日志
编辑 wp-config.php：
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
查看日志：
tail -f wp-content/debug.log | grep OpenClaw
查找类似这样的日志：
[OpenClaw] Info: Increased PHP execution time from 30s to 630 (needed for 600s timeout)
[OpenClaw] AJAX generate_outline | Duration: 45.23s | Topic length: 25
步骤 3：增加 OpenClaw 网关超时
编辑 ~/.openclaw/openclaw.json：
{
"gateway": {
"http": {
"timeout": 900,
"endpoints": {
"chatCompletions": {
"enabled": true
}
}
}
}
}
重启网关：
openclaw gateway restart
步骤 4：调整 WordPress 插件设置
进入 设置 → OpenClaw AI：
- 请求超时时间：设置为
600-900秒 - 保存设置
方案 3：减少单次生成内容量
如果以上都正常但还是超时，说明是内容太长导致处理时间过长。
重要提示：
- ✅ 优化标题功能最快（输入输出都很短）
- ⚠️ 生成大纲较慢（需要 AI 思考结构）
- ❌ 生成完整文章最慢（输入大纲 + 输出长文）
- ❌ 生成摘要/SEO也较慢（需要处理大量内容）
已优化项：
- ✅ Prompt 更加详细和专业，提升生成质量
- ✅ 智能截取长内容，避免超出限制
- ✅ 明确字数要求和格式规范
- ✅ 添加角色设定，让 AI 更专注
最佳实践：
✅ 大纲生成：
- 主题简洁明确
- 控制在 4 个章节
- 每章 2-3 个要点
✅ 文章生成：
- 分段生成（每次 500-700 字）
- 先生成大纲，再逐章生成
- 不要一次性生成整篇文章
✅ 摘要/SEO：
- 自动智能截取内容（最多 1500 字）
- 保留核心信息，省略细节
❌ 避免：
- 大纲超过 6 个章节
- 单次生成超过 1000 字
- 输入超长文章内容（>5000 字）
方案 4：检查服务器资源
# 查看 CPU 使用率
top
# 查看内存使用
free -h
# 查看 OpenClaw 进程
ps aux | grep openclaw
如果资源不足：
- 升级服务器配置
- 关闭其他占用资源的进程
- 使用更快的 AI 模型
🔍 诊断关键点
浏览器开发者工具（F12）：
- Network 标签
- 找到
admin-ajax.php请求 - 查看 Timing 标签
- 确认是哪个阶段超时
- 找到
- 响应状态码
554– 网关超时504– Nginx/Apache 超时- 无响应 – 前端 JavaScript 超时
- Console 标签
- 查看
[OpenClaw]开头的日志 - 确认请求是否发送到后端
- 确认后端是否返回了结果
- 查看
💡 推荐的完整配置
WordPress (wp-config.php)
define('WP_DEBUG', true);
define('WP_DEBUG_LOG', true);
define('WP_DEBUG_DISPLAY', false);
PHP (php.ini)
max_execution_time = 900
max_input_time = 900
memory_limit = 512M
post_max_size = 64M
upload_max_filesize = 32M
OpenClaw (openclaw.json)
{
"gateway": {
"http": {
"timeout": 900,
"endpoints": {
"chatCompletions": {
"enabled": true
}
}
}
}
}
WordPress 插件设置
- 请求超时时间：
600-900秒 - 大纲章节数：
4-6个 - 单次生成字数：
500-800字
Q: 测试连接返回 error code 404
A: 检查：
- 确认「基础路径」填写正确，如果配置了
gateway.controlUi.basePath要在自定义里填写对应路径 - 云服务商防火墙是否放行对应端口
- OpenClaw 配置必须启用
chatCompletionsAPI 端点：
"gateway": {
"http": {
"endpoints": {
"chatCompletions": {
"enabled": true
}
}
}
}
- 如果返回 403
missing scope: operator.write，需要给你的 token 添加权限：
"gateway": {
"access": {
"tokens": [
{
"token": "your-token-here",
"scopes": ["operator.write"]
}
]
}
}
注意：1Panel 一键部署当前镜像 schema 校验不识别 gateway.access，需要等待官方更新镜像
Q: 测试连接返回 error code 401 或 403
A: API key 错了或者权限不足。
🏠 场景一：本地/内网部署（WordPress和OpenClaw在同一服务器或内网）
零配置方案（推荐）：
在 OpenClaw 服务器上执行：
openclaw config set gateway.auth.mode none
openclaw gateway restart
完成后 WordPress 插件立即可用，无需任何 Token 配置！
☁️ 场景二：跨服务器部署（如腾讯云OpenClaw + 阿里云WordPress）
由于涉及公网访问，出于安全考虑必须配置 Token 认证。
快速修复（2步完成）：
在【OpenClaw 服务器】上执行：
# 第1步：查看当前 token
openclaw config get gateway.auth.token
# 第2步：编辑配置文件
nano ~/.openclaw/openclaw.json
找到 "gateway" → "auth" 部分，添加 scopes 字段：
"gateway": {
"auth": {
"token": "你的token",
"scopes": ["operator.write"]
}
}
保存后执行：
openclaw gateway restart
✅ 完成后回到 WordPress 重新测试连接即可。
💡 提示：这是 OpenClaw 的安全机制，防止未授权访问你的 AI 服务。
Q: 点击按钮没反应
A: 修复了，新建文章也会加载 JS 了，现在刷新就好。
Q: 为什么没有语言选择？
A: 插件已经完全汉化，纯中文界面，不需要切换语言。
🔌 工作原理
OpenClaw WordPress 插件是一个简单的HTTP代理，工作流程如下：
用户在侧边栏输入问题
↓
Ajax 请求发送到 WordPress PHP
↓
PHP 调用 OpenClaw 网关 /v1/chat/completions API
↓
接收 AI 回复并显示在侧边栏
↓
点击"插入到编辑器" → 写入 Gutenberg 文章正文
📡 API 说明
插件使用 OpenAI 兼容的 Chat Completions API：
- 端点:
POST /v1/chat/completions - 认证:
Authorization: Bearer {token} - 协议: HTTP REST API（非WebSocket）
- Scope: ❌ 不需要
operator.writescope
重要:
/v1/chat/completions是标准的 OpenAI 兼容接口，只需要 Bearer Token 认证，不需要 WebSocket RPC 的 scope 权限。
开发
- 遵循 WordPress 编码规范
- 所有 AI 通信都通过你本地的 OpenClaw 网关
- 数据不会发给第三方服务，完全隐私
许可证
GPLv2 或更高版本，见 LICENSE 文件。
作者
陌涛
OpenClaw AI for WordPress – 将你自托管的 OpenClaw AI 网关集成到 WordPress
项目地址
https://cnb.cool/code_free/openclaw-wordpress
如果国外不能下载。可以用这个地址：openclaw-wordpress-1.4.1.tar
