Title: Rapls AI Chatbot – Self-Hosted RAG & MCP Server
Author: rapls
Published: Март 28, 2026-ж.
Last modified: Сентябрь 4, 2026-ж.
---
Плагиндерди издөө
# Rapls AI Chatbot – Self-Hosted RAG & MCP Server
Автору [rapls](https://profiles.wordpress.org/rapls/)
[Жүктөө](https://downloads.wordpress.org/plugin/rapls-ai-chatbot.1.19.2.zip)
* [Кенен маалымат](https://ky.wordpress.org/plugins/rapls-ai-chatbot/#description)
* [Сын-пикирлер](https://ky.wordpress.org/plugins/rapls-ai-chatbot/#reviews)
* [Орнотуу](https://ky.wordpress.org/plugins/rapls-ai-chatbot/#installation)
* [Development](https://ky.wordpress.org/plugins/rapls-ai-chatbot/#developers)
[Колдоо](https://wordpress.org/support/plugin/rapls-ai-chatbot/)
## Сүрөттөө
**Add an AI chatbot that answers visitors from _your own_ content — and admits when
it doesn’t know.** Rapls AI Chatbot searches your posts, pages, and knowledge base
first, then replies in natural language, in the visitor’s own language. With Grounded
Answers Only mode, if your content has no answer, the bot says so instead of making
something up.
**You can be live in about five minutes, for free, with no credit card.** On first
setup a guided “Start for free” panel hands you a free key from OpenRouter or the
Google Gemini free tier, tests it, auto-selects a working model, and switches the
chatbot on — no AI or API experience needed.
**Watch the setup, start to finish:**
**No monthly SaaS fee — and no runaway bill.** It runs on your own API key with
no markup, and built-in Usage Control caps daily usage per visitor, so you can open
the bot to the public without worrying about your API spend. A Monthly Cost Guard
lets you set a hard budget, and Model Fallback keeps the bot answering on a lightweight
model when your main model hits its quota. Conversations and keys stay on your own
server.
Built for site owners, agencies, and developers who want control over the model,
the data, and the cost. Connect OpenAI, Anthropic Claude, Google Gemini, or OpenRouter,
or any OpenAI-compatible endpoint such as Alibaba Tongyi Qwen (DashScope) — useful
where OpenAI and Gemini are hard to reach — and switch anytime.
#### Why site owners pick Rapls
* **Free to try, fast to launch.** Guided onboarding gets you from install to a
working chatbot in minutes, with a no-credit-card OpenRouter or Gemini key.
* **Grounded answers, or an honest “I don’t know.”** RAG hybrid search grounds
replies in your actual posts, pages, and knowledge base — and Grounded Answers
Only mode keeps the bot from inventing answers your site doesn’t contain.
* **Your bill can’t run away.** Self-hosted and BYOK with no markup, plus per-visitor
daily caps (Usage Control) so public traffic can’t drain your API budget.
* **Replies that don’t sound like a robot.** An optional AI-smell score reviews
the bot’s Japanese replies for machine-sounding wording, so you can tune the
tone. (Detection only — replies are never altered.)
* **No lock-in.** Switch between OpenAI, Claude, Gemini, and OpenRouter whenever
you want.
* **Speaks your visitors’ language.** Automatic multi-language replies, so one
bot serves an international audience.
#### What it does
* Bring your own key: OpenAI, Anthropic Claude, Google Gemini, OpenRouter, or any
OpenAI-compatible endpoint (Alibaba Qwen/DashScope, DeepSeek, Zhipu), switchable
per site.
* Site learning: indexes your posts and pages so the bot answers from your content.
* Knowledge base: add Q&A or upload TXT/MD/PDF/DOCX files (large documents are
split into parts automatically so they embed reliably), with priority over general
answers.
* RAG hybrid search: combines keyword and semantic retrieval for grounded replies.
* Grounded Answers Only: an optional mode that makes the bot reply “I couldn’t
find that” instead of inventing an answer your content doesn’t support.
* Web search: lets the bot pull current information when configured.
* MCP tools: exposes 5 Model Context Protocol tools, so agents such as Claude or
ChatGPT can read and act on your site through conversation.
* Usage dashboard: tracks conversations, messages, and API cost.
* Usage Control: optional per-visitor daily caps so public traffic can’t run up
your API bill.
* Unanswered Questions: records what the bot could not answer, with one-click “
Add to knowledge” and an AI-drafted FAQ page.
* AI-smell score: an optional read-only score that flags machine-sounding wording
in Japanese replies (detection only — replies are never altered).
* Industry starter templates: one click applies a ready-made system prompt and
preset questions for hotels, shops, clinics, professional services, or company
sites.
* Gutenberg block: drop the chatbot into any page or post.
* Deep-link auto-send: a `?raplsaich_q=` URL opens the chatbot and sends the question
automatically, so end-of-article “suggested questions” become one-click conversations.
#### Turns visitor questions into content
The bot doesn’t just answer — it tells you what your site is missing. Questions
it could not answer from your content are recorded on the dashboard, one click turns
them into a knowledge entry, and another click drafts an FAQ page from the last
30 days of real visitor questions. Answer gaps become content, content improves
the bot, and the same pages work for SEO and AI search (LLMO).
#### Self-hosted and private
Conversations and keys stay on your own WordPress install. You are billed by your
AI provider directly, so cost is transparent and there is no markup. Visitors can
delete their own chat history from the widget (optional), and retention is configurable—
GDPR-friendly by design.
#### Free and Pro
**Free — not a trial.** The free version is the full product: chatbot, site learning,
knowledge base, RAG hybrid search, Grounded Answers Only, MCP server (5 tools),
a usage dashboard (conversations, messages, and cost), and per-visitor daily caps.
Run it forever at no cost on a free-tier key.
**Pro — for sites that run the bot as a business tool:**
* **Lead capture automation** — collect contacts from conversations, with Google
Sheets and Slack sync.
* **Analytics** — conversation, cost, and quality metrics at a glance.
* **Usage Control suite** — role-based limits, per-user monthly credits with auto-
reset, and a usage-control dashboard to grant and track credits, so members and
guests each get a fair share of your API budget.
* **Extra MCP tools** — product-search and analytics tools for AI agents, on top
of the five in Free.
* **Context & embedding controls** — reprocess embeddings and shape the context
retrieved for each reply.
* **LINE integration (add-on)** — connect the chatbot to LINE messaging, the dominant
messenger in Japan.
#### Up and running in about 5 minutes (free, no credit card)
You do not need an API key or any AI experience to start. On first setup the plugin
shows a “Start for free” panel with two no-credit-card paths: an OpenRouter free
key or a Google Gemini free-tier key.
1. Pick OpenRouter or Gemini.
2. Click through to get a free key (about a minute) and paste it in.
3. Press Test Connection — the key is validated and saved, a working free model is
auto-selected, and the chatbot is switched on.
That’s it. Each option states its data-handling trade-off up front (the Gemini free
tier may use submitted content to improve Google’s models), so you choose with eyes
open. You can switch to your own OpenAI, Claude, or Gemini key at any time.
Learn more: [Plugin details](https://raplsworks.com/plugins/rapls-ai-chatbot/) |
[Source code (GitHub)](https://github.com/rapls/rapls-ai-chatbot)
#### See it in action
Watch the full setup — from install to first reply — in about 5 minutes, no credit
card required:
See it answer from your own content, and how that differs from plain ChatGPT:
### External Services
This plugin connects to the following external third-party services. **No data is
sent to any service until you configure an API key and enable the feature in the
plugin settings.** Each service requires the site administrator to create an account
and obtain API credentials. By using these services, you agree to their respective
terms and privacy policies listed below.
#### 1. OpenAI (GPT models): AI Provider
Used when you select OpenAI as your AI provider. User messages and optionally site
content are sent to generate AI responses.
* Service URL: [https://api.openai.com/](https://api.openai.com/)
* Terms of Use: [https://openai.com/terms/](https://openai.com/terms/)
* Privacy Policy: [https://openai.com/privacy/](https://openai.com/privacy/)
#### 2. Anthropic (Claude models): AI Provider
Used when you select Anthropic Claude as your AI provider. User messages and optionally
site content are sent to generate AI responses.
* Service URL: [https://api.anthropic.com/](https://api.anthropic.com/)
* Terms of Use: [https://www.anthropic.com/terms](https://www.anthropic.com/terms)
* Privacy Policy: [https://www.anthropic.com/privacy](https://www.anthropic.com/privacy)
#### 3. Google (Gemini models): AI Provider
Used when you select Google Gemini as your AI provider. User messages and optionally
site content are sent to generate AI responses.
* Service URL: [https://generativelanguage.googleapis.com/](https://generativelanguage.googleapis.com/)
* Terms of Use: [https://policies.google.com/terms](https://policies.google.com/terms)
* Privacy Policy: [https://policies.google.com/privacy](https://policies.google.com/privacy)
#### 4. OpenRouter: AI Provider
Used when you select OpenRouter as your AI provider. OpenRouter is a unified API
gateway that routes requests to various AI models.
* Service URL: [https://openrouter.ai/api/](https://openrouter.ai/api/)
* Terms of Use: [https://openrouter.ai/terms](https://openrouter.ai/terms)
* Privacy Policy: [https://openrouter.ai/privacy](https://openrouter.ai/privacy)
#### 5. OpenAI-compatible endpoints (e.g. Alibaba Qwen/DashScope, DeepSeek, Zhipu): AI Provider
Used only if you select the “OpenAI-compatible” provider and enter a base URL. User
messages, and optionally your site content (including indexed content for RAG embeddings),
are sent to the endpoint you configure to generate responses or embeddings. Because
the endpoint is chosen by you, please review the terms and privacy policy of the
specific provider you connect to. For example, Alibaba Cloud Model Studio (DashScope),
which powers Tongyi Qwen:
* Service URL: [https://www.alibabacloud.com/help/en/model-studio/](https://www.alibabacloud.com/help/en/model-studio/)
* Terms of Use: [https://www.alibabacloud.com/help/en/legal/](https://www.alibabacloud.com/help/en/legal/)
* Privacy Policy: [https://www.alibabacloud.com/help/en/legal/latest/alibaba-cloud-privacy-policy/](https://www.alibabacloud.com/help/en/legal/latest/alibaba-cloud-privacy-policy/)
#### 6. Google reCAPTCHA v3 (Optional)
Used only if you enable reCAPTCHA in the plugin settings for spam protection. The
visitor’s IP address and interaction data are sent to Google for verification.
* Service URL: [https://www.google.com/recaptcha/](https://www.google.com/recaptcha/)
* Terms of Use: [https://policies.google.com/terms](https://policies.google.com/terms)
* Privacy Policy: [https://policies.google.com/privacy](https://policies.google.com/privacy)
#### 7. LINE Messaging API (Pro Add-on, Optional)
Used only if you enable the LINE integration via the Pro add-on. Connects to the
LINE Messaging API for chatbot-to-LINE messaging.
* Service URL: [https://api.line.me/](https://api.line.me/)
* Terms of Use: [https://terms.line.me/](https://terms.line.me/)
* Privacy Policy: [https://line.me/en/terms/policy/](https://line.me/en/terms/policy/)
#### Cross-Site Embed
The plugin includes an optional embed loader script (`embed-loader.js`) for embedding
the chatbot on external websites via an iframe. This script does not load any external
CDN resources or third-party scripts. It creates an iframe pointing back to your
own WordPress site, and all data processing occurs on your server.
#### Data Transmitted to External Services
* **User messages**: Chat messages entered by visitors (sent to the configured
AI provider only)
* **Site content** (if Site Learning is enabled): Excerpts from your published
posts/pages (sent to the configured AI provider)
* **Knowledge base** (if configured): Custom Q&A entries you create (sent to the
configured AI provider)
* **IP address** (reCAPTCHA only): Sent to Google for spam verification
#### Data Storage
* **Conversation history**: Stored locally in your WordPress database (can be disabled)
* **Visitor IP**: Stored as SHA-256 hash (not plain text) for rate limiting
* **Retention**: Configurable auto-deletion period (default 90 days)
#### User Controls
You can disable these features in the plugin settings:
* Conversation history saving*
Site content crawling/learning * Google reCAPTCHA verification * Web search
## Скриншоттор
[⌊Chat widget — the front-end chatbot answering a visitor from your site content.⌉⌊
Chat widget — the front-end chatbot answering a visitor from your site content.⌉[
Chat widget — the front-end chatbot answering a visitor from your site content.
[⌊Start for free — the onboarding panel connects a no-credit-card OpenRouter or
Google Gemini free key in about a minute, with each option's data-handling trade-
off shown up front.⌉⌊Start for free — the onboarding panel connects a no-credit-
card OpenRouter or Google Gemini free key in about a minute, with each option's
data-handling trade-off shown up front.⌉[
Start for free — the onboarding panel connects a no-credit-card OpenRouter or Google
Gemini free key in about a minute, with each option’s data-handling trade-off shown
up front.
[⌊Dashboard — setup checklist, conversation/index/knowledge stats, System Health
panel (API key, cron, REST reachability), and 30-day token usage with an estimated
cost.⌉⌊Dashboard — setup checklist, conversation/index/knowledge stats, System Health
panel (API key, cron, REST reachability), and 30-day token usage with an estimated
cost.⌉[
Dashboard — setup checklist, conversation/index/knowledge stats, System Health panel(
API key, cron, REST reachability), and 30-day token usage with an estimated cost.
[⌊Knowledge base — add custom text/Q&A or import TXT, CSV, MD, PDF, or DOCX files.⌉⌊
Knowledge base — add custom text/Q&A or import TXT, CSV, MD, PDF, or DOCX files.⌉[
Knowledge base — add custom text/Q&A or import TXT, CSV, MD, PDF, or DOCX files.
[⌊Conversations — review, filter, archive, and export visitor conversations with
lead and status details.⌉⌊Conversations — review, filter, archive, and export visitor
conversations with lead and status details.⌉[
Conversations — review, filter, archive, and export visitor conversations with lead
and status details.
[⌊Analytics — conversation, message, cost, and quality metrics (Pro).⌉⌊Analytics—
conversation, message, cost, and quality metrics (Pro).⌉[
Analytics — conversation, message, cost, and quality metrics (Pro).
[⌊Site Learning — auto-crawl posts, pages, and custom post types so the bot answers
from your own content.⌉⌊Site Learning — auto-crawl posts, pages, and custom post
types so the bot answers from your own content.⌉[
Site Learning — auto-crawl posts, pages, and custom post types so the bot answers
from your own content.
[⌊AI Settings — choose your provider (OpenAI, Anthropic Claude, Google Gemini, or
OpenRouter), enter your API key, pick a model, and enable Vector Embedding (RAG).⌉⌊
AI Settings — choose your provider (OpenAI, Anthropic Claude, Google Gemini, or
OpenRouter), enter your API key, pick a model, and enable Vector Embedding (RAG)
.⌉[
AI Settings — choose your provider (OpenAI, Anthropic Claude, Google Gemini, or
OpenRouter), enter your API key, pick a model, and enable Vector Embedding (RAG).
[⌊Unanswered Questions — questions the bot could not answer from your content, with
one-click "Add to knowledge" and an AI-generated FAQ draft you can save as a draft
page.⌉⌊Unanswered Questions — questions the bot could not answer from your content,
with one-click "Add to knowledge" and an AI-generated FAQ draft you can save as
a draft page.⌉[
Unanswered Questions — questions the bot could not answer from your content, with
one-click “Add to knowledge” and an AI-generated FAQ draft you can save as a draft
page.
[⌊Cost controls — Monthly Cost Guard with budget warnings, per-visitor usage limits,
and model fallback so API bills never run away.⌉⌊Cost controls — Monthly Cost Guard
with budget warnings, per-visitor usage limits, and model fallback so API bills
never run away.⌉[
Cost controls — Monthly Cost Guard with budget warnings, per-visitor usage limits,
and model fallback so API bills never run away.
## Блоктор
This plugin provides 1 block.
* AI Chatbot Embed an AI chatbot inline on your page.
## Орнотуу
1. Upload `rapls-ai-chatbot` folder to `/wp-content/plugins/`
2. Activate via Plugins menu
3. Go to AI Chatbot > Settings
4. Follow the onboarding panel to start free with an OpenRouter or Google Gemini key,
or paste your own OpenAI / Claude / Gemini key.
5. Enable site learning or create knowledge base entries
6. Insert Gutenberg block or enable sitewide display
#### Getting Started
1. **API Key**: get a free OpenRouter or Google Gemini key from the onboarding panel,
or your own key from [console.anthropic.com](https://console.anthropic.com), OpenAI,
or Google AI Studio.
2. **Enable RAG**: add site learning (auto-crawl) or create knowledge base entries.
3. **Customize**: set bot name, avatar, welcome message, system prompt.
4. **Deploy**: insert the Gutenberg block, paste the shortcode, or enable sitewide
display.
👉 **Plugin details:** [Rapls AI Chatbot](https://raplsworks.com/plugins/rapls-ai-chatbot/)
## FAQ.KG
### Can I use it for free?
Yes — the plugin is free, and the onboarding panel connects a no-credit-card OpenRouter
or Google Gemini free-tier key in about a minute. Free tiers have rate limits, so
for production traffic you may want your own provider key.
### Do I need an API key?
Yes. Rapls runs on your own API key so your data and cost stay under your control.
If you do not have one, the plugin guides you to a free OpenRouter key or a free
Google Gemini key on first setup — both need no credit card.
### Will the bot make things up?
Not if you don’t want it to. Turn on Grounded Answers Only and the bot replies “
I couldn’t find that on this site” whenever your content has no relevant answer,
instead of answering from the model’s general knowledge.
### Can visitors run up my API bill?
No. Usage Control caps daily usage per guest and per logged-in user on the server
side, separate from rate limiting. Pro adds role-based limits and per-user credits.
### Does it work with AI agents (MCP)?
Yes. The free version ships an MCP (Model Context Protocol) server with 5 tools,
so AI agents such as Claude or ChatGPT can search your posts, read knowledge entries,
and act on your site through conversation. Pro adds product-search and analytics
tools on top.
### Is my data private on the free options?
It depends on the provider you choose, and the plugin tells you before you pick.
OpenRouter free models are served by various upstream providers, each with its own
data-handling policy. The Google Gemini free tier may use your submitted content
to improve Google’s models — if you do not want that, use a paid Gemini tier or
another provider. Either way, your conversations and keys are stored on your own
WordPress install, not on Rapls servers.
### My Gemini key starts with “AQ.” instead of “AIza” — is that OK?
Yes. Google is moving Gemini API keys from the legacy “AIza” standard format to
the new “AQ.” auth format, and Google AI Studio now issues “AQ.” keys by default.
Rapls works with both. Google is retiring the standard format (unrestricted “AIza”
keys are rejected from 2026-06-19, and all “AIza” keys from 2026-09), so if you
still have an “AIza” key the plugin shows a notice with how to migrate. New keys
created today are already “AQ.” keys and need no action.
### Can I use multiple AI providers?
Yes. Configure multiple providers in Settings and switch between them. WordPress
7.0 Connectors API also supports unified key management.
### Does it crawl my entire site automatically?
Yes. Enable “Site Learning” in Settings to crawl published content (posts, pages,
custom post types, WooCommerce products). Configure crawl scope and frequency.
### Can I embed on external sites?
Yes. Configure cross-site embed in Display Settings. Use iframe or script loader.
### How do I set up WordPress 7.0 Connectors API?
In Settings > AI Settings, Connectors UI appears if WP 7.0 is active. Register your
Claude API key once; all Connectors-compatible plugins access it.
### Is there conversation history?
Yes. Data Management tab lets you save/review all conversations. Configure retention
period (30/90/365 days or indefinite).
### Troubleshooting: chat not appearing?
* Verify API key is valid (test in Settings)
* Check Gutenberg block or Display Settings (enable sitewide)
* Review Security Diagnostics for rate limit, IP detection, or consent issues
### More questions?
See [Plugin details](https://raplsworks.com/plugins/rapls-ai-chatbot/) or [WordPress.org Support](https://wordpress.org/support/plugin/rapls-ai-chatbot/)
## Сын-пикирлер
### [実運用でも問題なく、使いやすいプラグイン](https://wordpress.org/support/topic/%e5%ae%9f%e9%81%8b%e7%94%a8%e3%81%a7%e3%82%82%e5%95%8f%e9%a1%8c%e3%81%aa%e3%81%8f%e3%80%81%e4%bd%bf%e3%81%84%e3%82%84%e3%81%99%e3%81%84%e3%83%97%e3%83%a9%e3%82%b0%e3%82%a4%e3%83%b3/)
[houwamaekawa](https://profiles.wordpress.org/houwamaekawa/) Август 13, 2026-ж.
12 replies
導入してしばらく経ちますが、今のところサイト訪問者（お客様）からの苦情等はなく、
問題なくスムーズに稼働しています。万が一AIの回答が間違っていた場合でも、後から「
ナレッジ設定」を追加することで次回以降の回答を修正できるため、実運用上も不都合を
感じていません。手軽に導入できてしっかりと管理ができる、実用的な良いプラグインだ
と思います。
### [初心者でも使いやすい](https://wordpress.org/support/topic/%e5%88%9d%e5%bf%83%e8%80%85%e3%81%a7%e3%82%82%e4%bd%bf%e3%81%84%e3%82%84%e3%81%99%e3%81%84-2/)
[prion5000](https://profiles.wordpress.org/prion5000/) Август 9, 2026-ж.
設定が楽
### [無料で使えて、日本語対応の安心感。](https://wordpress.org/support/topic/%e7%84%a1%e6%96%99%e3%81%a7%e4%bd%bf%e3%81%88%e3%81%a6%e3%80%81%e6%97%a5%e6%9c%ac%e8%aa%9e%e5%af%be%e5%bf%9c%e3%81%ae%e5%ae%89%e5%bf%83%e6%84%9f%e3%80%82/)
[nonohino](https://profiles.wordpress.org/nonohino/) Август 6, 2026-ж.
自社サイトにチャットボットが欲しいと考えていました。有料版にする前に無料版で使い勝手
を試せるのが良い。もちろん無料で使い続けることもできるので、しばらくチャットボット
を育ててみます。日本語で分かりやすい説明と動画があるのも安心でした。
### [Everything you’ll ever need for an AI chatbot](https://wordpress.org/support/topic/everything-youll-ever-need-for-an-ai-chatbot/)
[audioacademy](https://profiles.wordpress.org/audioacademy/) Июль 17, 2026-ж. 1
reply
It was actually m ChatGTP who recommended me using Rapls and also helped me to set
it up. The plugin is very impressive and functional. The cost/benefit are great,
as a one time payment will take you a long way. Everything works as expected and
is surprisingly easy to set up. Highly recommended.
### [ホームページに楽にチャットボットを設置！](https://wordpress.org/support/topic/%e3%83%9b%e3%83%bc%e3%83%a0%e3%83%9a%e3%83%bc%e3%82%b8%e3%81%ab%e6%a5%bd%e3%81%ab%e3%83%81%e3%83%a3%e3%83%83%e3%83%88%e3%83%9c%e3%83%83%e3%83%88%e3%82%92%e8%a8%ad%e7%bd%ae%ef%bc%81/)
[okihifuka](https://profiles.wordpress.org/okihifuka/) Июль 12, 2026-ж. 1 reply
当方の扱っている店舗のHPに比較的楽にチャットボットを設置できました。月々の有料サービス
があるなかで、初期費用のみ安価で出来るのがすばらしいです。サイト学習も入れるとHP
の内容を反映してくれます。
### [機能が充実しており、かゆいところに手が届く](https://wordpress.org/support/topic/%e6%a9%9f%e8%83%bd%e3%81%8c%e5%85%85%e5%ae%9f%e3%81%97%e3%81%a6%e3%81%8a%e3%82%8a%e3%80%81%e3%81%8b%e3%82%86%e3%81%84%e3%81%a8%e3%81%93%e3%82%8d%e3%81%ab%e6%89%8b%e3%81%8c%e5%b1%8a%e3%81%8f/)
[wp2you](https://profiles.wordpress.org/wp2you/) Апрель 29, 2026-ж.
無料版でも応答回数による制限などもなく、Gemini APIの無料枠でも動くため、ランニング
コストがかからない。開発者が日本の方ということもあり、私には分かりやすく機能も充実
しており、かゆいところに手が届く感じがある。 無料版でもナレッジ登録ができるため、
FAQを学習させることで基本的な質問対応は可能ですが、Pro版のサイト学習と自動学習は
とても便利。会話ログから利用者の潜在ニーズを拾ってWebサイトのコンテンツを充実させ
たり、FAQを充実させることでSEOやLLMOにも効果的で、コンテンツが充実すればその分、
チャットの精度も上がるという良い循環ができる。 他にも便利なツールがたくさんあるので、
試していきたい。
[ Read all 7 reviews ](https://wordpress.org/support/plugin/rapls-ai-chatbot/reviews/)
## Contributors & Developers
“Rapls AI Chatbot – Self-Hosted RAG & MCP Server” is open source software. The following
people have contributed to this plugin.
Мүчөлөрү
* [ rapls ](https://profiles.wordpress.org/rapls/)
“Rapls AI Chatbot – Self-Hosted RAG & MCP Server” has been translated into 1 locale.
Thank you to [the translators](https://translate.wordpress.org/projects/wp-plugins/rapls-ai-chatbot/contributors)
for their contributions.
[Translate “Rapls AI Chatbot – Self-Hosted RAG & MCP Server” into your language.](https://translate.wordpress.org/projects/wp-plugins/rapls-ai-chatbot)
### Interested in development?
[Browse the code](https://plugins.trac.wordpress.org/browser/rapls-ai-chatbot/),
check out the [SVN repository](https://plugins.svn.wordpress.org/rapls-ai-chatbot/),
or subscribe to the [development log](https://plugins.trac.wordpress.org/log/rapls-ai-chatbot/)
by [RSS](https://plugins.trac.wordpress.org/log/rapls-ai-chatbot/?limit=100&mode=stop_on_copy&format=rss).
## Өзгөртүүлөр
#### 1.19.2
* Fixed: In the cross-site script embed, the close (×) button did nothing on other
domains, so visitors could not close the chat. The chat window notified the host
page to close via a browser message addressed to the wrong origin (this plugin’s
own site instead of the page it was embedded on), so the browser dropped it.
The embed now sends the message to the host page’s own origin, and the close
button works on any site. Embedding the chat on its own site was unaffected.
#### 1.19.1
* Fixed: In the cross-site script embed, the Google reCAPTCHA v3 badge (shown when
reCAPTCHA is enabled) could sit on top of the send button. Google pins the badge
to the bottom-right corner, and the embedded chat window is narrow, so the badge
landed right where the send button is. The badge is now lifted above the input
bar so it no longer covers the send button. No change if you do not use reCAPTCHA.
#### 1.19.0
* Added: Large uploaded documents are now split into parts automatically. Until
now a document had to fit the embedding model’s single-request token limit or
it would not embed; now the Knowledge Base splits a big TXT, MD, PDF, or DOCX
into smaller parts on upload, and each part embeds on its own. You no longer
need to cut a file up by hand before uploading. The Knowledge Base list shows
the document as one item with a “parts embedded” badge, and deleting it removes
every part. This also improves answers: the bot retrieves the most relevant passage
of a long document instead of one blurred embedding of the whole thing. Existing
entries are untouched — re-upload a document to split it.
#### 1.18.1
* Fixed: The bot avatar beside a message could occasionally render at full size(
very large) on sites where a caching or CSS-optimization plugin combined and
minified stylesheets. The avatar wrapper is now sized directly, so the icon stays
at its intended size even if that one rule is dropped. If you see it oversized
after updating, clear your caching plugin’s cache once.
#### 1.18.0
* **Fixed: embedding could loop indefinitely, sending requests to your provider
without end.** The client kept asking for more as long as documents remained
unembedded, so a single document that could never embed — one over the model’s
token limit, or a PDF with no extractable text — put the loop in a state it could
not leave. On a metered API key that meant requests, and charges, with nothing
to show for them. Permanent failures are now excluded from the next pass and
the loop ends when it stops making progress. If you have uploaded a large document
and left the Knowledge Base screen open, update.
* Fixed: Knowledge Base entries that failed to embed used to index silently — you
saw 0 chunks with no reason. Each entry that cannot be embedded now shows why
on the Knowledge Base list (for example, “Too large to embed — split this entry
into smaller documents”, or an API-key/rate-limit note). Thanks to @publiastel
for the clear report.
* Improved: When you embed several documents at once and one is too large for the
embedding model’s single-request limit, the oversized document no longer sinks
the whole batch. The rest embed normally, and only the oversized one is flagged.
Split it into smaller entries and it will embed on the next run.
#### 1.17.0
* Added: Optional HTML in the “Limit reached” message (Security, Usage Control).
Turn on “Allow a safe HTML subset” to use links and basic emphasis in that message—
for example, point a blocked visitor to a login or upgrade page: Please [log in](https://ky.wordpress.org/login?output_format=md)
or go [VIP](https://ky.wordpress.org/vip?output_format=md). Only a small allowlist
is permitted (,
, **, _); everything else is stripped on save, and the widget
scrubs the message again before rendering. Off by default, so existing setups
are unchanged._**
#### 1.16.2
* Added: Badge label. You can now show a short line of text next to the launcher
icon — for example “Contact us here” — so first-time visitors understand what
the button does instead of seeing an icon alone. Set it under Settings, Badge
Label; leave it empty to keep the icon-only circle. The label is hidden on phones
to save space.
#### 1.16.1
* Fixed: With the OpenAI-compatible provider selected (e.g. Alibaba Qwen/DashScope),
the chat widget returned “AI API key is not configured” even though the key was
saved and Test Connection succeeded. The pre-send key check did not recognize
the new provider and looked for an OpenAI key instead of the OpenAI-compatible
one. Chat now reads the correct key. No settings changes are needed.
#### 1.16.0
* Added: OpenAI-compatible provider. Connect any service that speaks the OpenAI
Chat Completions API — including Chinese providers such as Alibaba Tongyi Qwen(
DashScope), DeepSeek, and Zhipu GLM — by entering a base URL, a model name, and
an API key. Vector embeddings (RAG) are supported as well, so sites that cannot
reach OpenAI or Gemini (for example inside mainland China) can run both chat
and RAG on a domestic provider such as Qwen. When the embedding provider is set
to Auto and chat runs on the OpenAI-compatible provider, embeddings use that
same vendor. Changing the embedding provider now warns you to clear and regenerate
embeddings.
* Added: Deep-link auto-send. A URL such as `?raplsaich_q=your+question` (a plain`?
q=` also works) opens the chatbot and sends that question automatically, with
no typing or copy-paste — ideal for turning end-of-article “suggested questions”
into one-click conversations. The question is shown as a normal visitor message,
and the parameter is removed from the URL after sending so a refresh does not
resend it.
#### 1.15.4
* Fixed: the plugin header still read 1.15.2 while every other file said 1.15.3,
so an installed 1.15.3 reported itself as 1.15.2 and WordPress kept offering
the same update over and over. The header is the version WordPress compares,
and it is now correct. The release check now compares all three places a version
is written, so this cannot recur.
* Display name shortened to “Rapls AI Chatbot – Self-Hosted RAG & MCP Server”.
The previous title ran to 92 characters, said “Chatbot” twice and listed four
AI vendors — past the 80 the directory allows and into what the guidelines call
readme spam. The vendor names have moved to the description, where they are still
indexed.
* The description in the plugin header no longer differs from the one in this readme;
the Plugins screen and the directory now say the same thing.
#### 1.15.3
* Fixed: On some themes a “Choose file / No file selected” upload control could
appear at the bottom of the public chat widget. That control is a hidden image-
upload input used only by the Pro add-on; it was kept out of sight by the HTML`
hidden` attribute alone, which a theme’s own CSS could override. It is now hidden
with an explicit rule, matching the neighboring buttons, so it stays out of the
visitor-facing chat regardless of theme.
#### 1.15.2
* Fixed: With the Pro add-on active, a JavaScript error (“raplsaichLsGet is not
defined”) could appear as a chat message right after the bot replied. The consent-
gated storage helpers live inside the free plugin’s script scope and were not
reachable from the Pro script; they are now shared through the public `RaplsaichChatbot`
object. Affected Pro features included chat bookmarks, lead forms, offline messages,
and conversion tracking.
* Fixed: An error thrown by a Pro extension hook is no longer rendered as a bot
message in the conversation. Hooks now run in isolation and failures are logged
to the browser console instead.
#### 1.15.1
* Changed: The Gemini fallback model (used by Model Fallback when the selected
model hits its quota) is now `gemini-2.5-flash-lite` instead of the older `gemini-
2.0-flash-lite`, so fallback stays on a current model generation. Override with
the `raplsaich_fallback_model` filter.
#### 1.15.0
* Added: Provider error visibility for admins — failed AI calls are classified (
rate limit, timeout, authentication, quota/billing, server, unknown) and recorded
with type, time, provider, model, and HTTP status only. The response body and
API keys are never stored.
* Added: In the admin conversation view, the message that triggered a failed AI
call now carries an error badge; hovering shows the time, provider, model, and
HTTP status.
* Added: System Health now includes an “AI provider errors (24h)” row — counts
by type plus the last occurrence and the model in use, so recurring provider
problems surface without waiting for visitor reports.
* Added: When rate-limit errors occur while a Gemini 3 preview model is selected,
System Health shows a dismissible suggestion to switch to a stable model (such
as Gemini 2.5 Flash) or enable Model Fallback.
#### 1.14.1
* Fixed: Server-side chat errors (invalid API key, unavailable model, provider
outage, quota exceeded) were all shown to visitors as the same generic “A temporary
error occurred” message. Each cause now shows its own specific message, so site
owners can tell immediately whether the API key, the model, or the provider is
the problem.
* Fixed: The custom quota error message (Settings Messages) was never displayed
in the chat widget — the generic server error masked it. It now reaches visitors
as intended.
* Improved: The default quota error message no longer says “Currently recharging”(
which read like a service outage) — it now explains that the AI has reached its
usage limit and suggests trying again later or contacting the site.
#### 1.14.0
* Added: “Add to knowledge” button on every Unanswered Questions row — opens the
knowledge form with the question prefilled, closing the record improve loop
in one click.
* Added: “Create draft page” button for the generated FAQ — saves the draft as
a WordPress page (draft status) and links straight to the editor.
* Added: System Health panel on the dashboard — API key, cron schedules, crawl
freshness, WP-Cron availability, content index, PHP mbstring, and a live REST
API reachability probe.
* Fixed: The dashboard FAQ generator now uses its own AJAX action (raplsaich_generate_faq_draft)
so it no longer collides with the Pro knowledge-gap FAQ generator.
#### 1.13.0
* Added: Visitor history deletion (Settings Data Management, off by default) —
shows a “Delete my chat history” button in the widget so each visitor can permanently
remove their own stored conversation (privacy / GDPR friendly).
* Added: Unanswered Questions report on the dashboard — questions the bot could
not answer from site content are recorded (latest 50) with counts, so you know
exactly which pages or knowledge entries to add next.
* Added: FAQ draft generator on the dashboard — one click clusters the last 30
days of real visitor questions into an editable Markdown FAQ draft using your
configured AI provider.
* Added: The weekly summary email now includes the questions the bot could not
answer this week (content-gap report).
* Added: Google Analytics 4 events (Settings Data Management, off by default) —
fires chat open / message sent / response received events through your site’s
existing gtag.js. The plugin never loads gtag.js itself.
* Added: WP-CLI commands — `wp raplsaich status`, `wp raplsaich cleanup`, `wp raplsaich
crawl`, and `wp raplsaich unanswered [--clear]`.
* Fixed: The weekly summary cron event is now cleared on uninstall.
#### 1.12.0
* Added: Setup checklist on the dashboard — shows which of the three first-run
steps (connect a provider, run site learning, first conversation) are done and
links to the next one. Disappears once setup is complete.
* Added: Demo preview in the “Start for free” panel — a scripted sample conversation
shows how the widget looks and behaves before any API key is set.
* Added: Industry starter templates (Settings Chat Settings) — one click applies
a ready-made system prompt and preset questions for hotels/tourism, shops, clinics/
salons, professional services, or company sites.
* Added: Page Context (Settings AI Settings, on by default) — the page the visitor
is currently viewing is included as context, so questions like “does this product
ship overseas?” resolve against the right page.
* Added: Monthly Cost Guard (Settings Security) — set a monthly budget (USD);
when the estimated month-to-date API cost reaches it, the bot replies with a
fixed message instead of calling the AI and resumes next month. Admin notice
from 80% of budget.
* Added: Model Fallback (Settings AI Settings, off by default) — when the selected
model hits its quota, the reply is retried once with the same provider’s lightweight
model instead of showing an error to the visitor.
* Added: Weekly Summary Email (Settings Data Management, off by default) — conversation
count, AI replies, estimated cost, and recent visitor questions, mailed to the
site admin once a week.
* Improved: The review request is now shown only after the chatbot has actually
handled conversations (usage-based, dismissible once, plugin screens only) instead
of purely time-based.
#### 1.11.1
* Improved: When a message is blocked by a limit, the reply now explains which
limit was hit — monthly message quota, credits (Pro), token limit (Pro), the
daily per-visitor cap, or the short-term rate limit — instead of a single generic
message. Each message is translatable and filterable (`rapls_usage_reason_message`).
Optional setting to show the remaining allowance (off by default).
#### 1.11.0
* Added: “Grounded Answers Only” mode (Settings AI Settings). When on, if the
knowledge base and site learning have no content relevant to a question, the
bot replies that it could not find the information instead of answering from
the model’s general knowledge — reducing hallucination. The relevance threshold
and the “not found” message are configurable; works across keyword and vector(
RAG) search. Off by default; ignored when Web Search is on.
* Added: “Usage Control” (Settings Security) — an optional safety valve for your
own API spend (BYOK) when the chatbot is open to guests or members. Caps total
daily usage per guest and per logged-in user (separate from the per-IP rate limit).
Counts are kept server-side and cannot be bypassed by the client; guests are
identified by a salted hash (never a raw IP) with a configurable retention period
and automatic cleanup. Role-based limits, per-user credits, and a usage dashboard
are available in Pro.
#### 1.10.0
* Added: “AI-smell score” for Japanese bot replies in the Conversations log. When
enabled (Settings Chat Settings), each Japanese reply gets a read-only score
and a category breakdown (stiff connectives, over-emphatic vocabulary, monotone
endings, and more) with in-text highlighting, so you can spot wording that sounds
machine-written. It only detects and scores — replies are never altered, non-
Japanese replies are skipped, and it makes no external calls. Banned vocabulary
and weights are customizable via the `rapls_humanizer_*` filters.
#### 1.9.4
* Changed: The feedback buttons (👍👎) on bot messages now default to OFF on new
installs. You can turn them on anytime in Settings Chat Settings “Show feedback
buttons”. Existing sites keep their current setting.
#### 1.9.3
* Added: Support for Google’s new “AQ.” Gemini API keys. Google AI Studio now issues
keys in the new auth-key format (`AQ.Ab…`) instead of the legacy “AIza” standard
keys, which Google is retiring (unrestricted standard keys rejected from 2026-
06-19, all standard keys from 2026-09). Onboarding, key validation, and every
Gemini API call (chat, model list, and site-learning embeddings) now accept and
work with both formats.
* Changed: Gemini requests now send the key in the `x-goog-api-key` header instead
of the `?key=` query string — Google’s recommended method, required for the new“
AQ.” keys, and it keeps the key out of server/proxy/CDN logs.
* Added: An admin notice warns when your saved Gemini key is a legacy “AIza” standard
key, with the retirement dates and how to migrate to an “AQ.” key (or restrict
the existing one). It clears automatically once an “AQ.” key is saved.
#### 1.9.2
* Added: The “Start for free” onboarding now offers two no-credit-card paths —
OpenRouter free models and the Google Gemini free tier — so new users can pick
the provider that fits. Either choice validates the key, runs a connection test,
and auto-selects a working free model (Gemini defaults to `gemini-2.5-flash`).
* Added: Clear in-panel disclosure for each free option, shown before you choose.
The Gemini free tier may use submitted content to improve Google’s models; the
panel says so and points to paid tiers or other providers if you want your data
excluded. OpenRouter free models carry an equivalent note that upstream data-
handling varies.
* Docs: Refreshed the description, Getting Started, and FAQ for the two free paths,
and added a “Is my data private on the free options?” FAQ entry.
#### 1.9.1
* Fixed: Chat window froze with no reply shown when the AI answered with a markdown
table. The table separator-row regex rejected the standard GFM trailing pipe (`
|---|---|`), and the paragraph fallback then looped forever on the unconsumed
line, exhausting browser memory. Tables now render, and the renderer always makes
forward progress on any input.
* Fixed: Literal `
` tags that AI models emit inside markdown table cells now
render as line breaks instead of showing as raw text.
* Fixed: The Remove button for the OpenAI / Gemini API key had no effect on WordPress
7.0 sites. The “WordPress AI Client” RAG section renders duplicate hidden fields
with the same names later in the DOM, so its delete-flag “0” and empty key field
overrode the visible section’s values on submit. Hidden provider sections are
now excluded from form submission.
* Improved: After the onboarding connection test succeeds, a prominent “Reload
this page now” button appears (with auto-scroll and focus) so the saved provider
and model are applied before any further edits to the settings form.
#### 1.9.0
* Added: “Start for free” onboarding panel that appears on the Settings page when
no provider API key has been saved. Walks new users from zero to a working chatbot
in about a minute using an OpenRouter free API key (no credit card required).
Key is encrypted (AES-256-GCM), provider auto-set to OpenRouter, and a concrete
free model id (e.g. `openai/gpt-oss-120b:free`) is picked from the live `/v1/
models` catalog and saved as the active model.
* Added: Automatic 429 fallback for free models. When the active `:free` model
is throttled upstream (Venice / NVIDIA / etc), the active model is marked as
throttled for 10 minutes, an alternative `:free` model is picked from the catalog,
persisted to settings, and the chat request is retried once. Paid models pass
quota errors through unchanged.
* Changed: Plugin description and search tags repositioned from “Claude-native
RAG chatbot” to “self-hosted, BYOK, multi-provider” so the listing reflects the
actual feature set (OpenAI, Anthropic Claude, Google Gemini, OpenRouter). Two
new FAQ entries: “Do I need an API key?” and “Can I use it for free?”.
* Hardened: OpenRouter key validation now requires the `sk-or-` prefix and hits`/
v1/auth/key` (real auth check) instead of `/v1/models` (which returns 200 for
any string). The existing per-provider Test Connection button shares the fix.
* Fixed: Rate-limit countdown badge no longer wipes the paper-plane SVG icon (the
icon is restored when the cooldown ends), and the remaining-seconds text is now
high-contrast white on the brand-color disc instead of blending with the disabled-
gray background.
* Added: Free-version manual (Japanese and English) gains a “Quick Start (run it
for free)” section explaining the onboarding flow and rate-limit notes.
#### 1.8.2
* Documentation: refreshed the plugin description, feature list, FAQ, and search
tags. No functional changes.
#### 1.8.1
* Fixed: “Undefined array key link_target” PHP warning emitted by the chatbot widget
on sites where the link-target option had never been saved.
#### 1.8.0
* Added: WordPress 7.0 “AI Client (Connectors)” provider — chat routes through
wp_ai_client_prompt(); API keys and models are managed in Settings Connectors
instead of the plugin.
* Added: Curated cross-provider model dropdown, plus an automatic one-shot retry
without temperature for models (GPT-5 / o-series) that reject a custom value.
* Fixed: API-key-decryption “please re-enter” notice now fires only when the active
provider’s own key is broken; the wpai path skips the plugin-side key pre-check.
* Tested up to: WordPress 7.0.
#### 1.5.6
* Response Language setting fix
* Recommended for all users
#### 1.5.0
* Major update: Gutenberg block, Abilities API, language auto-detect, OpenRouter
#### 1.4.0
* Web search, cross-site embed, PDF/DOCX knowledge, vector embedding hybrid search
#### 1.3.0
* Response caching, audit logs, conversion tracking, offline messages
#### 1.0.0
* Initial release
## Мета
* Нуска **1.19.2**
* Акыркы жаңыртуу **2 күн мурун**
* Активдүү орнотуулар **50+**
* WordPress нускасы ** 6.3 же андан жогору **
* Tested up to **7.1**
* PHP нускасы ** 7.4 же андан жогору **
* Тилдер
* [English (US)](https://wordpress.org/plugins/rapls-ai-chatbot/) жана .[Japanese](https://ja.wordpress.org/plugins/rapls-ai-chatbot/).
* [Translate into your language](https://translate.wordpress.org/projects/wp-plugins/rapls-ai-chatbot)
* Тег:
* [AI Chatbot](https://ky.wordpress.org/plugins/tags/ai-chatbot/)[chatbot](https://ky.wordpress.org/plugins/tags/chatbot/)
[ChatGPT](https://ky.wordpress.org/plugins/tags/chatgpt/)[mcp](https://ky.wordpress.org/plugins/tags/mcp/)
[rag](https://ky.wordpress.org/plugins/tags/rag/)
* [Advanced View](https://ky.wordpress.org/plugins/rapls-ai-chatbot/advanced/)
## Рейтинг
4.9 out of 5 stars.
* [ 6 5-star reviews ](https://wordpress.org/support/plugin/rapls-ai-chatbot/reviews/?filter=5)
* [ 1 4-star review ](https://wordpress.org/support/plugin/rapls-ai-chatbot/reviews/?filter=4)
* [ 0 3-star reviews ](https://wordpress.org/support/plugin/rapls-ai-chatbot/reviews/?filter=3)
* [ 0 2-star reviews ](https://wordpress.org/support/plugin/rapls-ai-chatbot/reviews/?filter=2)
* [ 0 1-star reviews ](https://wordpress.org/support/plugin/rapls-ai-chatbot/reviews/?filter=1)
[Your review](https://wordpress.org/support/plugin/rapls-ai-chatbot/reviews/#new-post)
[See all reviews](https://wordpress.org/support/plugin/rapls-ai-chatbot/reviews/)
## Мүчөлөрү
* [ rapls ](https://profiles.wordpress.org/rapls/)
## Колдоо
Issues resolved in last two months:
3 out of 3
[Колдоо форумун көрүү](https://wordpress.org/support/plugin/rapls-ai-chatbot/)