AI WordPress咨询配置：从接入到验证的完整步骤
给 WordPress 网站添加 AI 咨询功能，核心操作是安装一个支持自定义 API 的聊天插件，填入模型服务商提供的接口地址和密钥，再把聊天窗口嵌入到页面中。
整个过程不需要改主题代码，零基础用户按后台路径操作即可完成。
下面以通用插件配置流程为例，说明准备条件、操作步骤和验证方法。
先确认运行环境和接口权限
开始前需要准备三样东西：一个可正常访问的 WordPress 后台、一个支持 WordPress 的 AI 聊天插件、以及模型服务的 API 密钥。
如果使用云服务器自建站点，建议先确认 PHP 版本不低于 7.4，并开启 cURL 扩展，否则插件可能无法发起外部请求。
在 WordPress 后台的“工具 → 站点健康”中查看 PHP 版本和 cURL 状态。
如果 cURL 未启用，需要在宝塔面板的“软件商店 → PHP 设置 → 安装扩展”中启用 cURL，然后重启 PHP 服务。
API 密钥从模型服务商的控制台获取，通常是一串以 sk- 开头的字符。
密钥只显示一次，建议复制后保存在本地文本中。
注意不要将密钥直接写在主题文件或公开仓库里。
安装插件并填写接口参数
在 WordPress 后台进入“插件 → 安装插件”，搜索支持自定义 API 的 AI 聊天插件，例如带“AI Chatbot”或“Custom API”描述的插件。
安装并启用后，在左侧菜单找到插件设置页。
不同插件字段名称略有差异，但通常需要填写以下内容：
- API 地址：模型服务商提供的接口地址，例如
https://api.example.com/v1/chat/completions，请以服务商文档为准。 - API 密钥：粘贴准备好的密钥。
- 模型名称：填写服务商支持的模型标识，不要随意编造。
- 系统提示词：可填写“你是一个网站咨询助手，请用中文回答用户问题”等限定语。
填写完成后点击保存。
如果插件提供“测试连接”按钮，先点击测试，确认返回成功后再继续。
把咨询窗口放到页面上
插件通常提供短代码或小工具两种嵌入方式。
短代码方式更灵活，适合放在指定页面。
在插件设置页复制短代码，例如 [ai_chat]，然后进入“页面 → 新建页面”，在区块编辑器中添加“短代码”区块，粘贴短代码并发布。
如果希望全站右下角显示悬浮咨询按钮，可在“外观 → 小工具”中将插件提供的聊天小工具拖入页脚区域。
保存后前台刷新页面，检查按钮是否出现。
部分插件还支持在“设置 → 阅读”中指定咨询页面，具体以插件说明为准。
嵌入后不要立即关闭后台，先在前台做一次完整对话测试。
验证配置是否真正生效
打开前台咨询页面，输入一句简单问题，例如“你好，请介绍一下本站服务”。
观察是否出现逐字回复。
如果回复正常，说明接口地址、密钥和模型名称三项基本正确。
接着检查浏览器开发者工具的“网络”面板，筛选 chat 或 completions 请求，确认状态码为 200。
如果状态码为 401，通常是密钥错误或未生效；
如果为 404，检查 API 地址是否缺少路径；
如果为 429，说明请求频率或额度受限，需要查看服务商账户余额和限流规则。
最后用手机浏览器访问同一页面，确认移动端聊天窗口可以正常展开和输入。
容易踩坑的几个地方
密钥泄露是最常见的问题。
不要把密钥写进前端 JavaScript 或公开的代码片段，插件设置页保存后应确认前台源代码中不出现完整密钥。
缓存插件可能导致短代码不生效。
如果页面显示的是短代码文本而不是聊天窗口，先到缓存插件中清除页面缓存，再刷新前台。
部分安全插件会拦截外部 API 请求。
如果测试连接一直超时，可临时停用安全插件再试，确认原因后把 API 域名加入白名单，而不是长期关闭安全插件。
模型回复内容不可控，建议在系统提示词中限定回答范围，并避免让 AI 直接处理订单、支付或账号密码类信息。
常见疑问
必须安装付费插件吗？ 不一定。
WordPress 插件目录中有免费插件支持自定义 API，但功能完整度和更新频率差异较大，选择前查看最近更新时间和兼容的 WordPress 版本。
配置后前台没有反应怎么办？ 先看插件设置页的测试连接是否成功，再检查浏览器控制台是否有报错。
如果控制台显示跨域错误，通常是 API 地址填写不完整或服务商不允许浏览器直连，需要按插件文档调整代理设置。
AI 咨询窗口会影响网站速度吗？ 聊天窗口本身加载的脚本通常较小，但首次加载模型回复时会有网络延迟。
建议只在咨询页面加载插件脚本，不要在全部页面强制加载。
完成以上配置后，建议保留一份插件设置截图和 API 密钥的加密记录。
后续更换模型或调整提示词时，先在小范围页面测试，确认回复正常后再全站启用。
