OpenClaw Integration Guide

MCP server for RURussian.com – turn your OpenClaw bot into a Russian tutor, and let paid bots activate service smoothly.

Quick Start

Install the server using pip:

pip install rurussian-mcp

After your subscription is active, open your profile page and load your Bot API Key. Then add this to your ~/.openclaw/config.json:

{
  "mcpServers": {
    "rurussian": {
      "command": "rurussian-mcp",
      "args": [],
      "env": {
        "RURUSSIAN_API_URL": "https://rurussian.com/api",
        "RURUSSIAN_API_KEY": "YOUR_BOT_API_KEY"
      }
    }
  }
}

If you do not have a key yet, the MCP server can also guide the bot through list_pricing_plans, create_key_purchase_session, and confirm_key_purchase.

Recommended Flow

1. Activate or renew a subscription

Use the pricing flow on RURussian, or let a payment-capable bot complete hosted checkout.

2. Load your Bot API Key

Go to /profile, open the Bot API Key panel, and copy the key or the ready-made OpenClaw config snippet.

3. Start the MCP session

Preload RURUSSIAN_API_KEY in OpenClaw or call authenticate at session start.

4. Route learner tasks

Use RuRussian tools for vocabulary, grammar breakdown, sentence examples, reading drills, and translation.

Available Tools

list_pricing_plans()

Show supported RuRussian plans for bots that need activation.

Example request: "Show the available RuRussian plans for this bot."

authenticate(api_key, user_agent?)

Initialize the session using your Bot API Key.

Example request: "Use my RuRussian Bot API Key and initialize this session."

create_key_purchase_session(email, plan, success_url?, cancel_url?)

Create a hosted checkout session when the bot is allowed to buy access.

Example request: "Create a checkout session for year_1 and return the payment URL."

confirm_key_purchase(session_id, auto_authenticate?)

Confirm payment completion and unlock the MCP session.

Example request: "Confirm the payment session and unlock this server session."

get_word_data(word)

Get declension and meaning of a word.

Example request: "Explain the declension and meaning of книга."

get_sentences(word, form_word?, form_id?)

Show example sentences for a word.

Example request: "Show example sentences for идти in past tense."

generate_zakuska(topic?, mode?)

Generate a short Russian text about a topic.

Example request: "Generate a short A2-level Russian text about travel."

analyze_sentence(sentence)

Break down a sentence and explain each form.

Example request: "Break down this sentence and explain each form: Я люблю программировать."

translate_text(text)

Translate Russian text to English.

Example request: "Translate this Russian paragraph to English."

Troubleshooting

Missing Bot API Key: Load it from the Bot API Key panel in /profile after your subscription is active.
Authentication required error: Preload RURUSSIAN_API_KEY or call authenticate before learner tools.
Need to rotate or revoke a key: Use the Bot API Key panel in your profile page.
Command not found: rurussian-mcp: Ensure installation completed in the same environment where OpenClaw runs.
API endpoint/network errors: Verify internet access and optionally set RURUSSIAN_API_URL only if you need a custom backend URL.

Need Help?

Check out our API Documentation or read our Blogs for more tutorials and examples.