> ## Documentation Index
> Fetch the complete documentation index at: https://docs.orgo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Set up Latitude

> See every agent run as a trace in Latitude. Set up Hermes and OpenClaw from the dashboard; connect any other agent in two lines.

![Latitude](https://mintcdn.com/orgo/V6fFEPPpVtFdQX_N/images/latitude-light.png?fit=max\&auto=format\&n=V6fFEPPpVtFdQX_N\&q=85\&s=d579db6116822deadf73edfca7e095b1)

[Latitude](https://latitude.so) is open-source observability for AI agents. Each run appears as a trace in your Latitude organization.

Orgo sets up Hermes and OpenClaw for you. A custom agent, or any other harness, connects to Latitude directly, as described in [Connect any other agent](#connect-any-other-agent).

> [!NOTE]
>
> Traces are stored in your Latitude organization, not in Orgo. Latitude bills for them, with a free tier and paid plans.

## Set up Hermes or OpenClaw

> [!NOTE]
>
> Automatic setup supports OpenClaw and the main Hermes agent on a Linux computer. Only the workspace owner can use it.

1. **Connect Latitude.** Open **Integrations**, choose **Latitude**, select **Install**, then **Connect an existing account**. Sign in, pick the organization that should hold this workspace's traces, and select **Authorize**. Without an account, choose **Create a new organization**: Latitude creates one under your Orgo email.
2. **Add the agent.** Select **Set up Latitude**, tick the agent and select **Confirm selection**. If the agent is listed by its computer instead, select **Set up monitoring** beside it. Orgo creates a project and API key for the agent in your organization and installs the telemetry plugin. This takes about a minute.
3. **Send it a message.** Setup finishes on the agent's first run. Select **Open chat** and send anything. The agent's row then reads **Monitoring**.

Select **Open Latitude** to see the traces. To add another agent, open Latitude in **Integrations** again.

## Turn traces on or off

In **Personal**, open the agent and go to **Settings**. Use the **Send traces to Latitude** switch to turn traces on or off, or select **Disable monitoring** on the Latitude page. The agent's project and history stay in Latitude. Turning traces back on repeats setup, so send the agent a message again.

## What automatic setup sends

Automatic setup sends only each run's steps, tool calls, model, duration, token counts and status. Prompts, replies, tool arguments, memory, files and screen content are never sent to Latitude, and no setting changes that.

## Connect any other agent

A custom agent, or a harness Orgo doesn't set up, sends its traces straight to Latitude. It can run on an Orgo computer or anywhere else, with no setup in Orgo.

**1. Create a project and key.** In Latitude, create a project and copy its slug from the project sidebar. Then create an API key under **Settings → API Keys**.

**2. Connect the agent.** Pick the option that fits:

**TypeScript or Python**

Install Latitude's [TypeScript SDK](https://docs.latitude.so/telemetry/typescript) or [Python SDK](https://docs.latitude.so/telemetry/python) and follow its guide for your model provider or framework.

**Any OpenTelemetry harness**

Point the harness's OpenTelemetry exporter at Latitude. Set `LATITUDE_API_KEY` to your key and `LATITUDE_PROJECT` to your project slug, then:

```bash theme={null}
export OTEL_EXPORTER_OTLP_TRACES_ENDPOINT="https://ingest.latitude.so/v1/traces"
export OTEL_EXPORTER_OTLP_TRACES_HEADERS="Authorization=Bearer $LATITUDE_API_KEY,X-Latitude-Project=$LATITUDE_PROJECT"
```

Most OpenTelemetry SDKs read these standard variables without code changes. Spans with the OpenTelemetry `gen_ai.*` attributes show their model, tokens and cost.

**Claude Code, Hermes, OpenClaw**

Follow Latitude's guide for [Claude Code](https://docs.latitude.so/telemetry/claude-code), [Hermes](https://docs.latitude.so/telemetry/hermes) or [OpenClaw](https://docs.latitude.so/telemetry/openclaw). Use it for a Hermes or OpenClaw agent that Orgo can't set up.

**3. Check the trace.** Run the agent once. The trace appears under **Traces** in your project within a few seconds.

> [!WARNING]
>
> A setup you make yourself can send prompts and replies. For structure only, set `LATITUDE_NO_CONTENT=true` for Hermes, or `config.allowConversationAccess` to `false` for OpenClaw.

On an Orgo computer, keep the key in [Settings → Secrets](https://www.orgo.ai/settings/secrets) and **Apply** it to the computer, then restart the agent. See [Secrets](/guides/templates/secrets).

## When Orgo can't set an agent up

The agent is listed under **Not available for automatic setup** with the reason, and its switch is locked. Common reasons: it is a second Hermes profile on its computer, its computer doesn't run Linux, or Orgo can't tell which harness it runs. Connect it yourself, as described in [Connect any other agent](#connect-any-other-agent).

## Remove a project or disconnect Latitude

* Select **Remove Latitude project** to delete the project from your organization.
* Select **Disconnect** to stop monitoring for every agent and remove Orgo's access to your organization. Your projects and history stay in Latitude.

## Good to know

* If Latitude's sign-in email opens a new tab, return to the Orgo tab and connect again.
* If connecting shows **Latitude is temporarily unavailable**, try again.
* If setup fails, select **Retry setup** on the Latitude page, or **Retry** beside the switch.
* An agent that doesn't run within a day of setup shows **No run yet**. Select **Retry setup**, then message it.
* **Reconnect required** means Orgo lost access to your organization. Select **Reconnect Latitude**.
* Full reference: [docs.latitude.so](https://docs.latitude.so).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.