用本地部署的 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 包
- 从 项目CNB Releases 下载最新版本 ZIP 包 从项目Github Releases 下载最新版本 ZIP 包
- 登录 WordPress 后台 → 插件 → 安装插件 → 上传插件
- 选择下载好的 ZIP 文件，点击「现在安装」
- 安装完成点击「启用插件」
二、插件配置
启用插件后，进入配置页面：
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 创作并发布文章 |
保存并测试连接
- 填写完成点击「保存设置」
- 滚动到页面底部点击「测试连接」按钮
- 显示 ✅ 连接成功 → 配置完成；❌ 提示错误 → 根据错误提示修正配置
三、开始使用 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
配置完成重启网关即可。
七、开发支持
- 项目地址（CNB.COOL）：https://cnb.cool/code_free/openclaw-wordpress
- 项目地址（Github）：https://github.com/motao123/openclaw-wordpress
- 许可证：GPLv2 或更高版本
- 隐私保障：所有 AI 通信都通过你本地的 OpenClaw 网关处理，数据不会发送给第三方服务
本插件专为注重隐私的开发者设计——你的文章、创作数据完全本地处理，安全可控。
原创文章，作者：陌涛，如若转载，请注明出处：https://imotao.com/9218.html
微信扫一扫 
