> For the complete documentation index, see [llms.txt](https://wren.atriasafety.org/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://wren.atriasafety.org/starting/configuration.md).

# Configuration Guide

Wren is highly customizable! Server administrators can configure how Wren behaves, what it knows, and how it interacts with users directly from Discord.

There are no confusing text files to edit. Everything is managed through simple, built-in slash commands!

## The Configuration Panel

To change Wren's core settings, just type `/wren config view` in any channel. This will open up an interactive menu with four main categories:

### 1. Identity

This is how Wren presents itself in your community.

* **Server display name:** The friendly name of your server.
* **Bot display name:** You can rename Wren to fit your server's theme!
* **In-game PM handle:** The handle Wren uses when replying to players in Roblox games like ERLC.

### 2. Channels & Roles

Tell Wren where it is allowed to operate and who is in charge.

* **Status channel:** Where Wren posts important updates.
* **ERLC log channel:** Where Wren sends logs from in-game events.
* **Security role:** The role required to access secure Wren commands.
* **Staff role:** Set this to the role you give everyone on your staff team. Members with this role can use everyday moderation tools like kicking, teleporting, and messaging players. See the [Permissions](/features/permissions.md) page for the full list.
* **Admin role:** Set this to the role you give everyone on your admin team. Members with this role can use sensitive tools like banning, and promoting or demoting moderators and administrators. Every role above the admin role in your server's role hierarchy is automatically treated as admin too, so you only need to set the lowest admin rank.

### 3. Behaviour

This is the most powerful setting!

* **Core info:** This is an "always-on" note for Wren. You can tell Wren about your server's vibe, the timezone, or who to ping in an emergency. Wren will *always* keep this information in mind when talking to people.

### 4. Secrets

If you are connecting Wren to external services, you can securely store the keys here.

* **ERLC server key:** Required to connect Wren to your Emergency Response: Liberty County server.
* **POW token:** Required if you use POW integrations.

{% hint style="warning" %}
⚠️ **IMPORTANT:** You must whitelist Wren's IP (`152.53.21.47`) in your ERLC server dashboard (<https://api.erlc.gg/server-owners>), otherwise Wren won't be able to connect or perform any actions.
{% endhint %}

{% hint style="info" %}
All secrets are heavily encrypted in our database. We take your security very seriously!
{% endhint %}

## Other Configuration Commands

Wren has several other commands to help you manage its knowledge and user access:

* `/wren sources list` or `/wren sources add`: Manage where Wren gets its Real-Time Knowledge from. You can add Discord channels, websites, or documents for Wren to read and learn from!
* `/wren memory list`: View and manage the long-term memories Wren has saved about your server or users.
* `/wren bans add`: Prevent specific users from talking to Wren if they are abusing the system.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://wren.atriasafety.org/starting/configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.