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

OpenClaw WordPress 插件安装配置指南

用本地部署的 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

　　按表格填写配置：

功能开关

保存并测试连接

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 网关处理，数据不会发送给第三方服务

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