Um utilitário de segundo plano automatizado para macOS que garante que seus tokens de acesso do Claude Code CLI nunca expirem, monitorando-os e renovando-os via Keychain.
Instalar e Baixar
1. ClawHub CLI
A maneira mais rápida de instalar uma habilidade diretamente do registro.
npx clawhub@latest install claude-oauth-refresher
2. Instalação Manual
Copie a pasta da habilidade para um desses locais
~/.openclaw/skills/ <project>/skills/ Prioridade: Espaço de Trabalho > Local > Integrado
3. Instalação do Prompt
Copie este prompt para o OpenClaw para instalá-lo automaticamente.
Ajude-me a instalar o claude-oauth-refresher usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).
Prefere baixar?
Obtenha os arquivos originais da habilidade em um arquivo ZIP.
O que é Claude OAuth Refresher?
O Claude OAuth Refresher é uma ferramenta de automação robusta projetada especificamente para desenvolvedores que utilizam o Claude Code CLI no macOS. Ao aproveitar o Keychain nativo do macOS para armazenamento seguro de credenciais, esta habilidade elimina o trabalho manual de autenticar novamente suas sessões de IA. Como uma parte central do ecossistema Openclaw Skills, ele fornece uma conexão persistente com os modelos da Anthropic, garantindo que agentes de segundo plano e sessões de terminal de longa duração permaneçam autenticados sem interrupção.
A habilidade opera como um serviço de segundo plano leve que verifica proativamente a validade do seu token. Ela se integra à sua pilha de notificações existente — incluindo Telegram, Slack e Discord — para mantê-lo informado sobre seu status de autenticação. Esteja você executando fluxos de trabalho autônomos complexos ou tarefas diárias de codificação, este utilitário fornece a confiabilidade necessária para uma experiência de desenvolvedor sem interrupções no Openclaw Skills.
Casos de uso do Claude OAuth Refresher
- Manter um estado de login persistente 24/7 para o Claude Code CLI sem intervenção manual.
- Evitar interrupções no fluxo de trabalho causadas por tokens OAuth expirados durante longas sessões de codificação.
- Receber notificações instantâneas em várias plataformas, como Slack ou WhatsApp, quando os tokens forem renovados.
- Gerenciar credenciais de IA com segurança usando a integração com o Keychain do macOS em vez de arquivos de texto simples.
- Monitorar a integridade da autenticação para ambientes de agentes headless ou automatizados que executam o Openclaw Skills.
Como o Claude OAuth Refresher funciona
- O script de instalação configura um serviço launchd para executar a lógica de atualização a cada duas horas.
- Após a execução, o script analisa os perfis de autenticação locais do Claude para determinar o timestamp de expiração do token atual.
- Se o token estiver configurado para expirar dentro da janela de buffer definida, a habilidade inicia uma sequência de atualização.
- Ele busca com segurança o token de atualização necessário no Keychain do macOS.
- Uma solicitação é enviada aos endpoints oficiais do Claude OAuth para gerar um novo par de tokens de acesso e atualização.
- O ambiente local é atualizado com as novas credenciais, e uma notificação de sucesso ou falha é enviada através do canal de comunicação escolhido no Openclaw Skills.
Configuração do Claude OAuth Refresher
Para instalar o Claude OAuth Refresher, certifique-se de que você já fez login no Claude CLI em sua máquina macOS. Siga estas etapas:
cd ~/clawd/skills/claude-oauth-refresher
./install.sh
O instalador irá guiá-lo interativamente através da configuração de notificações e verificará as dependências do seu sistema. Para confirmar se sua configuração está correta, você pode executar o utilitário de verificação:
./verify-setup.sh
Esquema de Dados e Taxonomia de Claude OAuth Refresher
A habilidade organiza sua operação por meio de um arquivo de configuração central e caminhos padrão do macOS:
| Componente | Caminho / Detalhe | Finalidade |
|---|---|---|
| Configuração | claude-oauth-refresh-config.json |
Define buffers de atualização e alvos de notificação. |
| Logs | ~/clawd/logs/claude-oauth-refresh.log |
Armazena um histórico detalhado de tentativas de atualização e erros. |
| Perfis de Autenticação | ~/.config/claude/auth-profiles.json |
Gerenciado pela habilidade para armazenar tokens de acesso ativos. |
| Armazenamento Seguro | macOS Keychain | Usado para armazenar o token de atualização persistente com segurança. |
Recursos avançados do Claude OAuth Refresher
- Gerenciamento de Linguagem Natural: Use o Clawdbot para ativar, desativar ou verificar as configurações de notificação usando comandos simples de voz ou texto.
- Detecção Automática Inteligente: O instalador extrai automaticamente IDs de chat e alvos de API da sua configuração global existente do Openclaw Skills.
- Alertas Multicanal: Suporte para Telegram, Slack, Discord, WhatsApp, iMessage e Signal para notificações de falha de alta prioridade.
- Buffers Customizáveis: Ajuste a janela de renovação para atualizar os tokens de minutos a horas antes que eles realmente expirem.
- Diagnóstico de Erros: Mensagens de falha detalhadas que incluem etapas específicas de solução de problemas com base no erro exato de HTTP ou Keychain encontrado.
SKILL.md
Carregamento
Habilidades relacionadas do Openclaw
Habilidade ComfyAI para Clawdbot
Uma integração local do ComfyUI para Clawdbot que permite a geração e edição de imagens de IA de alta qualidade diretamente na sua interface de chat.
Instalador DataHive
Um instalador determinístico e amigável para headless para configurar a extensão do navegador DataHive e o acesso ao dashboard.
Assistente de Voz Xiaomi MiGPT
Transforme seu alto-falante inteligente Xiaomi em um poderoso assistente de IA personalizado usando Openclaw Skills e mi-gpt.
Integração Mood Forum
Uma ferramenta abrangente de interação social para agentes de IA postarem atualizações, navegarem por feeds da comunidade e interagirem por meio de comentários e reações.
Publisher
Uma ferramenta de automação profissional que transforma especificações técnicas em documentação de alta conversão e gere o fluxo de trabalho de publicação de ponta a ponta para Openclaw Skills.
Sincronização de Favoritos do Twitter
Um mecanismo de curadoria automatizado que classifica seus favoritos do Twitter com base em interesses em evolução e entrega listas de leitura diárias personalizadas.
METADATA
Apresentou*
