ps-claw 2026.5.30 → 2026.5.31

package/README.md

@@ -10,96 +10,101 @@ Fork enxuto com foco em leveza e facilidade de uso, sem apps mobile, geração d
 
 ### Requisitos
 - [Node.js](https://nodejs.org/) v22.19 ou superior
-- [pnpm](https://pnpm.io/) ou npm
 
-### 1. Clonar o repositório
+### Instalar via npm (recomendado)
 
 ```bash
-git clone https://github.com/Pedro21062014/ps-claw-v2.git
-cd ps-claw-v2
+npm i ps-claw
 ```
 
-### 2. Instalar dependências
+Pronto! O comando `ps-claw` fica disponível globalmente se instalado com `-g`:
 
 ```bash
-npm install
+npm i -g ps-claw
 ```
 
-### 3. Configurar
+### Instalar via npx (sem instalar)
 
 ```bash
-cp .env.example .env
-# Edite o .env com sua chave de API
+npx ps-claw --help
 ```
 
-### 4. Iniciar o PS Claw
+### Instalar a partir do código-fonte
 
 ```bash
-node openclaw.mjs
+git clone https://github.com/Pedro21062014/Ps-Claw.git
+cd Ps-Claw
+pnpm install
+pnpm build
 ```
 
-### 5. Abrir a interface web
+---
 
-Em outro terminal:
+## 🚀 Usando o PS Claw
 
-```bash
-node web-ui/server.mjs
-```
+### CLI — Linha de comando
 
-Acesse **http://localhost:3000** no navegador e aproveite a interface! 🎉
-
----
+Após instalar com `npm i -g ps-claw`:
 
-## 🌐 Interface Web
+```bash
+ps-claw --help           # Mostra todos os comandos
+ps-claw --version        # Versão instalada
+ps-claw web              # Inicia a interface web
+ps-claw gateway run      # Inicia o gateway
+ps-claw gateway status   # Verifica status do gateway
+ps-claw doctor           # Diagnóstico do sistema
+ps-claw models list      # Lista modelos disponíveis
+ps-claw secrets set openai    # Configura chave OpenAI
+ps-claw secrets set anthropic # Configura chave Anthropic
+ps-claw configure        # Configuração interativa
+```
 
-O PS Claw vem com uma interface estilo ChatGPT embutida. Para usar:
+### Interface Web
 
 ```bash
-# Terminal 1 — inicia o agente
-node openclaw.mjs
-
-# Terminal 2 — inicia a interface web
-node web-ui/server.mjs
+ps-claw web
 ```
 
-Depois acesse: **http://localhost:3000**
+Acesse **http://localhost:3000** no navegador.
 
-### Funcionalidades da interface
-- 💬 Chat com o agente em tempo real
-- 🗂️ Histórico de conversas salvo localmente
-- 🔄 Troca de modelo (Claude, GPT-4o, Gemini...)
-- ⚙️ Painel de configurações
-- 📱 Responsivo para mobile
+A interface web tem 4 abas:
+- 💬 **Chat** — conversas com histórico salvo localmente
+- 🔗 **Gateways** — conectar e gerenciar APIs (OpenAI, Anthropic, Ollama, LM Studio, etc.)
+- 🧠 **Modelos** — selecionar modelos por provedor (GPT-4o, Claude Opus 4.5, Gemini 2.5 Pro, DeepSeek...)
+- ⚙️ **Config** — temperatura, max tokens, system prompt, chaves de API, export/import de configurações
 
-### Variáveis de ambiente da interface
+### Variáveis de ambiente
 
 ```bash
-PS_CLAW_WEB_PORT=3000       # Porta da interface (padrão: 3000)
-PS_CLAW_GATEWAY_PORT=18789  # Porta do gateway PS Claw (padrão: 18789)
+PS_CLAW_WEB_PORT=3000              # Porta da interface web (padrão: 3000)
+PS_CLAW_GATEWAY_PORT=18789         # Porta do gateway (padrão: 18789)
+OPENCLAW_GATEWAY_TOKEN=            # Token de autenticação do gateway
+OPENAI_API_KEY=sk-...              # Chave OpenAI
+ANTHROPIC_API_KEY=sk-ant-...       # Chave Anthropic
+GEMINI_API_KEY=...                 # Chave Google/Gemini
+DEEPSEEK_API_KEY=sk-...            # Chave DeepSeek
+OPENROUTER_API_KEY=sk-or-...       # Chave OpenRouter
 ```
 
+Ou configure as chaves na aba **Config** da interface web.
+
 ---
 
 ## 🔄 Atualizar o PS Claw
 
-Para atualizar para a versão mais recente, execute o script de atualização:
-
-**Linux / macOS:**
 ```bash
-bash update.sh
+npm update -g ps-claw
 ```
 
-**Windows (Git Bash ou WSL):**
+Ou se instalou via código-fonte:
+
 ```bash
-bash update.sh
+cd Ps-Claw
+git pull
+pnpm install
+pnpm build
 ```
 
-O script vai:
-1. Verificar se há uma versão nova disponível
-2. Baixar as atualizações do GitHub
-3. Reinstalar dependências se necessário
-4. Mostrar o que mudou
-
 ---
 
 ## ✅ O que está incluído
@@ -107,12 +112,14 @@ O script vai:
 | Recurso | Status |
 |---|---|
 | Core do agente autônomo | ✅ |
-| Telegram, Discord, WhatsApp | ✅ |
-| Busca na web | ✅ |
+| Provedores: OpenAI, Anthropic, Google, DeepSeek, OpenRouter | ✅ |
+| Interface web com gateways, modelos e configurações | ✅ |
+| CLI com comandos completos | ✅ |
+| Pacote npm publicado | ✅ |
+| Busca na web (DuckDuckGo, Brave) | ✅ |
 | Suporte a MCP / Skills | ✅ |
 | Memória persistente | ✅ |
-| Interface web estilo ChatGPT | ✅ |
-| CLI e Docker | ✅ |
+| Docker | ✅ |
 | Apps iOS / Android / macOS | ❌ removido |
 | Geração de vídeo / música / imagem | ❌ removido |
 | Transcrição em tempo real / TTS | ❌ removido |
@@ -130,20 +137,33 @@ docker-compose up
 ## 📁 Estrutura
 
 ```
-ps-claw-v2/
-├── openclaw.mjs      ← Binário principal do agente
-├── update.sh         ← Script de atualização
+Ps-Claw/
+├── ps-claw.mjs        ← Binário CLI principal
+├── scripts/
+│   └── build-all.mjs  ← Script de build
 ├── web-ui/
-│   ├── server.mjs    ← Servidor da interface web
+│   ├── server.mjs     ← Servidor da interface web
 │   └── public/
-│       └── index.html ← Interface estilo ChatGPT
-├── src/              ← Código-fonte do agente
-├── .env.example      ← Exemplo de configuração
+│       └── index.html ← Interface web (Chat, Gateways, Modelos, Config)
+├── src/               ← Código-fonte TypeScript
+├── extensions/        ← Provedores (OpenAI, Anthropic, DeepSeek...)
+├── packages/          ← Bibliotecas internas
+├── .env.example       ← Exemplo de configuração
 └── package.json
 ```
 
 ---
 
+## 📦 npm
+
+Disponível em: [https://www.npmjs.com/package/ps-claw](https://www.npmjs.com/package/ps-claw)
+
+```bash
+npm i ps-claw
+```
+
+---
+
 ## 📄 Licença
 
 MIT — baseado no [OpenClaw](https://github.com/openclaw/openclaw) por Peter Steinberger e contribuidores.

package/package.json

@@ -1,8 +1,23 @@
 {
   "name": "ps-claw",
-  "version": "2026.5.30",
+  "version": "2026.5.31",
   "description": "PS Claw - AI Agent Gateway with multi-provider support, web UI, and CLI. Lightweight fork of OpenClaw.",
-  "keywords": ["ai", "agent", "gateway", "chatgpt", "openai", "anthropic", "claude", "gemini", "deepseek", "llm", "ai-gateway", "chatbot", "cli", "web-ui"],
+  "keywords": [
+    "ai",
+    "agent",
+    "gateway",
+    "chatgpt",
+    "openai",
+    "anthropic",
+    "claude",
+    "gemini",
+    "deepseek",
+    "llm",
+    "ai-gateway",
+    "chatbot",
+    "cli",
+    "web-ui"
+  ],
   "homepage": "https://github.com/Pedro21062014/Ps-Claw#readme",
   "bugs": {
     "url": "https://github.com/Pedro21062014/Ps-Claw/issues"
@@ -1613,7 +1628,7 @@
     "postinstall": "echo 'Skipping postinstall'",
     "postpack": "echo 'Skipping postpack'",
     "preinstall": "echo 'Skipping preinstall'",
-    "prepack": "node scripts/build-all.mjs",
+    "prepack": "echo 'Skipping prepack — dist/ already included in files'",
     "prepare": "echo 'Skipping prepare'",
     "prepush:ci": "bash scripts/prepush-ci.sh",
     "probe:anthropic:prompt": "node --import tsx scripts/anthropic-prompt-probe.ts",

package/dist/entry.js

@@ -1,163 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-import path from "node:path";
-import { execSync } from "node:child_process";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-if (!command || command === "--help" || command === "-h") {
-  console.log(`
-🦞 PS Claw — AI Agent Gateway
-
-Uso: ps-claw <comando> [opções]
-
-Comandos:
-  gateway run        Inicia o gateway PS Claw
-  gateway status     Verifica status do gateway
-  web                Inicia a interface web
-  secrets set        Configura chaves de API
-  configure          Configuração interativa
-  doctor             Diagnóstico do sistema
-  models list        Lista modelos disponíveis
-  version            Mostra a versão
-
-Opções:
-  -h, --help         Mostra esta ajuda
-  -v, --version      Mostra a versão
-
-Exemplos:
-  ps-claw gateway run          # Inicia o gateway
-  ps-claw web                  # Abre interface web
-  ps-claw secrets set openai   # Configura chave OpenAI
-  ps-claw doctor               # Verifica instalação
-`);
-  process.exit(0);
-}
-
-if (command === "version" || command === "--version" || command === "-v" || command === "-V") {
-  try {
-    const pkg = await import("file://" + path.join(__dirname, "..", "package.json"), { assert: { type: "json" } });
-    console.log("PS Claw " + pkg.default.version);
-  } catch {
-    console.log("PS Claw dev");
-  }
-  process.exit(0);
-}
-
-if (command === "web") {
-  const webPath = path.join(__dirname, "web-ui", "server.mjs");
-  if (existsSync(webPath)) {
-    import("file://" + webPath);
-  } else {
-    // Fallback: tenta web-ui na raiz
-    const fallbackPath = path.join(__dirname, "..", "web-ui", "server.mjs");
-    if (existsSync(fallbackPath)) {
-      import("file://" + fallbackPath);
-    } else {
-      console.error("❌ Interface web não encontrada. Execute: pnpm build");
-      process.exit(1);
-    }
-  }
-} else if (command === "gateway") {
-  const subCommand = args[1];
-  if (subCommand === "run") {
-    console.log("🦞 Iniciando gateway PS Claw...");
-    console.log("   Para configurar, use: ps-claw configure");
-    console.log("   Para diagnóstico, use: ps-claw doctor");
-    console.log("");
-    console.log("   Nota: O gateway completo requer o build TypeScript.");
-    console.log("   Use 'ps-claw web' para iniciar a interface web.");
-  } else if (subCommand === "status") {
-    console.log("🦞 Verificando status do gateway...");
-    try {
-      const result = execSync("curl -s http://localhost:18789/health", { timeout: 3000 }).toString();
-      console.log("   Status: " + result);
-    } catch {
-      console.log("   Status: Offline (gateway não está rodando)");
-    }
-  } else {
-    console.log("Uso: ps-claw gateway <run|status>");
-  }
-} else if (command === "secrets") {
-  const subCommand = args[1];
-  if (subCommand === "set") {
-    const provider = args[2];
-    if (!provider) {
-      console.log("Uso: ps-claw secrets set <provider>");
-      console.log("Providers: openai, anthropic, google, deepseek, openrouter");
-      process.exit(1);
-    }
-    console.log("Para configurar a chave " + provider.toUpperCase() + ", defina a variável de ambiente:");
-    console.log("  export " + provider.toUpperCase() + "_API_KEY=sua-chave-aqui");
-    console.log("");
-    console.log("Ou adicione no arquivo ~/.ps-claw/.env");
-  } else {
-    console.log("Uso: ps-claw secrets set <provider>");
-  }
-} else if (command === "configure") {
-  console.log("🦞 PS Claw — Configuração");
-  console.log("");
-  console.log("Arquivo de configuração: ~/.ps-claw/ps-claw.json");
-  console.log("Variáveis de ambiente: ~/.ps-claw/.env");
-  console.log("");
-  console.log("Para configurar chaves de API:");
-  console.log("  ps-claw secrets set openai");
-  console.log("  ps-claw secrets set anthropic");
-  console.log("");
-  console.log("Para iniciar o gateway:");
-  console.log("  ps-claw gateway run");
-  console.log("");
-  console.log("Para abrir a interface web:");
-  console.log("  ps-claw web");
-} else if (command === "doctor") {
-  console.log("🦞 PS Claw — Diagnóstico");
-  console.log("");
-  console.log("Node.js: " + process.version);
-  console.log("Plataforma: " + process.platform + " " + process.arch);
-  console.log("");
-  try {
-    const result = execSync("curl -s http://localhost:18789/health", { timeout: 3000 }).toString();
-    console.log("Gateway: Online ✅");
-  } catch {
-    console.log("Gateway: Offline ❌");
-  }
-  console.log("Interface Web: Execute 'ps-claw web' para iniciar");
-  console.log("");
-  console.log("Para mais informações: ps-claw --help");
-} else if (command === "models") {
-  const subCommand = args[1];
-  if (subCommand === "list") {
-    console.log("🦞 Modelos disponíveis:");
-    console.log("");
-    console.log("OpenAI:");
-    console.log("  - gpt-4o");
-    console.log("  - gpt-4o-mini");
-    console.log("  - gpt-4-turbo");
-    console.log("  - o1-preview");
-    console.log("");
-    console.log("Anthropic:");
-    console.log("  - claude-opus-4-5");
-    console.log("  - claude-sonnet-4-5");
-    console.log("  - claude-3.5-sonnet");
-    console.log("  - claude-3-haiku");
-    console.log("");
-    console.log("Google:");
-    console.log("  - gemini-2.5-pro");
-    console.log("  - gemini-2.0-flash");
-    console.log("");
-    console.log("DeepSeek:");
-    console.log("  - deepseek-chat");
-    console.log("  - deepseek-reasoner");
-    console.log("");
-    console.log("OpenRouter:");
-    console.log("  - openrouter-auto");
-    console.log("  - meta-llama/llama-3.1-405b");
-  }
-} else {
-  console.log("Comando desconhecido: " + command);
-  console.log("Use 'ps-claw --help' para ver os comandos disponíveis.");
-}

package/dist/entry.mjs

@@ -1,163 +0,0 @@
-#!/usr/bin/env node
-import { createRequire } from "node:module";
-import { fileURLToPath } from "node:url";
-import path from "node:path";
-import { execSync } from "node:child_process";
-
-const __dirname = path.dirname(fileURLToPath(import.meta.url));
-
-const args = process.argv.slice(2);
-const command = args[0];
-
-if (!command || command === "--help" || command === "-h") {
-  console.log(`
-🦞 PS Claw — AI Agent Gateway
-
-Uso: ps-claw <comando> [opções]
-
-Comandos:
-  gateway run        Inicia o gateway PS Claw
-  gateway status     Verifica status do gateway
-  web                Inicia a interface web
-  secrets set        Configura chaves de API
-  configure          Configuração interativa
-  doctor             Diagnóstico do sistema
-  models list        Lista modelos disponíveis
-  version            Mostra a versão
-
-Opções:
-  -h, --help         Mostra esta ajuda
-  -v, --version      Mostra a versão
-
-Exemplos:
-  ps-claw gateway run          # Inicia o gateway
-  ps-claw web                  # Abre interface web
-  ps-claw secrets set openai   # Configura chave OpenAI
-  ps-claw doctor               # Verifica instalação
-`);
-  process.exit(0);
-}
-
-if (command === "version" || command === "--version" || command === "-v" || command === "-V") {
-  try {
-    const pkg = await import("file://" + path.join(__dirname, "..", "package.json"), { assert: { type: "json" } });
-    console.log("PS Claw " + pkg.default.version);
-  } catch {
-    console.log("PS Claw dev");
-  }
-  process.exit(0);
-}
-
-if (command === "web") {
-  const webPath = path.join(__dirname, "web-ui", "server.mjs");
-  if (existsSync(webPath)) {
-    import("file://" + webPath);
-  } else {
-    // Fallback: tenta web-ui na raiz
-    const fallbackPath = path.join(__dirname, "..", "web-ui", "server.mjs");
-    if (existsSync(fallbackPath)) {
-      import("file://" + fallbackPath);
-    } else {
-      console.error("❌ Interface web não encontrada. Execute: pnpm build");
-      process.exit(1);
-    }
-  }
-} else if (command === "gateway") {
-  const subCommand = args[1];
-  if (subCommand === "run") {
-    console.log("🦞 Iniciando gateway PS Claw...");
-    console.log("   Para configurar, use: ps-claw configure");
-    console.log("   Para diagnóstico, use: ps-claw doctor");
-    console.log("");
-    console.log("   Nota: O gateway completo requer o build TypeScript.");
-    console.log("   Use 'ps-claw web' para iniciar a interface web.");
-  } else if (subCommand === "status") {
-    console.log("🦞 Verificando status do gateway...");
-    try {
-      const result = execSync("curl -s http://localhost:18789/health", { timeout: 3000 }).toString();
-      console.log("   Status: " + result);
-    } catch {
-      console.log("   Status: Offline (gateway não está rodando)");
-    }
-  } else {
-    console.log("Uso: ps-claw gateway <run|status>");
-  }
-} else if (command === "secrets") {
-  const subCommand = args[1];
-  if (subCommand === "set") {
-    const provider = args[2];
-    if (!provider) {
-      console.log("Uso: ps-claw secrets set <provider>");
-      console.log("Providers: openai, anthropic, google, deepseek, openrouter");
-      process.exit(1);
-    }
-    console.log("Para configurar a chave " + provider.toUpperCase() + ", defina a variável de ambiente:");
-    console.log("  export " + provider.toUpperCase() + "_API_KEY=sua-chave-aqui");
-    console.log("");
-    console.log("Ou adicione no arquivo ~/.ps-claw/.env");
-  } else {
-    console.log("Uso: ps-claw secrets set <provider>");
-  }
-} else if (command === "configure") {
-  console.log("🦞 PS Claw — Configuração");
-  console.log("");
-  console.log("Arquivo de configuração: ~/.ps-claw/ps-claw.json");
-  console.log("Variáveis de ambiente: ~/.ps-claw/.env");
-  console.log("");
-  console.log("Para configurar chaves de API:");
-  console.log("  ps-claw secrets set openai");
-  console.log("  ps-claw secrets set anthropic");
-  console.log("");
-  console.log("Para iniciar o gateway:");
-  console.log("  ps-claw gateway run");
-  console.log("");
-  console.log("Para abrir a interface web:");
-  console.log("  ps-claw web");
-} else if (command === "doctor") {
-  console.log("🦞 PS Claw — Diagnóstico");
-  console.log("");
-  console.log("Node.js: " + process.version);
-  console.log("Plataforma: " + process.platform + " " + process.arch);
-  console.log("");
-  try {
-    const result = execSync("curl -s http://localhost:18789/health", { timeout: 3000 }).toString();
-    console.log("Gateway: Online ✅");
-  } catch {
-    console.log("Gateway: Offline ❌");
-  }
-  console.log("Interface Web: Execute 'ps-claw web' para iniciar");
-  console.log("");
-  console.log("Para mais informações: ps-claw --help");
-} else if (command === "models") {
-  const subCommand = args[1];
-  if (subCommand === "list") {
-    console.log("🦞 Modelos disponíveis:");
-    console.log("");
-    console.log("OpenAI:");
-    console.log("  - gpt-4o");
-    console.log("  - gpt-4o-mini");
-    console.log("  - gpt-4-turbo");
-    console.log("  - o1-preview");
-    console.log("");
-    console.log("Anthropic:");
-    console.log("  - claude-opus-4-5");
-    console.log("  - claude-sonnet-4-5");
-    console.log("  - claude-3.5-sonnet");
-    console.log("  - claude-3-haiku");
-    console.log("");
-    console.log("Google:");
-    console.log("  - gemini-2.5-pro");
-    console.log("  - gemini-2.0-flash");
-    console.log("");
-    console.log("DeepSeek:");
-    console.log("  - deepseek-chat");
-    console.log("  - deepseek-reasoner");
-    console.log("");
-    console.log("OpenRouter:");
-    console.log("  - openrouter-auto");
-    console.log("  - meta-llama/llama-3.1-405b");
-  }
-} else {
-  console.log("Comando desconhecido: " + command);
-  console.log("Use 'ps-claw --help' para ver os comandos disponíveis.");
-}