---
title: "Set up Echo"
url: "https://docs.teleflows.io/guides/echo/how-to/set-up-echo.md"
canonical_url: "https://docs.teleflows.io/guides/echo/how-to/set-up-echo/"
last_updated: 2026-10-07
type: how-to
summary: "The Owner turns Echo on for the organization, adds a Gemini key and sets Echo's limits."
related:
  - "https://docs.teleflows.io/guides/echo/reference/settings-and-limits.md"
---

# Set up Echo

Only the organization's Owner can do this. Echo is off for an organization until the Owner turns it on.

## Open Settings → Echo

Open **Settings** and choose the **Echo** tab, or choose the settings icon in the Echo tray. The page header shows Echo's status: **Not set up**, **On** or **Off**.

Other users who open the page see "Owner access required".

## Two steps

"Save a policy, then add a Gemini key."

### 1. Save a policy

1. Turn on **Enable Echo**.
2. Choose an **Effort**: **Essential**, **Balanced** or **Deep**.
3. Check the limits. The defaults are fine to start; see [Settings and limits](https://docs.teleflows.io/guides/echo/reference/settings-and-limits/).
4. Choose **Save changes**. You see "Echo policy saved."

### 2. Add a Gemini key

Echo uses the organization's own Gemini key.

1. Under **Provider**, choose **Add key**.
2. Choose **Gemini**. Claude and ChatGPT are shown as "Coming soon".
3. Paste the key and choose **Save key**.

The key is "Stored encrypted. Only the masked ending is shown."

If Echo is on but has no active key, the page says "On, but no key." (or "The provider key is disabled.") with an **Add key** or **Replace key** button.

## Replace or disable the key

- **Replace key**: save a new key in place of the current one.
- **Disable**: confirm "Disable this key? Echo will not be able to make model requests with it." Echo then cannot make model requests until you add an active key.

## Turn Echo off

Turn off **Enable Echo** and choose **Save changes**.
