- FreeToken openclaw utiliza sesiones del navegador en lugar de las claves API tradicionales de los proveedores.
- Los proveedores compatibles incluyen DeepSeek, Qwen, Kimi, Claude, ChatGPT, Gemini, Grok y otros.
- La configuración básica requiere Node.js 22.12.0 o posterior y pnpm 9.0.0 o posterior.
- El flujo de trabajo diario utiliza el modo de depuración de Chrome, el proceso de incorporación y el servidor gateway de OpenClaw.
- La prioridad de seguridad es proteger las cookies locales, las credenciales bearer y el acceso al espacio de trabajo.
Descripción general de FreeToken openclaw
FreeToken openclaw es una configuración de OpenClaw autenticada mediante el navegador, diseñada para conectarse con múltiples servicios web de IA a través de un gateway unificado. En lugar de comenzar con una clave API adquirida por separado para cada proveedor, este flujo utiliza un inicio de sesión en el navegador, captura localmente las credenciales de sesión necesarias y expone los modelos configurados mediante la interfaz de OpenClaw.
Este enfoque resulta útil para experimentar, comparar modelos y crear flujos de trabajo personales con agentes. No es lo mismo que un servicio API oficial e ilimitado. Las sesiones web pueden caducar, los endpoints web pueden aplicar límites de frecuencia y los términos de uso de cada proveedor siguen siendo aplicables.
Gateway unificado
Chatea con los proveedores configurados a través de una única interfaz web, CLI/TUI o gateway HTTP local.
Autenticación mediante navegador
Inicia sesión en las interfaces web compatibles y deja que el proceso de incorporación guarde los datos de sesión localmente.
Pruebas con varios modelos
Compara las respuestas de varios proveedores o envía una misma pregunta a todos ellos con AskOnce.
| Área | Enfoque de FreeToken openclaw | Significado práctico |
|---|---|---|
| Autenticación | Inicio de sesión en el navegador y captura local de la sesión | El acceso al proveedor comienza en una sesión normal del navegador |
| Acceso a modelos | Capa de proveedores unificada | Cambia de modelo sin modificar todo el cliente |
| Gateway | Servicio HTTP local | La interfaz web, la CLI y las integraciones pueden utilizar un único servicio en ejecución |
| Llamada de herramientas | Herramientas locales inyectadas en el prompt | Los agentes configurados pueden utilizar herramientas como read, write, exec y búsqueda web |
| Licencia | Licencia MIT del proyecto | Revisa por separado los términos del proyecto y los de los servicios de terceros |
Considera esta configuración como un entorno local de investigación y automatización. Comienza con un proveedor, verifica el gateway y añade más sesiones solo después de estabilizar el flujo de trabajo básico.
Comparación de proveedores y modelos
La capa de proveedores es el principal motivo para utilizar OpenClaw en una configuración sin tokens. Se enumeran varios proveedores web probados, mientras que Manus se describe por separado con una cuota gratuita basada en API. Los detalles de compatibilidad pueden variar según el proveedor, así que configura únicamente los servicios que necesites activamente.
| Proveedor | Modelos de ejemplo | Chat | Llamada de herramientas | Tipo de autenticación |
|---|---|---|---|---|
| DeepSeek Web | deepseek-chat, deepseek-reasoner | Compatible | Compatible | Sesión del navegador |
| Qwen Web | Qwen 3.5 Plus, Qwen 3.5 Turbo | Compatible | Compatible | Sesión del navegador |
| Kimi | Moonshot v1 8K/32K/128K | Compatible | Compatible | Sesión del navegador |
| Claude Web | Claude Sonnet 4-6, Opus 4-6, Haiku 4-6 | Compatible | Compatible | Sesión del navegador |
| ChatGPT Web | GPT-4, GPT-4 Turbo | Compatible | Compatible | Sesión del navegador |
| Gemini Web | Gemini Pro, Gemini Ultra | Compatible con observaciones de estabilidad | Compatible con observaciones sobre el sondeo DOM | Sesión del navegador |
| Grok Web | Grok 1, Grok 2 | Compatible | Compatible | Sesión del navegador |
| GLM Web | GLM-4 Plus, GLM-4 Think | Compatible | Compatible | Sesión del navegador |
| Doubao Web | doubao-seed-2.0, doubao-pro | Observaciones de chat limitado | No disponible en la matriz de llamadas de herramientas indicada | Sesión del navegador |
| Manus | Manus 1.6, Manus 1.6 Lite | Compatible mediante la cuota indicada | No se presenta como acceso web sin tokens | Clave API con cuota gratuita |
Para cambiar de modelo, utiliza el comando /model en el cuadro de chat. Cuando un proveedor tenga varias variantes, es preferible utilizar identificadores exactos. Por ejemplo, una configuración de Claude puede resolverse de forma más fiable con /model claude-web/claude-sonnet-4-6 que con el comando más corto que solo indica el proveedor.
| Comando | Propósito | Ejemplo |
|---|---|---|
/models | Enumerar los proveedores y modelos configurados | Muestra el modelo activo, los alias y la configuración |
/model provider | Seleccionar un alias de proveedor | /model deepseek-web |
/model provider/model | Seleccionar un modelo exacto | /model claude-web/claude-sonnet-4-6 |
| AskOnce | Enviar una pregunta a varios modelos | Comparar las respuestas lado a lado |
No asumas que todos los proveedores se comportan de forma idéntica. Gemini puede presentar inestabilidad en el sondeo DOM, y Doubao queda excluido del flujo de llamadas de herramientas indicado debido a una limitación del analizador de streams.
Guía de configuración paso a paso
La ruta de instalación recomendada utiliza Node.js, pnpm, una sesión de depuración de Chrome, el asistente de autenticación web y el servidor gateway. Mantén disponibles las sesiones del navegador y de la terminal mientras completas el proceso de incorporación.
Instala las herramientas necesarias
Utiliza Node.js versión 22.12.0 o posterior y pnpm versión 9.0.0 o posterior. macOS y Linux son compatibles directamente. En Windows, utiliza WSL2 y sigue el flujo de trabajo de Linux.
Clona y compila el proyecto
Clona el proyecto OpenClaw sin tokens, entra en su directorio y ejecuta pnpm install, pnpm build y pnpm ui:build. Utiliza pnpm para los comandos de compilación en lugar de sustituirlo por otro gestor de paquetes.
Inicia el modo de depuración de Chrome
Ejecuta ./start-chrome-debug.sh y mantén abierta esa terminal. La sesión de depuración del navegador proporciona el entorno para iniciar sesión en los proveedores web compatibles.
Inicia sesión y ejecuta la incorporación
Inicia sesión en los sitios web de los proveedores que quieras utilizar. En una terminal nueva, ejecuta ./onboard.sh webauth, elige el proveedor correspondiente y permite que el asistente capture las credenciales de sesión locales necesarias.
Inicia el gateway
Ejecuta ./server.sh. El comando inicia el gateway y la interfaz web, y después muestra la dirección que debes abrir en el navegador. Utiliza ./server.sh status para inspeccionar el servicio más adelante.
| Etapa de configuración | Comando o acción | Resultado esperado |
|---|---|---|
| Dependencias | pnpm install | Instala los paquetes del proyecto |
| Compilación de la aplicación | pnpm build | Compila la aplicación principal |
| Compilación de la interfaz | pnpm ui:build | Compila la interfaz web |
| Sesión del navegador | ./start-chrome-debug.sh | Abre el entorno de depuración de Chrome |
| Autenticación | ./onboard.sh webauth | Crea la configuración de autenticación del proveedor |
| Gateway | ./server.sh | Inicia el gateway HTTP local y la interfaz web |
Configura primero DeepSeek, Qwen u otro único proveedor. Confirma que /models muestra el proveedor y que una solicitud de chat básica funciona antes de añadir más sesiones del navegador.
Uso y configuración del gateway
Una vez que el gateway esté en ejecución, la interfaz web es el lugar más sencillo para probar los modelos configurados. La CLI/TUI está disponible mediante node openclaw.mjs tui, mientras que las integraciones locales pueden enviar solicitudes al endpoint HTTP utilizando el token del gateway definido en la configuración.
La configuración de ejemplo predeterminada utiliza el puerto 3001 y autenticación del gateway basada en tokens. Mantén este token separado de las cookies del proveedor y de las credenciales bearer. Protegen límites diferentes: el token del gateway controla el acceso a la API local, mientras que las credenciales del proveedor autorizan las sesiones web.
curl \
-H "Authorization: Bearer YOUR_GATEWAY_TOKEN" \
-H "Content-Type: application/json" \
-d '{
"model": "deepseek-web/deepseek-chat",
"messages": [{"role": "user", "content": "Hello!"}]
}'
| Interfaz | Método de acceso | Mejor uso |
|---|---|---|
| Interfaz web | Abre la URL mostrada por ./server.sh | Chat diario y cambio de modelos |
| CLI/TUI | node openclaw.mjs tui | Interacción desde la terminal |
| API HTTP | Solicitud al gateway local con token bearer | Scripts e integraciones compatibles |
| Catálogo de modelos | /models | Confirmar los proveedores y alias configurados |
| Selector de modelos | /model | Cambiar el proveedor o modelo activo |
La llamada de herramientas está diseñada para activarse cuando un prompt sugiere una acción como buscar, obtener, leer, escribir, enviar mensajes o ejecutar un comando local. Las restricciones del espacio de trabajo se controlan mediante el espacio de trabajo del agente configurado, así que mantén ese directorio estrictamente delimitado.
Solo los proveedores completados mediante ./onboard.sh webauth se escriben en la configuración y se muestran en /models. Un proveedor puede ser compatible con el proyecto, pero no aparecer en tu catálogo local hasta que se complete la incorporación.
Seguridad, resolución de problemas y mantenimiento
La automatización autenticada mediante el navegador requiere gestionar las credenciales con cuidado. Las cookies y los tokens bearer se almacenan en archivos de autenticación locales, incluida el área de estado local del proyecto. Nunca confirmes esos archivos en un repositorio, los pegues en informes públicos de problemas ni los compartas en capturas de pantalla.
Las sesiones web pueden caducar y los proveedores pueden imponer límites de frecuencia. Por ello, esta configuración es más adecuada para pruebas personales y cargas de trabajo moderadas que para tráfico de producción intensivo. Vuelve a autenticarte mediante el navegador cuando un proveedor deje de responder o la sesión local deje de ser válida.
Lista de comprobación de mantenimiento:
- Mantén auth.json y los directorios de estado local fuera del control de versiones
- Utiliza un espacio de trabajo con alcance limitado para el acceso del agente a los archivos
- Comprueba las sesiones de los proveedores cuando las solicitudes comiencen a fallar
- Utiliza ./server.sh status antes de reiniciar el gateway
- Ejecuta el comando doctor cuando falten directorios necesarios
| Síntoma | Acción recomendada | Limitación importante |
|---|---|---|
| Faltan directorios | Ejecuta node dist/index.mjs doctor | El comando no crea openclaw.json ni auth-profiles.json |
| Faltan archivos de autenticación | Ejecuta de nuevo ./onboard.sh webauth | Puede ser necesaria una nueva autenticación |
ERR_MODULE_NOT_FOUND | Elimina dist, dist-runtime y node_modules; vuelve a instalar y compilar | Termina con pnpm ui:build |
| Errores de discrepancia de hash | Realiza una compilación limpia | Utiliza pnpm build, no npm run build |
| Sesión web caducada | Inicia sesión de nuevo mediante Chrome y vuelve a ejecutar la incorporación | La duración de la sesión depende del proveedor |
| Problema con el gateway | Utiliza ./server.sh restart o inspecciona ./server.sh status | Confirma el puerto mostrado y el token local |
Una compilación limpia sigue esta secuencia:
rm -rf dist dist-runtime node_modules pnpm install pnpm build pnpm ui:build ./server.sh restart
Al añadir un nuevo proveedor web, la estructura del proyecto separa la autenticación, el cliente API y la gestión de streams. Por lo general, un proveedor necesita un módulo de autenticación, un cliente web, un gestor de streams y un registro en la fábrica de streams. Esta separación facilita el mantenimiento del comportamiento específico de cada proveedor.
Utiliza la automatización del navegador únicamente de las formas permitidas por cada servicio. El aviso legal del proyecto atribuye al operador la responsabilidad de cumplir los términos de terceros.
Preguntas frecuentes sobre FreeToken openclaw
Q: ¿Qué es FreeToken openclaw?
FreeToken openclaw hace referencia a un flujo de trabajo de OpenClaw autenticado mediante el navegador que conecta varios proveedores web de IA a través de un único gateway local. Reduce la dependencia de claves API adquiridas por separado, pero no elimina los límites de los proveedores, la caducidad de las sesiones ni los términos del servicio.
Q: ¿FreeToken openclaw requiere un token API?
Los proveedores web sin tokens indicados utilizan el inicio de sesión del navegador y credenciales de sesión almacenadas localmente en lugar de una clave API tradicional del proveedor. Manus aparece por separado con una clave API y una cuota gratuita, por lo que no debe considerarse la misma ruta de autenticación.
Q: ¿Qué sistemas operativos son compatibles?
macOS y Linux son compatibles directamente. Los usuarios de Windows deben utilizar WSL2 y seguir los pasos de instalación de Linux.
Q: ¿Por qué no aparece en /models un proveedor configurado?
Solo los proveedores completados mediante ./onboard.sh webauth se escriben en la configuración local de OpenClaw. Ejecuta el asistente de incorporación para ese proveedor y después vuelve a comprobar /models.
El flujo de trabajo más fiable es sencillo: compila con pnpm, autentica un proveedor, verifica /models, inicia el gateway y amplía la configuración gradualmente.