Aplicativo OpenClaw macOS Companion: Guia da barra de menu

Introdução

Embora o OpenClaw seja executado principalmente como uma ferramenta de linha de comando que se conecta a aplicativos de bate-papo, os usuários do macOS têm acesso a um poderoso aplicativo complementar que fica na sua barra de menus. Este aplicativo macOS nativo fornece acesso rápido ao OpenClaw, notificações na área de trabalho e integração perfeita com o sistema do seu Mac.

O aplicativo complementar complementa a versão CLI, oferecendo o melhor dos dois mundos: integração de aplicativo de bate-papo e conveniência nativa do macOS. Este guia cobre tudo o que você precisa saber sobre como instalar, configurar e usar o aplicativo complementar OpenClaw macOS.

O que é o aplicativo complementar?

O aplicativo complementar OpenClaw macOS é um aplicativo nativo que:

• Vive na sua barra de menu — Acesso rápido sem abrir um terminal
• Fornece notificações na área de trabalho — Receba alertas de mensagens importantes
• Oferece interface de consulta rápida — Faça perguntas sem abrir aplicativos de bate-papo
• Integra-se com macOS — Funciona com serviços e atalhos do sistema
• Complementa CLI — Funciona junto com a versão de linha de comando

Pense nele como um complemento de desktop para sua instância OpenClaw baseada em bate-papo, fornecendo integração nativa do macOS e recursos convenientes.

Instalação

Método 1: download direto

1. Visite a página de lançamentos do OpenClaw
2. Baixe o arquivo .dmg mais recente para macOS
3. Abra o arquivo .dmg baixado
4. Arraste o OpenClaw para a pasta Aplicativos
5. Inicie a partir de aplicativos ou Spotlight

Método 2: barril de fermentação caseira

brew install --cask openclaw

Método 3: Construir a partir da fonte

Se você deseja a versão de desenvolvimento mais recente:

git clone https://github.com/openclaw/openclaw.git
cd openclaw/companion-app
npm install
npm run build
npm run dist

Configuração do primeiro lançamento

Ao iniciar o aplicativo complementar pela primeira vez:

Etapa 1: Conecte-se à sua instância do OpenClaw

O aplicativo precisa se conectar à sua instância CLI do OpenClaw em execução:

1. Iniciar OpenClaw CLI — Certifique-se de que sua instância CLI esteja em execução
2. Insira o endpoint da API — O padrão é http://localhost:3000
3. Verificar conexão — O aplicativo testará a conexão

Etapa 2: Configurar preferências

Acesse as preferências através do ícone da barra de menu:

• Geral — Comportamento de inicialização, notificações
• Aparência — Tema, estilo do ícone
• Avançado — endpoints de API, depuração

Etapa 3: conceder permissões

O aplicativo pode solicitar:

• Acessibilidade — Para integração de sistemas
• Notificações — Para alertas na área de trabalho
• Acesso total ao disco — Para operações de arquivo (se necessário)

Conceda-os em Configurações do sistema > Privacidade e segurança.

Recursos da barra de menu

Menu de acesso rápido

Clique no ícone da barra de menu para acessar:

• Consulta Rápida — Faça perguntas diretamente
• Conversas recentes — Veja o histórico de bate-papo
• Habilidades — Acesse habilidades instaladas
• Configurações — Configurar preferências
• Status — Verifique o status da conexão

Indicadores de status

O ícone da barra de menu mostra:

• Verde — Conectado e pronto
• Amarelo — Conectado, mas com avisos
• Vermelho — Desconectado ou erro
• Cinza — Iniciando

Atalhos de teclado

Configure atalhos globais:

• Cmd+Shift+C — Abrir consulta rápida
• Cmd+Shift+A — Alternar assistente
• Cmd+Shift+S — Mostrar status

Interface de consulta rápida

O recurso de consulta rápida do aplicativo complementar permite interagir com o OpenClaw sem abrir o WhatsApp, Telegram ou Discord.

Abrindo Consulta Rápida

1. Clique no ícone da barra de menu
2. Selecione “Consulta Rápida” ou use o atalho do teclado
3. Digite sua pergunta
4. Pressione Enter para enviar

Casos de uso

Informações rápidas:

• “O que está na minha agenda hoje?”
• “Verifique meu e-mail para mensagens urgentes”
• “Qual é o tempo?”

Ações rápidas:

• “Adicionar tarefa: revisar proposta de projeto”
• “Definir lembrete: ligue para Sarah às 15h”
• “Verifique o status de relações públicas do GitHub”Consultas do sistema:
• “Quais arquivos eu modifiquei hoje?”
• “Mostre-me comandos de terminal recentes”
• “Qual é o status do meu sistema?”

Notificações na área de trabalho

O aplicativo complementar pode enviar notificações na área de trabalho para:

Alertas de mensagens

Seja notificado quando o OpenClaw receber mensagens em:

• WhatsApp
• Telegrama
• Discórdia
• Outras plataformas conectadas

Lembretes de tarefas

Configure lembretes que acionam notificações na área de trabalho:

• Eventos do calendário
• Prazos de tarefas
• Lembretes personalizados

Eventos do sistema

Notificações para:

• Mudanças de status do OpenClaw
• Resultados de execução de habilidades
• Alertas de erro
• Notificações de atualização

Configurando notificações

1. Abra Preferências
2. Vá para a seção Notificações
3. Habilitar/desabilitar tipos de notificação
4. Personalize sons de notificação
5. Defina o horário de não perturbe

Integração com CLI

O aplicativo complementar funciona junto com sua instância CLI:

Configuração compartilhada

Ambos usam o mesmo:

• Terminais de API
• Autenticação
• Habilidades e integrações
• Memória e contexto

