Tools
Agents Workers Extension
By Agents Workers Chrome extension + OpenClaw plugin
Install
npm install
npmREADME
# Agents Workers — extensão Chrome + plugin OpenClaw
Este repositório contém:
- **`chrome-extension/`** — extensão **OpenClaw Office** (Manifest V3) que se liga ao gateway OpenClaw e mostra agentes ativos.
- **`openclaw-plugin/`** — plugin do gateway que expõe APIs e estado (SSE, roster, etc.) em `/agents-workers/v1`.
**Requisitos gerais:** [Node.js](https://nodejs.org/) (recomendado **22.x** para alinhar com o OpenClaw), [OpenClaw](https://www.npmjs.com/package/openclaw) **≥ 2026.4.1** no ambiente onde o gateway corre.
---
## 1. Instalar a extensão no Chrome
1. **Dependências e CSS de produção**
```bash
cd chrome-extension
npm install
npm run build
```
O comando `build` gera o Tailwind em `styles/built.css`. Sem isso, o visual pode ficar incorreto.
2. **Carregar a extensão sem empacotar**
- Abra `chrome://extensions`
- Ative **Modo do desenvolvedor**
- **Carregar sem compactação** e escolha a pasta **`chrome-extension`** (a que contém `manifest.json`)
3. **Configurar ligação ao gateway**
- Clique com o botão direito no ícone da extensão → **Opções** (ou abra `options.html` conforme o Chrome mostrar)
- Defina a **URL base do gateway** (ex.: `http://127.0.0.1:<porta>` conforme o teu `openclaw.json` / documentação do gateway)
- Defina o **token** (Bearer) do gateway, se estiver ativada autenticação
O manifest já inclui permissões para `http://localhost/*`, `http://127.0.0.1/*` e `https://*/*`, para conseguires apontar para túneis (ex.: ngrok) se precisares.
---
## 2. Instalar o plugin OpenClaw
O plugin deve estar **instalado no mesmo ambiente** onde corre o **OpenClaw Gateway** (máquina local ou servidor).
1. **OpenClaw CLI global** (versão compatível com o plugin, ex. 2026.4.1):
```bash
npm install -g [email protected]
```
2. **Dependências do plugin**
Na raiz do repositório (workspace npm):
```bash
npm install
```
Ou só dentro do plugin:
```bash
cd openclaw-plugin
npm install
```
3. **Registar o plugin no gateway**
A partir da pasta **`openclaw-plugin`**:
```bash
openclaw plugins install -l .
```
Isto associa o código local ao OpenClaw. Reinicia o processo do gateway depois (ex.: `systemctl --user restart openclaw-gateway` em Linux com serviço systemd).
4. **Configuração**
O OpenClaw lê normalmente `~/.openclaw/openclaw.json`. Garante que os caminhos de plugins incluem esta instalação (o comando `plugins install` costuma atualizar isso). Se alterares caminhos à mão, evita entradas duplicadas no array de paths.
5. **Chat completions (recomendado para a extensão)**
Alguns fluxos da extensão usam o endpoint HTTP **`/v1/chat/completions`** do gateway. Esse endpoint deve estar **ativado** na configuração do gateway (`gateway.http.endpoints.chatCompletions`). O repositório inclui o script `deploy-plugin.sh` com lógica de exemplo para ativar isso em servidores Linux (requer `jq`); num setup local, configura o equivalente no teu `openclaw.json`.
---
## 3. Deploy remoto (opcional)
O ficheiro **`deploy-plugin.sh`** sincroniza o plugin para um servidor e corre passos de instalação/restart **remotos**. Antes de usar, edita as variáveis no topo do script (utilizador, host, diretório remoto) e trata credenciais de forma segura — não commits com passwords em claro.
---
## Estrutura do repositório
| Pasta | Conteúdo |
|--------|------------|
| `chrome-extension/` | Extensão Chrome (popup, opções, vista “office”, assets) |
| `openclaw-plugin/` | Código TypeScript do plugin OpenClaw (`src/index.ts`, rotas HTTP, SSE) |
Licença do plugin: ver `openclaw-plugin/package.json` (MIT).
tools
Comments
Sign in to leave a comment