Clawd on Desk

English · 中文版 · 繁體中文 · 한국어 · 日本語

_{🌏 ¿No encuentras tu idioma? Abre un PR para añadirlo. Français, Deutsch y cualquier otro idioma son bienvenidos.}

/settings.json` (`~/.reasonix/settings.json` en macOS/Linux y `%APPDATA%\reasonix\settings.json` en Windows; instálalos desde Ajustes → Agentes o ejecuta `npm run install:reasonix-hooks`); la fase 1 controla las animaciones de ciclo de vida, herramienta, notificación, compactación y detención de subagentes, mientras las decisiones de permisos permanecen en el flujo de terminal de Reasonix - **opencode** — [integración mediante plugin](https://opencode.ai/docs/plugins) opcional a través del archivo efectivo dentro de `~/.config/opencode/` (`config.json` → `opencode.json` → `opencode.jsonc`; gana el último) (instálala desde Ajustes → Agentes o ejecuta `node hooks/opencode-install.js`); transmisión de eventos sin latencia y globos de permisos con Permitir/Siempre/Denegar. Las sesiones hijas creadas por la herramienta `task` no tienen interfaz y no participan en las animaciones visibles de varias sesiones - **MiMo Code** — [integración mediante plugin](https://opencode.ai/docs/plugins) opcional a través del archivo efectivo dentro de `~/.config/mimocode/` (`config.json` → `mimocode.json` → `mimocode.jsonc` predeterminado; gana el último; instálala desde Ajustes → Agentes o ejecuta `npm run install:mimocode-plugin`); comparte el SDK `@mimo-ai/plugin` y el comportamiento de permisos de opencode. Sus sesiones hijas de `task` tampoco tienen interfaz - **Pi** — extensión global opcional en `~/.pi/agent/extensions/clawd-on-desk` (instálala desde Ajustes → Agentes o ejecuta `npm run install:pi-extension`); actualizaciones de ciclo de vida interactivo y actividad de herramientas de solo estado, conservando el comportamiento YOLO predeterminado de Pi - **OpenClaw** — integración opcional mediante plugin y de solo estado a través de `~/.openclaw/openclaw.json` (instálala desde Ajustes → Agentes o ejecuta `npm run install:openclaw-plugin`; OpenClaw también necesita una configuración inicializada); las sesiones locales `openclaw tui --local` controlan las animaciones de Clawd, sin globos de permisos ni enfoque de terminal en la fase 1 - **Hermes Agent** — [integración mediante plugin](https://hermes-agent.org/) opcional en el directorio de plugins administrado por Hermes (instálala desde Ajustes → Agentes o ejecuta `npm run install:hermes-plugin`); admite estado, sesiones, SessionEnd, enfoque de terminal y los globos de permisos compatibles - **Qoder** — hooks de comandos opcionales y de solo estado mediante `~/.qoder/settings.json` (instálalos desde Ajustes → Agentes o ejecuta `npm run install:qoder-hooks`); la fase 1 solo controla las animaciones de Clawd: las solicitudes de permisos de Qoder se observan como notificaciones y todas las decisiones Permitir / Denegar permanecen en el flujo propio de Qoder - **QoderWork** — hooks de comandos opcionales y de solo estado mediante `~/.qoderwork/settings.json` (instálalos desde Ajustes → Agentes o ejecuta `npm run install:qoderwork-hooks`); la fase 1 controla las animaciones de Clawd y el HUD de sesiones. Los eventos de permisos de QoderWork se observan en silencio como parte del flujo de trabajo y todas las decisiones Permitir / Denegar permanecen en el flujo propio de QoderWork - **QwenWork (千问办公)** — hooks de comandos opcionales, solo mediante hooks y de solo estado, a través de `~/.QwenWorkCN/settings.json` (instálalos desde Ajustes → Agentes o ejecuta `npm run install:qwenwork-hooks`; desinstálalos con `npm run uninstall:qwenwork-hooks`); solo para escritorio macOS y Windows. [qwenwork.cn/download](https://qwenwork.cn/download) no ofrece cliente Linux, por lo que no existe emparejamiento WSL. La fase 1 controla las animaciones de Clawd y el HUD de sesiones; `PermissionRequest` / `PermissionDenied` solo se observan y se asignan a `working`, stdout del hook siempre es `{}` y Clawd nunca produce Permitir / Denegar: el flujo de permisos nativo de QwenWork sigue siendo el único que decide. No hay recuperación al inicio: que el proceso de escritorio siga abierto no significa que haya un turno en curso - **DeepSeek Harness** — integración experimental y exclusiva del perfil web mediante un plugin DSH administrado por Clawd dentro del proceso. Los eventos públicos de sesión controlan el estado de Clawd con orden por sesión, y las llamadas públicas bloqueantes `approval/request` pueden mostrar un globo Permitir una vez / Denegar; una ausencia de decisión siempre vuelve al respondedor web nativo de DSH. `ask_user_question` permanece completamente nativo de DSH y Clawd nunca lee el almacenamiento de proyección de DSH. Consulta la [guía de DeepSeek Harness](docs/guides/dsh-setup.md) - **Convivencia de varios agentes** — ejecuta todos los agentes al mismo tiempo; Clawd sigue cada sesión de forma independiente ### Animaciones e interacción - **Estado en tiempo real** — los hooks de los agentes y el sondeo de logs controlan automáticamente las animaciones de Clawd - **12 estados animados** — inactivo, pensando, escribiendo, construyendo, movimiento de subagente, malabares con varios subagentes, error, feliz, notificación, compactación, transporte y sueño - **Importación de Codex Pet** — importa paquetes zip de Codex Pet desde `Ajustes…` → `Tema`; Clawd adapta las animaciones de su atlas a temas administrados - **Seguimiento ocular** — Clawd sigue el cursor mientras está inactivo, inclinando el cuerpo y estirando la sombra - **Secuencia de sueño** — bosteza, cabecea, se desploma y se duerme tras 60 segundos de inactividad; mover el mouse activa una animación de despertar sobresaltado - **Reacciones a clics** — doble clic para darle un toque y 4 clics para que se agite - **Arrastre desde cualquier estado** — agarra a Clawd cuando quieras (Pointer Capture evita que se suelte al moverlo rápido) y suéltalo para continuar - **Modo mini** — arrástralo al borde derecho o haz clic derecho en «Modo mini»; Clawd se esconde en el borde, asoma al pasar el cursor, muestra alertas y celebraciones mini y usa transiciones de salto parabólicas ### Globo de permisos - **Revisión de permisos en la aplicación** — cuando una integración con permisos envía una solicitud compatible, Clawd puede mostrar una tarjeta flotante en lugar de esperar en la terminal; los agentes de solo estado conservan su flujo de permisos nativo - **Permitir / denegar / acciones propias del agente** — aprueba o rechaza con un clic, además de usar reglas de permisos o acciones `Always` cuando el agente de origen las admite - **Modos de gestión de permisos** — elige **Preguntar siempre**, **Solo preguntas** con confirmación (solicitudes con forma de herramienta de agentes explícitamente compatibles) o **Aprobar automáticamente**. La aprobación automática gestiona cualquier solicitud que el adaptador marque como apta para automatización —incluidos nombres de solicitudes no vacíos y no reconocidos de Claude/Qwen—, pero los nombres ausentes, las formas de decisión no compatibles y las preguntas o planes de CodeBuddy vuelven al flujo nativo. El modo se rebaja tras reiniciar, y cada sesión activa apta puede elegir de forma independiente Preguntar siempre o solo herramientas. Consulta la [guía de configuración](docs/guides/setup-guide.md#permission-handling-automation) - **Aprobación remota opcional** — Telegram y Feishu/Lark pueden reflejar solicitudes pendientes aptas mientras el globo local sigue disponible. Un fallo del canal no produce ninguna decisión remota ni una denegación: la solicitud de escritorio permanece pendiente, y las solicitudes solo remotas vuelven al agente únicamente después de que todos los clientes disponibles regresen sin decisión - **Atajos globales** — `Ctrl+Shift+Y` permite y `Ctrl+Shift+N` deniega el globo de permisos más reciente (solo se registran mientras hay globos visibles) - **Diseño apilado** — varias solicitudes de permisos se apilan hacia arriba desde la esquina inferior derecha - **Cierre automático** — si respondes primero en la terminal, el globo desaparece automáticamente - **Interruptor por agente** — abre `Ajustes…` → `Agentes`, elige un agente y desactiva `Mostrar globos emergentes` para conservar las solicitudes en la terminal/TUI del propio agente ### Notificaciones remotas - **Telegram / Feishu (Lark)** — aprobación remota interactiva: envía solicitudes de permisos al teléfono y permite aprobarlas o denegarlas sin tocar el escritorio - **Slack** — **solo notificaciones**: envía tareas **terminadas**, **errores** y **solicitudes de permisos** mediante un Incoming Webhook de Slack (o, de forma opcional, un token de bot `xoxb-` y un id. de canal) como tarjetas Block Kit. Slack no puede aprobar ni denegar en esta versión: los mensajes de permisos son avisos y la decisión se toma en la aplicación de escritorio. Configúralo junto a Telegram/Feishu en los canales de aprobación remota. Los secretos se guardan localmente en un archivo de entorno fuera de las preferencias (`0600` en macOS/Linux; en Windows se usa la ACL de AppData), y el canal se degrada de forma segura si no está configurado o no tiene conexión. Los mensajes pueden incluir el título de la sesión, la carpeta y el nombre del equipo, por lo que se recomienda un **canal privado**. Consulta [slack-notifications.md](docs/guides/slack-notifications.md) ### Información de sesiones - **Seguimiento de varias sesiones** — las sesiones de todos los agentes se resuelven al estado de mayor prioridad - **Detección de subagentes** — movimiento con auriculares para 1 subagente y malabares con tres pelotas para 2 o más - **Panel de sesiones + HUD** — haz clic derecho o usa la bandeja → `Abrir panel` para revisar sesiones activas, eventos recientes y alias, y saltar a una terminal; un HUD compacto junto a Clawd mantiene visibles las sesiones activas - **Cuota de suscripción de un vistazo** — los anillos Orbit opcionales junto a la mascota y las barras detalladas del panel muestran las ventanas de cuota informadas por los agentes compatibles. La recopilación local de Claude está desactivada de forma predeterminada y usa el [payload oficial `rate_limits` de la statusline](https://code.claude.com/docs/en/statusline) de Claude Code; no realiza ninguna solicitud adicional a Anthropic. Consulta las [notas sobre flujo de datos y propiedad](docs/guides/setup-guide.md#claude-code-subscription-quota-official-status-line-not-scraping). - **Enfoque de terminal** — las acciones del panel/HUD saltan a la ventana de terminal de una sesión concreta; los estados de notificación o atención enfocan automáticamente la terminal correspondiente - **Detección de procesos activos** — detecta los procesos compatibles que terminaron o fallaron y limpia las sesiones huérfanas - **Recuperación al inicio** — si Clawd se reinicia mientras sigue ejecutándose algún agente compatible, permanece despierto en lugar de dormirse ### Aplicación móvil complementaria (PWA) - **Espejo en vivo en tu teléfono** — activa `Ajustes…` → `Móvil / PWA` y abre en el teléfono la URL de emparejamiento; la aplicación web Clawd Mobile muestra en tiempo real las sesiones de tus agentes y sus estados - **Solo lectura por diseño** — el puente LAN solo transmite el estado; nada de la PWA puede modificar tu equipo (la aprobación desde la PWA LAN está en la hoja de ruta; Telegram y Feishu/Lark son canales compatibles independientes) - **Solo LAN y protegido por token** — el emparejamiento requiere un token, los tokens rotan automáticamente con un periodo de gracia y el acceso puede regenerarse o restablecerse con un clic - **Instalable** — es una PWA: añádela a la pantalla de inicio para usarla como una aplicación > La línea de la aplicación móvil complementaria —desde el primer prototipo hasta la rotación de tokens— está construida y liderada por el colaborador principal [@Bynlk](https://github.com/Bynlk), que también mantiene [clawd-on-mobile](https://github.com/Bynlk/clawd-on-mobile), un fork hermano con una aplicación Android nativa. ### Sistema - **Clic transparente** — las áreas transparentes pasan los clics a las ventanas inferiores; solo el cuerpo de Clawd es interactivo - **Memoria de posición** — Clawd recuerda dónde lo dejaste después de reiniciar (incluido el modo mini) - **Bloqueo de instancia única** — evita ventanas duplicadas de Clawd - **Inicio automático** — el hook SessionStart de Claude Code puede iniciar Clawd automáticamente si no está en ejecución - **No molestar** — haz clic derecho o usa la bandeja para entrar en modo de sueño; todos los eventos de hooks quedan silenciados hasta que despiertes a Clawd. Los globos de permisos se suprimen durante No molestar: Codex, opencode y MiMo Code vuelven a sus solicitudes nativas, mientras Claude Code y CodeBuddy vuelven a su flujo de permisos integrado. WorkBuddy usa solo Estado + Notificación; Antigravity y Pi son integraciones de solo estado. - **Efectos de sonido** — avisos de audio breves al terminar tareas y recibir solicitudes de permisos (se activan desde la bandeja o Ajustes; espera de 10 s y silencio automático durante No molestar) - **Bandeja del sistema** — modo No molestar, inicio automático y búsqueda de actualizaciones - **i18n** — interfaz en inglés, chino simplificado, chino tradicional, coreano, japonés, portugués de Brasil y español; cambia el idioma en Ajustes → General - **Actualización automática** — busca releases de GitHub; Windows instala actualizaciones NSIS al salir y macOS/Linux ejecutan `git pull` + reinicio cuando se usa un repositorio clonado ## Animaciones

Inactivo	Burbuja de pensamiento	Escribiendo	Construyendo	1 subagente	2+ subagentes
Calico inactivo	Calico pensando	Calico escribiendo	Calico construyendo	Calico haciendo malabares	Calico dirigiendo
Cloudling inactivo	Cloudling pensando	Cloudling escribiendo	Cloudling construyendo	Cloudling haciendo malabares	Cloudling dirigiendo

Asignación completa de eventos a estados, modo mini y reacciones a clics: **[docs/guides/state-mapping.md](docs/guides/state-mapping.md)** ## Varias pantallas Clawd se adapta a configuraciones con varios monitores: el tamaño proporcional usa la pantalla donde se inicia Clawd, los monitores verticales reciben un aumento limitado para que la mascota siga viéndose bien en pantallas altas y estrechas, y puedes arrastrar a Clawd entre pantallas.

_{¿Quieres ver el comportamiento real con varios monitores? Mira el video de demostración de este repositorio.}

## Inicio rápido Para un uso normal, descarga el instalador precompilado más reciente desde **[GitHub Releases](https://github.com/rullerzhou-afk/clawd-on-desk/releases/latest)**: - **Windows**: `Clawd-on-Desk-Setup--x64.exe` o `Clawd-on-Desk-Setup--arm64.exe` - **macOS**: `.dmg` - **Linux**: `.AppImage` o `.deb` Inicia Clawd después de instalarlo. Las instalaciones nuevas solo sincronizan automáticamente Claude Code y Codex; instala las demás integraciones locales desde **Ajustes → Agentes** cuando las necesites. Ejecuta desde el código fuente únicamente si vas a contribuir, probar código aún no publicado o depurar integraciones. Las instalaciones desde el código fuente descargan Electron y herramientas de compilación, y pueden crear un árbol `node_modules` grande. ```bash # Clona el repositorio git clone https://github.com/rullerzhou-afk/clawd-on-desk.git cd clawd-on-desk # Instala las dependencias npm install # Inicia Clawd (registra automáticamente los hooks de Claude Code y Codex) npm start ``` **Claude Code** y **Codex CLI** funcionan directamente con hooks registrados automáticamente. Para **Copilot CLI**, **Gemini CLI**, **Antigravity CLI (agy)**, **Cursor Agent**, **CodeBuddy**, **WorkBuddy**, **Kiro CLI**, **Kimi Code CLI (Kimi-CLI)**, **Qwen Code**, **ZCode**, **CodeWhale**, **opencode**, **MiMo Code**, **Pi**, **OpenClaw**, **Hermes Agent**, **Qoder**, **QoderWork**, **QwenWork (千问办公)**, **Reasonix CLI** y **DeepSeek Harness**, instala primero la integración desde **Ajustes → Agentes**; Clawd la mantendrá sincronizada mientras siga activada. También incluye SSH remoto, WSL y notas específicas de cada plataforma (macOS / Linux): **[docs/guides/setup-guide.md](docs/guides/setup-guide.md)** ¿Quieres ejecutar Claude Code / Codex CLI en un servidor remoto y mostrar el estado y los globos de permisos en tu Clawd local? Usa **Ajustes → Hosts SSH → Desplegar / Reparar hooks** dentro de la aplicación. Guía completa, límite de aislamiento en servidores compartidos, alcance de Doctor y preguntas frecuentes: **[docs/guides/guide-remote-ssh.md](docs/guides/guide-remote-ssh.md)** Para consultar el estado oficial de `Codex + WSL`, el alcance actual de Clawd y por qué es fácil interpretarlo mal, consulta: **[docs/guides/codex-wsl-clarification.md](docs/guides/codex-wsl-clarification.md)** ## Limitaciones conocidas Algunos agentes tienen funciones incompletas (sin globo de permisos, latencia de sondeo o sin enfoque de terminal). Consulta la tabla completa: **[docs/guides/known-limitations.md](docs/guides/known-limitations.md)** ## Temas personalizados Clawd admite temas personalizados: sustituye el cangrejo predeterminado por tu propio personaje y animaciones. Si ya tienes un paquete Codex Pet, importa su zip desde `Ajustes…` → `Tema` → `Importar zip de mascota`; Clawd convierte automáticamente el atlas en un tema administrado. **Inicio rápido:** 1. Crea la estructura de un tema: ```bash node scripts/create-theme.js my-theme # o npm run create-theme -- my-theme ``` También funciona sin argumentos: crea la siguiente estructura `my-theme` disponible en tu directorio de temas de usuario. 2. Edita `theme.json` y crea tus recursos (SVG, GIF, APNG, WebP, PNG, JPG o JPEG) 3. Reinicia Clawd o abre `Ajustes…` → `Tema` → selecciona tu tema **Tema mínimo viable:** 1 SVG (inactividad con seguimiento ocular) + 7 archivos GIF/APNG (pensando, trabajando, error, feliz, notificación, durmiendo y despertando). Puedes desactivar el seguimiento ocular para usar cualquier formato en todos los estados. Valida tu tema antes de distribuirlo: ```bash node scripts/validate-theme.js path/to/your-theme ``` Las tarjetas de temas en `Ajustes…` → `Tema` muestran insignias de capacidades como `Inactividad con seguimiento`, `Tema estático`, `Mini`, `Sueño directo` y `Sin reacciones`, para que los usuarios sepan qué admite cada tema antes de cambiar. Consulta [docs/guides/guide-theme-creation.md](docs/guides/guide-theme-creation.md) para ver la guía completa de creación con rutas por niveles (principiante → avanzado), referencia de campos de `theme.json` y pautas para los recursos. > Los archivos SVG de terceros se sanitizan automáticamente por seguridad. ### Hoja de ruta Algunas ideas que nos gustaría explorar en el futuro: - Enfoque de la terminal de Codex mediante búsqueda en el árbol de procesos a partir del PID de `codex.exe` - Registro de temas y descarga dentro de la aplicación - Script de desinstalación de hooks para eliminar la aplicación limpiamente - Aplicación móvil PWA por LAN: aprobación de permisos desde el navegador (en desarrollo, liderada por [@Bynlk](https://github.com/Bynlk)); Telegram y Feishu/Lark son canales de aprobación compatibles independientes ## Contribuir Clawd on Desk es un proyecto impulsado por la comunidad. Los informes de errores, las ideas de funciones y los pull requests son bienvenidos: abre un [issue](https://github.com/rullerzhou-afk/clawd-on-desk/issues) para conversar o envía directamente un PR. ### Responsables del mantenimiento

