OpenClaw AI for WordPress WP Registry grade A. No security issues foundWP RegistryNo security issues foundOpen the reportA

将你自托管的 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 密钥

安装方法

1. 下载 最新发行版
2. 上传到你的 WordPress 插件目录
3. 激活插件
4. 进入 设置 → OpenClaw AI
5. 按下面说明填写配置
6. 保存并测试连接
7. 在文章编辑器开始使用 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 工具」：

1. 生成大纲 - 从文章标题生成文章结构大纲，选择 HTML/Markdown 格式，生成后点击「插入到编辑器」
2. 根据大纲生成完整文章 - 大纲插入后，点击这里直接生成完整文章
3. 优化文章标题 - 根据原标题生成 5 个优化后的标题供选择，选好插入
4. 生成摘要 - 从内容自动生成文章摘要，自动填入摘要框
5. 优化 SEO - 生成 SEO 标题、描述和关键词建议

✅ 同时支持 古登堡编辑器 和 经典编辑器，插入按钮会自动识别插入。 ✅ 可以选择输出 HTML 格式（适合经典编辑器）或 Markdown 格式（适合 Markdown 编辑器）

自动 ALT 文本

只需要开启功能，之后你上传的每一张新图片都会自动由 AI 生成 ALT 文本。

自动发布文章

1. 在设置中勾选「启用定时自动发布 AI 文章」
2. 设置每天发布数量（1-10）
3. WordPress 通过 WP-Cron 每天自动执行，生成文章并发布
4. 测试方法：登录管理员后访问 你的网站/?openclaw-trigger-auto 即可手动触发一次

常见问题

Q: 测试连接返回 Invalid model. Use openclaw or openclaw/<agentId>

A: 默认模型必须填 openclaw/main，不要直接填模型ID，模型已经在 OpenClaw 配置好了。

Q: 请求超时（HTTP 554）

症状：

• 点击生成按钮后显示 "⏱️ 请求超时，可能是网络波动或内容过长"
• 提供"重试"按钮，但重试后仍然超时
• OpenClaw 网关实际上已经返回了结果，但 WordPress 显示超时

原因分析：

1. PHP 执行时间限制 - PHP 脚本执行时间超过了配置的超时时间
2. 前端 AJAX 超时 - JavaScript 等待时间不足
3. 内容过长 - 单次生成的内容太多，处理时间超过限制
4. 服务器资源不足 - CPU/内存占用过高导致响应慢

解决方案（按优先级尝试）：

方案 1：使用诊断工具（推荐）⭐

插件提供了完整的诊断工具，可以自动检查所有配置并给出优化建议。

使用步骤：

1. 上传诊断文件

   # 将 diagnostic.php 上传到 WordPress 根目录
   cp diagnostic.php /path/to/wordpress/

2. 访问诊断页面

   https://your-site.com/diagnostic.php

   （需要管理员登录）

3. 查看诊断报告

   • 📦 插件信息
   • ⚙️ PHP 配置（max_execution_time, memory_limit 等）
   • 🔧 OpenClaw 配置（网关 URL, API Key, 超时设置）
   • 🌐 连接测试结果
   • 📋 最近的 OpenClaw 日志
   • 💡 优化建议

4. 按照建议优化配置

5. 删除诊断文件（安全考虑）

   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）：

1. Network 标签

   • 找到 admin-ajax.php 请求
   • 查看 Timing 标签
   • 确认是哪个阶段超时

2. 响应状态码

   • 554 - 网关超时
   • 504 - Nginx/Apache 超时
   • 无响应 - 前端 JavaScript 超时

3. 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: 检查：

1. 确认「基础路径」填写正确，如果配置了 gateway.controlUi.basePath 要在自定义里填写对应路径
2. 云服务商防火墙是否放行对应端口
3. OpenClaw 配置必须启用 chatCompletions API 端点：

   "gateway": {
   "http": {
    "endpoints": {
      "chatCompletions": {
        "enabled": true
      }
    }
   }
   }

4. 如果返回 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.write scope

重要: /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

---

💝 赞助商

感谢以下赞助商对本项目的支持：

棉花云 - 高性能云服务器提供商

立即购买云服务器 | 🌐 访问官网

---