PS Claw 🦞

PS Claw — Agente de IA autônomo leve com interface web estilo ChatGPT. Multi-canal (Telegram, Discord, WhatsApp) com suporte a modelos de múltiplos provedores (Claude, GPT-4, Gemini).

Fork enxuto do OpenClaw focado em leveza, facilidade de uso e sem dependências pesadas.

⚡ Início Rápido (5 minutos)

Requisitos

• Node.js v22.19+ (baixe a versão LTS)
• npm (incluído com Node.js)

1️⃣ Instalar e executar

npx ps-claw@latest web

Pronto! A interface web abre em http://localhost:3000 🎉

🌐 Interface Web

O que é?

Interface visual estilo ChatGPT para conversar com o agente de IA. Salva histórico no navegador, permite trocar modelos, configurar gateways.

Como usar?

# Abrir a interface web
npx ps-claw web

# Ou executar tudo junto (agente + web)
npx ps-claw all

Acesse: http://localhost:3000

Configuração na interface

1. Vá para a aba 🔌 Gateways

   • Clique + Adicionar
   • URL: http://localhost:18789 (PS Claw local) ou qualquer API OpenAI-compatível
   • Nome: "Meu Gateway"
   • Clique Adicionar

2. Vá para a aba 🤖 Modelos & Provedores

   • Adicione suas chaves de API:
     • Claude (Anthropic): sk-ant-...
     • GPT-4 (OpenAI): sk-...
     • Gemini (Google): AIza...
     • Mistral: sua chave
   • Selecione um modelo
   • Clique no modelo para usá-lo

3. Volte para 💬 Chat e comece a conversar! 💬

🔑 Chaves de API — Como obter

🟠 Anthropic (Claude)

1. Acesse https://console.anthropic.com
2. Faça login ou crie conta
3. Vá para API Keys
4. Clique Create Key
5. Copie a chave sk-ant-...
6. Cole na aba Modelos do PS Claw

Grátis? Sim, Claude oferece créditos iniciais ($5-$20). Depois é por uso.

🟢 OpenAI (GPT-4, GPT-4o)

1. Acesse https://platform.openai.com
2. Faça login ou crie conta
3. Vá para API Keys
4. Clique Create new secret key
5. Copie a chave sk-...
6. Cole na aba Modelos do PS Claw

Grátis? Sim, trial de $5-$18. Depois é por uso (mais barato que Claude).

🔵 Google (Gemini)

1. Acesse https://aistudio.google.com/apikey
2. Clique Create API Key
3. Selecione um projeto ou crie novo
4. Copie a chave AIza...
5. Cole na aba Modelos do PS Claw

Grátis? Sim, 60 chamadas por minuto para sempre.

🟣 Mistral

1. Acesse https://console.mistral.ai
2. Faça login ou crie conta
3. Vá para API Keys
4. Clique Generate a new key
5. Copie a chave
6. Cole na aba Modelos do PS Claw

Grátis? Sim, trial de crédito. Depois por uso.

🚀 Alternativas de Uso

Via Git Clone (desenvolvedores)

git clone https://github.com/Pedro21062014/ps-claw-v2.git
cd ps-claw-v2
npm install
npx ps-claw web

Instalar Globalmente

npm install -g ps-claw@latest
ps-claw web

Se não funcionar em Windows, use npx ps-claw web em vez disso.

Atualizar

npx ps-claw update
# ou
npm install -g ps-claw@latest

⚙️ Configurações Avançadas

Variáveis de Ambiente

# Porta da interface web (padrão: 3000)
set PS_CLAW_WEB_PORT=3000

# Porta do gateway PS Claw (padrão: 18789)
set PS_CLAW_GATEWAY_PORT=18789

# Token do gateway (se tiver autenticação)
set OPENCLAW_GATEWAY_TOKEN=seu_token_aqui

Usar outro Gateway

Se você tem um PS Claw rodando em outro servidor:

1. Na interface, aba 🔌 Gateways
2. Adicione a URL: http://seu-servidor:18789
3. Pronto! Usa esse gateway

Usar API OpenAI-compatível

Muitos serviços são compatíveis com OpenAI API:

• Ollama (modelos locais): http://localhost:11434
• Vllm (inference server): http://localhost:8000
• LiteLLM: qualquer URL proxy

Configure na aba Gateways com a URL do seu servidor.

📱 Canais (Telegram, Discord, WhatsApp)

Você pode conectar o PS Claw a:

• Telegram — Adicionar bot ao chat
• Discord — Adicionar bot ao servidor
• WhatsApp — Integração via Twilio ou Baileys
• Slack — Bot em workspace

Configure na interface ou edite .env:

# .env.example
TELEGRAM_BOT_TOKEN=seu_token
DISCORD_BOT_TOKEN=seu_token
WHATSAPP_PHONE=seu_numero

Copie .env.example para .env e preencha.

🐳 Docker

# Build
docker build -t ps-claw .

# Run
docker run -p 3000:3000 ps-claw web

✅ Recursos Incluídos

| Recurso | Status | |---------|--------| | Interface web estilo ChatGPT | ✅ | | Chat com histórico | ✅ | | Múltiplos modelos | ✅ | | Telegram, Discord, WhatsApp | ✅ | | Busca na web | ✅ | | Memória persistente | ✅ | | CLI + API | ✅ | | Suporte MCP/Skills | ✅ | | Apps iOS/Android | ❌ removido | | Geração de vídeo/música | ❌ removido | | Transcrição em tempo real | ❌ removido |

🆘 Resolução de Problemas

"ps-claw: comando não encontrado"

Solução: Use npx ps-claw web em vez de ps-claw web

"localhost:3000 recusou conexão"

Solução: Verifique se algum programa já usa a porta 3000:

# Windows
netstat -ano | findstr :3000

# Mac/Linux
lsof -i :3000

Se estiver em uso, mude a porta:

set PS_CLAW_WEB_PORT=3001
npx ps-claw web

"Gateway offline"

Solução: Verifique se:

1. A URL está correta (ex: http://localhost:18789)
2. O gateway está rodando (se for local, execute npx ps-claw start)
3. Firewall não está bloqueando

"Chave de API inválida"

Solução:

1. Copie a chave completa (sem espaços)
2. Verifique se é uma chave válida (não expirou)
3. Cole de novo na aba Modelos

📚 Documentação Completa

• OpenClaw (original)
• Anthropic Claude
• OpenAI API
• Google Gemini

📄 Licença

MIT — Baseado no OpenClaw por Peter Steinberger

🤝 Contribuições

Pull requests bem-vindo! Para mudanças grandes, abra uma issue primeiro.

💬 Suporte

• GitHub Issues: https://github.com/Pedro21062014/ps-claw-v2/issues
• Discussões: https://github.com/Pedro21062014/ps-claw-v2/discussions

Aproveite o PS Claw! 🦞

Dúvidas? Abra uma issue no GitHub ou entre em contato! ✨