@rullerzhou-afk 鹿鹿 · creadora

@YOIMIYA66 responsable del mantenimiento

@Bynlk colaborador principal · Móvil / PWA

### Colaboradores Gracias a todas las personas que han ayudado a mejorar Clawd:

PixelCookie-zyf	yujiachen-y	AooooooZzzz	purefkh	Tobeabellwether	Jasonhonghh	crashchen
hongbigtou	InTimmyDate	NeizhiTouhu	xu3stones-cmd	androidZzT	Ye-0413	WanfengzzZ
TaoXieSZ	ssly	stickycandy	Rladmsrl	YOIMIYA66	Kevin7Qi	sefuzhou770801-hub
Tonic-Jin	seoki180	sophie-haynes	PeterShanxin	CHIANGANGSTER	JaeHyeon-KAIST	hhhzxyhhh
TVpoet	zeus6768	anhtrinh919	tomaioo	v-avuso	livlign	tongguang2
Ziy1-Tan	tatsuyanakanogaroinc	yeonhub	joshua-wu	nmsn	sunnysonx	YuChenYunn
jhseo-b	Hwasowl	XiangZheng2002	keiyo118	pan93412	taehwanis	linnin233
xiyouMc	Bynlk	zxypro1	NeroAyase	divergentD	Ne9roni	QingXB
藤知	Tsdsj	godlockin	sLingli	ustin-star	cod3hulk	lxgxhsy
rebootcrab-blip	zhaoxv210	serenNan	IatomicreactorI	quantai1314	Git-creat7	undownding
chrono-meta	Yike-Ye	xiaoshidefeng	yanguibao1997	JasonZH6600	V1staz	royhuang91
Schlaflied	KaiC5504	jiaxuan1101	kkirito16	200780381	Dxy2326	lurui1997
JesmonX	chen86860	LinYsssss	He-wei-gui	liugou27	YOOGOMJA	anupamme
anthonyonazure	weed33834	arismarioneves	wang4433	shengmai-justin	aaronWool	Zamaniego
CheeseAgent	RS-Nocsi	Cobb04

