乐于分享
好东西不私藏

OpenClaw WordPress插件安装配置指南,零基础也能快速上手AI创作

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 包

  1. 从 项目 Releases 下载最新版本 ZIP 包

  2. 登录 WordPress 后台 → 插件 → 安装插件 → 上传插件

  3. 选择下载好的 ZIP 文件,点击「现在安装」

  4. 安装完成点击「启用插件」


二、插件配置

  启用插件后,进入配置页面:

WordPress 后台 → 设置 → OpenClaw AI

  按表格填写配置:

配置项
说明
推荐填写
OpenClaw 网关地址
OpenClaw 网关 HTTP 访问地址
WordPress 和 OpenClaw 同服务器:http://127.0.0.1:23057
不同服务器:http://<你的服务器IP>:23057
API 密钥
网关认证 Token,在 ~/.openclaw/openclaw.json → gateway.auth.token 获取
复制你的 Token 填入
默认模型
默认 Agent/模型,必须填 openclaw/main,不能直接填模型 ID
openclaw/main
Embedding 模型
向量嵌入模型,遵循 OpenClaw 命名规则
openclaw/text-embedding-3-small
请求超时时间
API 请求超时秒数,生成完整文章建议设置 180
180
自动发布分类
自动发布文章时放入哪个分类
填入目标分类 ID,默认 1

功能开关

功能
作用
SEO 优化
在文章编辑器启用 SEO 标题/Meta 描述/关键词优化工具
自动 ALT 文本
上传图片时 AI 自动生成 SEO 友好的 ALT 描述
自动发布
每日自动 AI 创作并发布文章

保存并测试连接

  1. 填写完成点击「保存设置

  2. 滚动到页面底部点击「测试连接」按钮

  3. 显示 ✅ 连接成功 → 配置完成;❌ 提示错误 → 根据错误提示修正配置


三、开始使用 AI 创作

  配置成功后,进入文章编辑页面,右侧边栏会显示「OpenClaw AI 工具」面板。

3.1 生成文章大纲

  1. 在侧边栏「文章主题」输入框填写文章主题(也可以直接在编辑器标题栏填写文章标题)

  2. 点击「📝 生成文章大纲」按钮

  3. AI 生成结构化大纲后,选择插入格式(HTML/Markdown)

  4. 点击「插入到编辑器」 → 大纲自动添加到文章中

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 格式

  • 如果插入后看不到内容,滚动到文章最底部就能看到(古腾堡采用追加到末尾策略)


五、高级功能

自动发布文章

  1. 设置中勾选「启用定时自动发布 AI 文章」

  2. 设置每天发布数量(1-10 篇)

  3. 支持自定义话题列表,设置中一行一个话题

  4. WordPress 通过 WP-Cron 每天自动执行创作发布

  5. 手动测试:登录管理员后台访问 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 拦截或网关超时:

  1. WordPress 和 OpenClaw 同一服务器 → 网关地址使用 http://127.0.0.1:23057,不要使用公网 IP

  2. 不同服务器部署 → 确认腾讯云安全组已放行 23057 TCP 端口入站

  3. 使用 CDN(如 EdgeOne/Cloudflare) → 在 CDN/WAF 后台添加规则,放行 POST /wp-admin/admin-ajax.php 请求

  4. 网关超时 → 在插件设置中将请求超时时间从 120 改为 180 秒

Q: 点击按钮页面没反应/控制台显示 403 Forbidden

A:

  1. 新建文章需要先保存草稿才能使用,保存后再试

  2. 刷新文章编辑页面,nonce 校验过期,刷新后重新获取

  3. 如果还是 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 网关处理,数据不会发送给第三方服务

本插件专为注重隐私的开发者设计——你的文章、创作数据完全本地处理,安全可控。