Configuration 

LLM provider setup 

The Cowriter extension uses the nr-llm extension for LLM provider configuration. Configure your preferred provider in the nr-llm backend module.

Supported providers 

  • OpenAI - GPT-5.x series, o-series reasoning models
  • Anthropic Claude - Claude 4.5 Opus, Sonnet, Haiku
  • Google Gemini - Gemini 3 Pro, Flash
  • OpenRouter - Access to 100+ models from multiple providers
  • Mistral - Mistral Large, Medium, and open models
  • Groq - Ultra-fast inference with Llama, Mixtral

Configuration steps 

  1. Navigate to Admin Tools > LLM Management
  2. Add a provider (e.g., OpenAI with your API key)
  3. Create a model configuration
  4. Create an LLM configuration and set it as default

RTE configuration 

There are two ways to configure the CKEditor integration:

Option 1: Using static PageTSconfig 

If you don't have a custom RTE configuration, include the static PageTSconfig:

  1. Go to your root page
  2. Open Page Properties > Resources
  3. Add the static PageTSconfig from t3_cowriter
Page TSconfig configuration in TYPO3 v14

The Page TSconfig field with RTE.default.preset = cowriter.

Option 2: Custom RTE configuration 

If you have your own RTE configuration file (your_ext/Configuration/RTE/YourConfig.yaml), add the Cowriter module:

editor:
  config:
    importModules:
      - { module: '@netresearch/t3_cowriter/cowriter', exports: ['Cowriter'] }
    toolbar:
      items:
        - cowriter
        - cowriterVision
        - cowriterTranslate
        - cowriterTemplates
Copied!

The four toolbar items are:

cowriter
Main dialog — task-based content generation with preview
cowriterVision
Generate image alt text via LLM vision analysis
cowriterTranslate
Inline translation dropdown (10 languages)
cowriterTemplates
Open the Cowriter dialog with a task pre-selected

Task configuration 

The Cowriter dialog shows nrllm:configuration-tasks from the nr-llm extension with category = 'content'. Default tasks (Improve, Summarize, Extend, Fix Grammar, Translate EN/DE) are seeded during installation.

Adding custom tasks 

  1. Navigate to Admin Tools > LLM Management
  2. Create a new task record with category = 'content'
  3. Set a descriptive name and identifier
  4. Write a prompt template using {{input}} as the placeholder for user content
Example prompt template 
Rewrite the following text in a more engaging tone, suitable for
a marketing audience. Output ONLY the rewritten text without
explanations.

{{input}}
Copied!

Rate limiting 

The Cowriter enforces a rate limit of 20 requests per minute per backend user. When the limit is exceeded, the API returns HTTP 429 with a Retry-After header.

Security considerations 

The Cowriter extension routes all LLM requests through the TYPO3 backend, ensuring that:

  • API keys are never exposed to the frontend
  • All requests are authenticated via TYPO3's backend session
  • Error conditions are logged for debugging

Troubleshooting 

Translation not working 

If the translate button shows "Translation failed", check:

  1. An LLM provider is configured and marked as default in Admin Tools > LLM Management
  2. The provider's API key is valid and not expired
  3. The provider supports the translation feature
  4. Check the TYPO3 system log for detailed error messages

No tasks in dropdown 

If the Tasks dropdown shows "No tasks configured":

  1. Navigate to Admin Tools > LLM Management > Tasks
  2. Create at least one task with category = 'content'
  3. Make sure the task record is not hidden or deleted
  4. Reload the page in the browser to refresh the task list

API key rejected 

If you see "The LLM provider rejected the API key":

  1. Check the provider configuration in the LLM module
  2. Verify the API key is correct and has not been revoked
  3. Some providers require specific permissions or billing setup

Rate limit exceeded 

The Cowriter allows 20 requests per minute per backend user. If you hit the limit, wait a moment and try again. The Retry-After response header indicates when the limit resets.