## Agradecimientos - Referencia del pixel art de Clawd tomada de [clawd-tank](https://github.com/marciogranzotto/clawd-tank), de [@marciogranzotto](https://github.com/marciogranzotto) - Compartido en la comunidad [LINUX DO](https://linux.do/) ## Licencia El código fuente se distribuye bajo la [GNU Affero General Public License v3.0](LICENSE) (AGPL-3.0). **Las ilustraciones y los recursos de temas incluidos (entre ellos `assets/` y `themes/*/assets/`) NO están cubiertos por AGPL-3.0.** Sus respectivos titulares conservan todos los derechos. Consulta [assets/LICENSE](assets/LICENSE) y los avisos siguientes para obtener más información. - El personaje **Clawd** es propiedad de [Anthropic](https://www.anthropic.com). Este es un proyecto no oficial creado por fans, sin afiliación ni respaldo de Anthropic. - Ilustración del **gato Calico (三花猫)** por 鹿鹿 ([@rullerzhou-afk](https://github.com/rullerzhou-afk)). Todos los derechos reservados. - Ilustración de **Cloudling (云宝)** por 鹿鹿 ([@rullerzhou-afk](https://github.com/rullerzhou-afk)). Todos los derechos reservados. La dirección visual de Cloudling incluye un homenaje al logotipo de OpenAI Codex; las marcas Codex/OpenAI siguen siendo propiedad de OpenAI y este proyecto no está afiliado ni respaldado por OpenAI. - **Contribuciones de terceros**: los respectivos artistas conservan los derechos de autor. **Sin criptomonedas.** Este proyecto no tiene token, moneda, NFT ni airdrop, y no está afiliado a ningún proyecto de criptomonedas.