ae39e45460
NOVAS SKILLS: - next-best-practices v0.1.0 (CLEAN) — Next.js App Router, RSC, caching, data - nextjs-patterns v1.0.0 (CLEAN) — Next.js 15: Server Actions, route handlers - vite v1.0.0 (CLEAN) — env vars, aliases, proxy, CJS compat - uncle-bob v1.0.0 (CLEAN) — Clean Code, SOLID, Clean Architecture - clean-code-review v1.0.0 (CLEAN) — naming, guard clauses, anti-patterns, refactoring - vue v1.0.0 (CLEAN) — Vue framework - vue-composition-api-best-practices v1.0.0 (CLEAN) — composables, Pinia, reactivity BIBLIOTECA INTELIGENTE libs/ (10 dominios, 11 arquivos): - typescript/ — TS safe + generics gotchas - react/ — Next.js App Router + Vite config - vue/ — Composition API + Pinia - linux/ — System diagnostic cheatsheet - database/ — PostgreSQL + MySQL patterns - browser/ — Chromium CLI + E2E testing - security/ — SAST audit (OWASP Top 10) - best-practices/ — Clean Code + SOLID + Clean Architecture - deploy/ — Docker multi-stack + OpenClaw ops - + INDEX.md como guia de navegacao .learnings/ — LRN-20260519-003 criado (biblioteca compartilhada)
51 lines
1.8 KiB
Markdown
51 lines
1.8 KiB
Markdown
# OpenClaw — Gateway Ops CLI
|
|
|
|
> Referência rápida baseada em `openclaw-power-ops` + `openclaw-config`.
|
|
|
|
## 🌟 Golden Rules
|
|
1. ❌ NUNCA editar `openclaw.json` diretamente — sempre `openclaw config set/get/unset`
|
|
2. ✅ Sempre reiniciar gateway após mudanças de config
|
|
3. ❌ Telegram: NÃO usar campo `agent` dentro de config de conta — usar `bindings` array
|
|
4. ❌ Telegram `streaming`: deve ser string `"off"`, não booleano `false`
|
|
5. ✅ JSON values em `config set` precisam de `--strict-json`
|
|
|
|
## Diagnóstico
|
|
```bash
|
|
openclaw status # overview
|
|
openclaw status --deep # detalhado
|
|
openclaw doctor # encontra problemas
|
|
openclaw doctor --fix # auto-fix (com consentimento do usuário!)
|
|
openclaw gateway health # health check do gateway
|
|
openclaw security audit # scan de segurança
|
|
openclaw security audit --deep --fix # scan profundo + auto-fix
|
|
```
|
|
|
|
## Config Segura — $include Modular
|
|
```json5
|
|
// ~/.openclaw/openclaw.json
|
|
{
|
|
"$include": ["./gateway.json5", "./channels/telegram.json5"],
|
|
}
|
|
```
|
|
- `$include`: resolved antes da validação de schema
|
|
- Objetos: merge recursivo; Arrays: concatenam; Primitivos: último vence
|
|
- Limite: profundidade máx 10; includes circulares são detectados
|
|
|
|
## Telegram — Exemplos
|
|
```bash
|
|
# DM policy open (cuidado!)
|
|
openclaw config set channels.telegram.dmPolicy '"open"' --json
|
|
openclaw config set channels.telegram.allowFrom '["*"]' --json
|
|
|
|
# Streaming OFF (string, não boolean)
|
|
openclaw config set channels.telegram.streaming '"off"' --json
|
|
```
|
|
|
|
## Enabling Features
|
|
```bash
|
|
# Web search (Brave/Perplexity)
|
|
openclaw config set tools.web.search.enabled true --json
|
|
openclaw config set tools.web.search.provider '"brave"' --json
|
|
# Chave via env var: export BRAVE_API_KEY="***"
|
|
```
|