OpenClaw WordPress插件安装配置指南,零基础也能快速上手AI创作
用本地部署的 OpenClaw AI 网关为你的 WordPress 网站注入创作灵魂。本指南适合零基础用户,从零开始带你完成插件安装、配置和 AI 辅助创作。
环境要求
安装插件前,请确认你的环境满足:
-
WordPress 5.8+
-
PHP 7.4+
-
运行中的 OpenClaw 网关(已开启 API 访问)
-
OpenClaw API 密钥
📌 如果你还没部署 OpenClaw 网关,先参考 OpenClaw 官方文档 完成安装配置。
一、下载与安装插件
方式 1:Git 克隆安装(推荐)
cd /path/to/your-wordpress/wp-content/plugins/
git clone https://cnb.cool/code_free/openclaw-wordpress.git ./openclaw-wordpress
然后在 WordPress 后台「插件」页面启用 OpenClaw AI 插件。
方式 2:手动上传 ZIP 包
-
从 项目 Releases 下载最新版本 ZIP 包
-
登录 WordPress 后台 → 插件 → 安装插件 → 上传插件
-
选择下载好的 ZIP 文件,点击「现在安装」
-
安装完成点击「启用插件」
二、插件配置
启用插件后,进入配置页面:
WordPress 后台 → 设置 → OpenClaw AI
按表格填写配置:
|
|
|
|
|---|---|---|
| OpenClaw 网关地址 |
|
不同服务器:http://<你的服务器IP>:23057 |
| API 密钥 |
|
|
| 默认模型 |
|
openclaw/main |
| Embedding 模型 |
|
openclaw/text-embedding-3-small |
| 请求超时时间 |
|
180 |
| 自动发布分类 |
|
|
功能开关
|
|
|
|---|---|
| SEO 优化 |
|
| 自动 ALT 文本 |
|
| 自动发布 |
|
保存并测试连接
-
填写完成点击「保存设置」
-
滚动到页面底部点击「测试连接」按钮
-
显示 ✅ 连接成功 → 配置完成;❌ 提示错误 → 根据错误提示修正配置

三、开始使用 AI 创作
配置成功后,进入文章编辑页面,右侧边栏会显示「OpenClaw AI 工具」面板。
3.1 生成文章大纲
-
在侧边栏「文章主题」输入框填写文章主题(也可以直接在编辑器标题栏填写文章标题)
-
点击「📝 生成文章大纲」按钮
-
AI 生成结构化大纲后,选择插入格式(HTML/Markdown)
-
点击「插入到编辑器」 → 大纲自动添加到文章中
3.2 根据大纲生成完整文章
大纲插入编辑器后,点击「✍️ 根据大纲生成完整文章」,AI 会基于大纲扩展出 1000-1500 字完整博客文章,生成完成点击插入即可。
3.3 优化文章标题
原标题不够吸引人?点击「✨ 优化文章标题」,AI 会生成 5 个优化标题供你选择,选好插入到编辑器标题即可。
3.4 生成文章摘要
点击「📄 生成摘要」,AI 自动从文章提取生成 SEO 友好的简洁摘要,自动填入 WordPress 摘要字段。
3.5 优化 SEO
点击「🔍 优化 SEO」,AI 输出完整 SEO 优化建议:包含 SEO 标题、Meta 描述、核心关键词,直接取用即可。

四、编辑器兼容说明
插件完美兼容所有主流编辑器:
-
✅ 古腾堡编辑器(WordPress 默认区块编辑器)
-
✅ 经典编辑器(TinyMCE 可视化编辑器)
-
✅ Markdown 编辑器(纯文本模式)
-
✅ 生成结果支持 HTML / Markdown 两种插入格式
💡 使用提示:
古腾堡编辑器推荐选择 HTML 格式
Markdown 编辑器推荐选择 Markdown 格式
如果插入后看不到内容,滚动到文章最底部就能看到(古腾堡采用追加到末尾策略)
五、高级功能
自动发布文章
-
设置中勾选「启用定时自动发布 AI 文章」
-
设置每天发布数量(1-10 篇)
-
支持自定义话题列表,设置中一行一个话题
-
WordPress 通过 WP-Cron 每天自动执行创作发布
-
手动测试:登录管理员后台访问 https://你的站点/?openclaw-trigger-auto 即可手动触发一次
上传图片自动 ALT 文本
开启「自动 ALT 文本」功能后,每次上传新图片,插件自动调用 AI 生成 SEO 友好的 ALT 描述,无需手动填写。
六、常见问题 FAQ
Q: 测试连接返回 Invalid model. Use openclaw or openclaw/<agentId>
A: OpenClaw 网关要求所有模型必须遵循 openclaw/ 前缀命名规范:
-
默认模型 → 必须填写 openclaw/main
-
Embedding 模型 → 必须填写 openclaw/text-embedding-3-small
Q: 生成完整文章返回 HTTP 554 错误
A: HTTP 554 一般是防火墙/CDN 拦截或网关超时:
-
WordPress 和 OpenClaw 同一服务器 → 网关地址使用 http://127.0.0.1:23057,不要使用公网 IP
-
不同服务器部署 → 确认腾讯云安全组已放行 23057 TCP 端口入站
-
使用 CDN(如 EdgeOne/Cloudflare) → 在 CDN/WAF 后台添加规则,放行 POST /wp-admin/admin-ajax.php 请求
-
网关超时 → 在插件设置中将请求超时时间从 120 改为 180 秒
Q: 点击按钮页面没反应/控制台显示 403 Forbidden
A:
-
新建文章需要先保存草稿才能使用,保存后再试
-
刷新文章编辑页面,nonce 校验过期,刷新后重新获取
-
如果还是 403,检查当前主题/安全插件是否拦截了 admin-ajax.php 请求
Q: 插入编辑器后看不到内容
A: 古腾堡编辑器采用追加到文章末尾的插入策略,滚动到文章最底部就能看到插入的内容。
Q: 测试连接返回 No API key found 怎么办
A: OpenClaw 要求每个 agent 单独配置认证,你需要:
# 在 OpenClaw 服务器执行
openclaw agents add openclaw/text-embedding-3-small
# 按照提示完成 API Key 配置
openclaw gateway restart
配置完成重启网关即可。
七、开发支持
-
项目地址:https://cnb.cool/code_free/openclaw-wordpress
-
许可证:GPLv2 或更高版本
-
隐私保障:所有 AI 通信都通过你本地的 OpenClaw 网关处理,数据不会发送给第三方服务
本插件专为注重隐私的开发者设计——你的文章、创作数据完全本地处理,安全可控。
夜雨聆风