---
title: "Usa RunAPI in Hermes Agent — Guida alla configurazione di un endpoint personalizzato"
url: "https://runapi.ai/it/hermes-agent.md"
canonical: "https://runapi.ai/it/hermes-agent"
locale: "it"
---

# RunAPI in Hermes Agent

Hermes Agent può usare un endpoint personalizzato compatibile con OpenAI per i modelli chat. Copia il prompt in Hermes Agent, lascia che crei il provider personalizzato e usa la scheda config solo quando vuoi il YAML esatto.

## Install prompt

Copy this prompt into Hermes Agent:

```text
Configure this Hermes Agent install to use RunAPI.

Requirements:
- Read the API key from RUNAPI_API_KEY. Do not hardcode the key.
- Add a custom provider named runapi.
- Use base_url "https://runapi.ai/v1".
- Use key_env RUNAPI_API_KEY.
- Use api_mode chat_completions.
- Set model.provider to custom:runapi.
- Set the default model to gpt-5.5.
- Run `hermes doctor` and report any config problems before starting a session.
- If RUNAPI_API_KEY is missing, ask me to set it before starting Hermes Agent.
```

## Configuration

```yaml
custom_providers:
  - name: runapi
    base_url: "https://runapi.ai/v1"
    key_env: RUNAPI_API_KEY
    api_mode: chat_completions

model:
  provider: custom:runapi
  default: gpt-5.5
```

## Steps

1. **Incolla il prompt di configurazione** — Copia il prompt dalla prima scheda in Hermes Agent. Indica a Hermes Agent di leggere RUNAPI_API_KEY e di aggiungere RunAPI come provider personalizzato nominato.
2. **Rivedi la configurazione generata** — Hermes Agent dovrebbe impostare provider su custom:runapi e usare gpt-5.2 come predefinito, con key_env puntato a RUNAPI_API_KEY.
3. **Esegui i diagnostici** — Esegui hermes doctor dopo aver modificato la configurazione, poi apri Hermes Agent e invia un breve prompt di test prima di usarlo per un task più grande.

## FAQ

### Hermes Agent può usare RunAPI come endpoint personalizzato?

Sì. Hermes Agent supporta la selezione dei modelli e endpoint personalizzati. Configura il provider personalizzato nominato con la base URL /v1 di RunAPI, conserva la API key in RUNAPI_API_KEY e seleziona un modello RunAPI come gpt-5.2.

### Devo usare hermes model o modificare il file di configurazione?

Usa hermes model quando vuoi il selettore guidato. Modifica il file di configurazione quando ti serve una configurazione ripetibile per un server o un ambiente condiviso. In entrambi i casi, verifica poi con hermes doctor.

### Dove va impostata RUNAPI_API_KEY per Hermes Agent?

Imposta RUNAPI_API_KEY nella stessa shell, unità di servizio o ambiente gateway che avvia Hermes Agent. Gli avvii da GUI o daemon non ereditano sempre le variabili della shell interattiva.

### Hermes Agent può ancora usare altri provider dopo aver aggiunto RunAPI?

Sì. Aggiungere RunAPI come custom:runapi non rimuove le altre opzioni di modello di Hermes Agent. Usa il modello hermes o il comando /model quando vuoi passare da un modello configurato all’altro.


## Links

- [Model catalog](https://runapi.ai/it/models)
- [CLI](https://runapi.ai/it/cli)
- [MCP Server](https://runapi.ai/it/mcp)
- [Pricing](https://runapi.ai/it/pricing)
- [API docs](https://runapi.ai/it/docs)
- [OpenClaw setup](https://runapi.ai/it/openclaw)