ACP

Ejecutar el bridge ACP (Agent Client Protocol) para comunicarse con el gateway de OpenClaw.

Este comando habla ACP sobre el stdio del IDE y reenvía prompts al gateway

over WebSocket. It maps ACP sessions to gateway session keys.

Usa el cliente ACP integrado para verificar el bridge sin un IDE.

Spawnea un bridge ACP y te permite escribir prompts interactivamente.

openclaw acp client


openclaw acp client --server-args --url wss://gateway-host:18789 --token <token>


openclaw acp client --server "node" --server-args openclaw.mjs acp --url ws://127.0.0.1:19001

Usa ACP cuando tu IDE (u otro cliente) habla el Agent Client Protocol y quieres

que conduzca una sesión de OpenClaw Gateway.

1. Asegúrate de que el gateway esté corriendo (local o remoto).

2. Configura el objetivo del gateway (config o flags).

3. Configura tu IDE para ejecutar ''openclaw acp'' sobre stdio.

Ejemplo de config (persistente):

openclaw config set gateway.remote.url wss://gateway-host:18789
openclaw config set gateway.remote.token <token>

Ejemplo de ejecución directa (sin escribir config):

openclaw acp --url wss://gateway-host:18789 --token <token>

ACP no selecciona directamente un agente. Enruta vía la clave de sesión del gateway.

Usa una clave de sesión con ámbito de agente para apuntar a un agente específico:

openclaw acp --session agent:main:main
openclaw acp --session agent:design:main
openclaw acp --session agent:qa:bug-123

Cada sesión ACP mapea a una clave de sesión del gateway. Un agente puede tener múltiples sesiones

de agente; ACP por defecto usa una sesión aislada ''acp:<uuid>'' a menos que anules

la clave o etiqueta.

Agrega un agente ACP personalizado en ''~/.config/zed/settings.json'' (o usa la UI de ajustes de Zed):

{
  "agent_servers": {
    "OpenClaw ACP": {
      "type": "custom",
      "command": "openclaw",
      "args": ["acp"],
      "env": {}
    }
  }
}

Para apuntar a un gateway o agente específico:

{
  "agent_servers": {
    "OpenClaw ACP": {
      "type": "custom",
      "command": "openclaw",
      "args": [
        "acp",
        "--url",
        "wss://gateway-host:18789",
        "--token",
        "<token>",
        "--session",
        "agent:design:main"
      ],
      "env": {}
    }
  }
}

En Zed, abre el panel Agent y selecciona "OpenClaw ACP" para iniciar un hilo.

Por defecto, las sesiones ACP obtienen claves de sesión del gateway aisladas con el prefijo ''acp:''.

Para reutilizar una sesión conocida, pasa una clave de sesión o etiqueta:

- ''--session <key>'': Usa una clave de sesión específica del gateway.

- ''--session-label <label>'': Resuelve una sesión existente por etiqueta.

- ''--reset-session'': Crea un nuevo ID de sesión para esa clave (misma clave, nuevo registro).

Si tu cliente ACP soporta metadata, puedes anular por sesión:

{
  "_meta": {
    "sessionKey": "agent:main:main",
    "sessionLabel": "support inbox",
    "resetSession": true
  }
}

Para aprender más sobre claves de sesión, visita ''/concepts/session''.

- ''--url <url>'': URL WebSocket del Gateway (por defecto gateway.remote.url cuando está configurado).

- ''--token <token>'': Token de autenticación del Gateway.

- ''--password <password>'': Contraseña de verificación del Gateway.

- ''--session <key>'': Clave de sesión predeterminada.

- ''--session-label <label>'': Etiqueta de sesión predeterminada a resolver.

- ''--require-existing'': Falla si la clave/etiqueta de sesión no existe.

- ''--reset-session'': Reinicia la clave de sesión antes del primer uso.

- ''--no-prefix-cwd'': No prefijar prompts con el directorio de trabajo.

- ''--verbose, -v'': Logging verbose a stderr.

#

- ''--cwd <dir>'': Directorio de trabajo para la sesión ACP.

- ''--server <command>'': Comando del servidor ACP (predeterminado: ''openclaw'').

- ''--server-args <args...>'': Argumentos extra para pasar al servidor ACP.

- ''--server-verbose'': Habilita logging verbose en el servidor ACP.

- ''--verbose, -v'': Logging verbose del cliente.