Recursos complementares

CLI fornece:

• Pontes de aplicativos de bate-papo
• Acesso total à linha de comando
• Capacidades do servidor
• Configuração avançada

O aplicativo complementar oferece:

• Integração nativa do macOS
• Notificações na área de trabalho
• Interface de acesso rápido
• Serviços do sistema

Executando os dois juntos

Você pode executar os dois simultaneamente:

1. Inicie a instância CLI: npm start
2. Inicie o aplicativo complementar
3. Ambos se conectam ao mesmo back-end
4. Use a interface que for conveniente

Recursos avançados

Integração de serviços do sistema

O aplicativo complementar pode ser integrado aos serviços macOS:

Seleção de texto:

1. Selecione texto em qualquer aplicativo
2. Clique com o botão direito → Serviços → “Pergunte ao OpenClaw”
3. Obtenha resposta de IA na notificação

Operações de arquivo:

1. Selecione arquivos no Finder
2. Clique com o botão direito → Serviços → “Analisar com OpenClaw”
3. Obtenha análise de arquivo

Integração Spotlight

Procure comandos OpenClaw via Spotlight:

• Digite “OpenClaw” para abrir o aplicativo
• Procure por “Ask OpenClaw” para acionar a consulta
• Acesso rápido a conversas recentes

Integração de aplicativos de atalhos

Crie automações nos atalhos do macOS:

1. Abra o aplicativo Atalhos
2. Crie um novo atalho
3. Adicione a ação “Executar Shell Script”
4. Chame os terminais da API OpenClaw
5. Acione o Siri ou widgets

Personalização

Aparência

Personalize a aparência do aplicativo:

• Estilo do ícone — Escolha entre os ícones disponíveis
• Tema — Claro, escuro ou automático
• Estilo de menu — Compacto ou expandido

Comportamento

Configure o comportamento do aplicativo:

• Iniciar no Login — Iniciar automaticamente
• Ocultar quando inativo — Minimiza o ícone da barra de menu
• Sair do comportamento — Continue correndo ou saia com o aplicativo

Configurações Avançadas

Opções de usuário avançado:

• Endpoint de API personalizado — Aponta para instância remota
• Modo de depuração — Habilite o registro detalhado
• Configurações de proxy — Configurar proxy de rede
• Canal de atualização — Versões beta ou estáveis

Solução de problemas

O aplicativo não conecta

Problema: o aplicativo complementar não consegue se conectar à CLI

Soluções:

1. Verifique se a CLI está em execução: ps aux | grep openclaw
2. Verifique se o endpoint da API corresponde à porta CLI
3. Verifique se o firewall não está bloqueando o host local
4. Verifique se há erros nos logs da CLI

Notificações não funcionam

Problema: As notificações na área de trabalho não aparecem

Soluções:

1. Verifique as configurações de notificação do macOS
2. Verifique se o aplicativo tem permissão de notificação
3. Verifique o status Não perturbe
4. Reinicie o aplicativo

Ícone da barra de menu ausente

Problema: O ícone não aparece na barra de menu

Soluções:

1. Verifique se o ícone está oculto (o macOS pode ocultar os ícones)
2. Redefinir barra de menu: killall SystemUIServer
3. Reinstale o aplicativo
4. Verifique a compatibilidade do macOS

Problemas de desempenho

Problema: O aplicativo está lento ou não respondeSoluções:

1. Verifique os recursos do sistema
2. Reduza a frequência de notificação
3. Limpe o cache do aplicativo
4. Reinicie o aplicativo

Melhores práticas

Fluxo de trabalho diário

1. Iniciar CLI — Execute o OpenClaw CLI na inicialização
2. Iniciar Companion — Mantenha o aplicativo complementar em execução
3. Use a Consulta Rápida — Para perguntas rápidas
4. Use aplicativos de bate-papo — Para conversas mais longas
5. Monitore notificações — Mantenha-se informado

Gerenciamento de recursos

• Monitorar o uso de memória
• Feche o aplicativo complementar se não for necessário
• Use o modo somente CLI para servidores
• Otimizar configurações de notificação

Segurança

• Mantenha o aplicativo atualizado
• Use endpoints de API seguros
• Não exponha a API publicamente
• Revise as permissões de notificação

Comparação: aplicativo complementar vs CLI

Quando usar o aplicativo complementar

• Consultas rápidas na área de trabalho
• Notificações na área de trabalho
• integração do sistema macOS
• Monitoramento visual do status

Quando usar apenas CLI

• Implantações de servidores
• Configurações sem cabeça
• Configuração avançada
• Sistemas com recursos limitados

Usando ambos

O melhor dos dois mundos:

• CLI para funcionalidade principal
• Aplicativo complementar para maior conveniência
• Back-end e configuração compartilhados
• Métodos de acesso flexíveis

Melhorias Futuras

O aplicativo complementar continua a evoluir com recursos como:

• Suporte de widget para macOS
• Integração Siri
• Mais serviços do sistema
• Notificações aprimoradas
• Melhor desempenho

Conclusão

O aplicativo complementar OpenClaw macOS fornece integração nativa de desktop que complementa perfeitamente a versão CLI. Se você deseja consultas rápidas, notificações na área de trabalho ou integração de sistema, o aplicativo complementar aprimora sua experiência OpenClaw no macOS.

Instale-o junto com sua instância CLI para obter a melhor experiência. Use a consulta rápida para perguntas rápidas, conte com notificações para alertas importantes e aproveite a integração perfeita do macOS.

Para obter mais informações, consulte nosso guia de instalação e configuração específica do macOS. Se você tiver dúvidas, visite nossas FAQ ou explore outros tutoriais.