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

# Primeros pasos

> Ruta para principiantes absolutos: desde el launcher vanilla hasta tu primer chat con MineClawd.

## Objetivo

Sigue esta página paso a paso y obtendrás una respuesta exitosa de MineClawd.

## Glosario rápido

<CardGroup cols={2}>
  <Card title="Minecraft Java Edition">
    La versión para PC de Minecraft desde el launcher oficial.
  </Card>

  <Card title="Mod loader">
    Software que permite que Minecraft ejecute mods. MineClawd soporta Fabric, Forge y NeoForge.
  </Card>

  <Card title="Mod">
    Un archivo `.jar` que añade funciones a Minecraft.
  </Card>

  <Card title="API key">
    Una clave secreta que permite que MineClawd se conecte a un servicio de IA en línea.
  </Card>
</CardGroup>

## Elige tu plataforma

MineClawd soporta tres combinaciones de loader y versión. Elige la pestaña que coincida con tu setup.

<Tabs>
  <Tab title="NeoForge 1.21.1 (Recomendado)">
    ### Paso 1: instala NeoForge

    1. Descarga NeoForge Installer desde [neoforged.net](https://neoforged.net/)
    2. Selecciona la versión de Minecraft **1.21.1** y ejecuta el instalador.
    3. Abre Minecraft Launcher y ejecuta el perfil **NeoForge 1.21.1** una vez, luego cierra el juego.

    ### Paso 2: descarga los mods requeridos

    Descarga estos archivos desde Modrinth. En cada página, elige un archivo que coincida con **NeoForge** y **1.21.1**.

    | Mod                           | Enlace de descarga                                                             |
    | ----------------------------- | ------------------------------------------------------------------------------ |
    | MineClawd                     | [modrinth.com/mod/mineclawd](https://modrinth.com/mod/mineclawd)               |
    | KubeJS                        | [modrinth.com/mod/kubejs](https://modrinth.com/mod/kubejs)                     |
    | Architectury API              | [modrinth.com/mod/architectury-api](https://modrinth.com/mod/architectury-api) |
    | Rhino                         | [modrinth.com/mod/rhino](https://modrinth.com/mod/rhino)                       |
    | YetAnotherConfigLib v3 (YACL) | [modrinth.com/mod/yacl](https://modrinth.com/mod/yacl)                         |
    | Better ModList                | [modrinth.com/mod/better-modlist](https://modrinth.com/mod/better-modlist)     |
  </Tab>

  <Tab title="Forge 1.20.1">
    ### Paso 1: instala Forge

    1. Descarga Forge Installer desde [files.minecraftforge.net](https://files.minecraftforge.net/net/minecraftforge/forge/index_1.20.1.html)
    2. Ejecuta el instalador y selecciona **Install Client**.
    3. Abre Minecraft Launcher y ejecuta el perfil **Forge 1.20.1** una vez, luego cierra el juego.

    ### Paso 2: descarga los mods requeridos

    Descarga estos archivos desde Modrinth. En cada página, elige un archivo que coincida con **Forge** y **1.20.1**.

    | Mod                           | Enlace de descarga                                                             |
    | ----------------------------- | ------------------------------------------------------------------------------ |
    | MineClawd                     | [modrinth.com/mod/mineclawd](https://modrinth.com/mod/mineclawd)               |
    | KubeJS                        | [modrinth.com/mod/kubejs](https://modrinth.com/mod/kubejs)                     |
    | Architectury API              | [modrinth.com/mod/architectury-api](https://modrinth.com/mod/architectury-api) |
    | Rhino                         | [modrinth.com/mod/rhino](https://modrinth.com/mod/rhino)                       |
    | YetAnotherConfigLib v3 (YACL) | [modrinth.com/mod/yacl](https://modrinth.com/mod/yacl)                         |
    | Better ModList                | [modrinth.com/mod/better-modlist](https://modrinth.com/mod/better-modlist)     |
  </Tab>

  <Tab title="Fabric 1.20.1">
    ### Paso 1: instala Fabric

    1. Descarga Fabric Installer desde [fabricmc.net/use/installer](https://fabricmc.net/use/installer/)
    2. Ejecuta el instalador.
    3. Elige **Client** y versión de Minecraft **1.20.1**.
    4. Haz clic en **Install**.
    5. Abre Minecraft Launcher y ejecuta **Fabric Loader 1.20.1** una vez, luego cierra el juego.

    ### Paso 2: descarga los mods requeridos

    Descarga estos archivos desde Modrinth. En cada página, elige un archivo que coincida con **Fabric** y **1.20.1**.

    | Mod                           | Enlace de descarga                                                             |
    | ----------------------------- | ------------------------------------------------------------------------------ |
    | MineClawd                     | [modrinth.com/mod/mineclawd](https://modrinth.com/mod/mineclawd)               |
    | Fabric API                    | [modrinth.com/mod/fabric-api](https://modrinth.com/mod/fabric-api)             |
    | KubeJS                        | [modrinth.com/mod/kubejs](https://modrinth.com/mod/kubejs)                     |
    | Architectury API              | [modrinth.com/mod/architectury-api](https://modrinth.com/mod/architectury-api) |
    | Rhino                         | [modrinth.com/mod/rhino](https://modrinth.com/mod/rhino)                       |
    | YetAnotherConfigLib v3 (YACL) | [modrinth.com/mod/yacl](https://modrinth.com/mod/yacl)                         |
    | Mod Menu                      | [modrinth.com/mod/modmenu](https://modrinth.com/mod/modmenu)                   |
  </Tab>
</Tabs>

## Paso 3: coloca los archivos del mod en tu carpeta `mods`

1. Abre tu carpeta de Minecraft.
2. Abre la carpeta `mods`. Si no existe, créala.
3. Mueve todos los archivos `.jar` descargados a `mods`.
4. No descomprimas los archivos `.jar`.

## Paso 4: inicia el juego y abre la configuración de MineClawd

1. Inicia Minecraft con tu perfil de mod loader.
2. Crea o abre un mundo de un jugador.
3. Activa **Allow Cheats** en ese mundo.
4. Abre **Better ModList** -> **MineClawd** -> **Configure** (o **Mod Menu** si usas Fabric).

<Frame caption="GUI de configuración de MineClawd dentro del juego">
  <img src="https://mintcdn.com/cyniaai/qq7jpO_G131Xb8Bd/images/mineclawd-config.png?fit=max&auto=format&n=qq7jpO_G131Xb8Bd&q=85&s=28debc82f73e827b063b2ab416caba43" alt="Pantalla de configuración de MineClawd en el juego" width="2880" height="1659" data-path="images/mineclawd-config.png" />
</Frame>

## Paso 5: conecta un servicio de IA

Si todavía no tienes una cuenta de IA, usa OpenRouter y elige un modelo gratuito.

1. Crea una cuenta: [openrouter.ai](https://openrouter.ai/)
2. Crea una API key: [openrouter.ai/settings/keys](https://openrouter.ai/settings/keys)

<Frame caption="Página de gestión de API keys de OpenRouter">
  <img src="https://mintcdn.com/cyniaai/qq7jpO_G131Xb8Bd/images/openrouter.png?fit=max&auto=format&n=qq7jpO_G131Xb8Bd&q=85&s=eed1e59d8e62dc2caf1d8b2224e8e906" alt="Página de configuración de OpenRouter mostrando gestión de API keys" width="2880" height="1530" data-path="images/openrouter.png" />
</Frame>

3. En la pantalla de configuración de MineClawd, define:
   * **Provider**: `OpenAI`
   * **Endpoint**: `https://openrouter.ai/api/v1`
   * **API Key**: pega tu clave de OpenRouter
   * **Model**: elige un model id de [openrouter.ai/models](https://openrouter.ai/models) (los modelos gratis suelen incluir `:free`)
   * **Summarize Model**: usa el mismo model id por ahora
4. Guarda la configuración.

<Info>
  Los modelos gratis y sus límites cambian con el tiempo. Si un modelo falla, elige otro model id en la misma página.
</Info>

### Paso 5b (opcional): habilita búsqueda web

MineClawd puede buscar en la web durante las conversaciones con Tavily. Es opcional, pero útil cuando quieres que MineClawd consulte documentación de mods, recetas de crafteo u otras referencias online.

1. Crea una cuenta en Tavily: [tavily.com](https://tavily.com/)
2. Copia tu API key desde el panel de Tavily.

<Frame caption="Página de gestión de API keys de Tavily">
  <img src="https://mintcdn.com/cyniaai/qq7jpO_G131Xb8Bd/images/tavily.png?fit=max&auto=format&n=qq7jpO_G131Xb8Bd&q=85&s=5abd5fa53d78394206af5e13e1a243d4" alt="Plataforma de Tavily mostrando la interfaz de gestión de API keys" width="2880" height="1530" data-path="images/tavily.png" />
</Frame>

3. En la pantalla de configuración de MineClawd, pega la clave en **Tavily API Key** dentro del grupo **Search**. También puedes configurarla con este comando:

```bash theme={null}
/mineclawd config tavily-api-key <your-tavily-key>
```

Cuando se configura, MineClawd obtiene la herramienta `search` para consultar la web y devolver fragmentos concisos con fuentes. Si la clave no está definida, la herramienta de búsqueda se desactiva y MineClawd te avisará cuando pidas una búsqueda web.

## Paso 6: envía tu primer mensaje

Tienes dos formas de hablar con MineClawd:

### Opción A: usa la GUI de superposición

Busca el orbe flotante (Assistive Touch) en el lado izquierdo de la pantalla. Haz clic en el orbe para abrir la superposición, escribe tu mensaje en la barra de entrada y haz clic en **Send**.

<Frame caption="El orbe Assistive Touch abre la superposición con un clic">
  <img src="https://mintcdn.com/cyniaai/V8MogwCX4un-bpiN/images/mineclawd-assistive-touch.png?fit=max&auto=format&n=V8MogwCX4un-bpiN&q=85&s=32f44103e6a93d020a2fd193cafd6968" alt="Orbe flotante Assistive Touch de MineClawd" width="2880" height="1659" data-path="images/mineclawd-assistive-touch.png" />
</Frame>

### Opción B: usa comandos de chat

Abre el chat y ejecuta:

```bash theme={null}
/mclawd hello
```

Ambos métodos funcionan. La superposición te da respuestas en streaming y gestión de Session en un solo lugar. Revisa [uso de la GUI](/tutorials/using-the-gui) para la guía completa.

## Si no funciona

Ve a [/resources/troubleshooting](/resources/troubleshooting) y sigue el síntoma que coincida.

## Siguientes pasos

Usa estas guías para profundizar después de tu primera solicitud exitosa.

<CardGroup cols={2}>
  <Card title="Uso de la GUI" icon="desktop" href="/tutorials/using-the-gui">
    Aprende el diseño de la superposición, el estado de streaming y las preguntas en línea.
  </Card>

  <Card title="Gestionar Sessions" icon="book-open" href="/tutorials/managing-sessions">
    Crea, cambia y repara Sessions para trabajo continuo.
  </Card>

  <Card title="Seguimiento de assets" icon="box" href="/tutorials/tracking-assets">
    Explora y gestiona todo lo que MineClawd crea en tu mundo.
  </Card>

  <Card title="Referencia de comandos" icon="terminal" href="/commands/overview">
    Explora cada comando de `/mineclawd` con ejemplos.
  </Card>
</CardGroup>