Skill OpenSync — só para OpenClaw (opcional)

Instalar a skill OpenSync

Para sincronizar qualquer pasta num PC Ubuntu sem OpenClaw, skill ou plugin, use o opensync-ubuntu. Esta página é apenas para quem quer o space ligado a um assistente OpenClaw.

O texto abaixo destina-se a colar no chat do assistente ou instalar como skill. Inclui o ficheiro completo SKILL.md. O agente pode abrir esta página por URL, obter o raw, ou receber o ficheiro em anexo.

Descarregar SKILL.md

Onde gravar no disco

Instale a skill neste caminho no sistema onde corre o OpenClaw Gateway (crie as pastas em falta). O ficheiro deve chamar-se SKILL.md:

~/.openclaw/skills/opensync/SKILL.md

mkdir -p ~/.openclaw/skills/opensync
# Guarde aqui o ficheiro SKILL.md (conteúdo abaixo ou descarregado).

Tarefa agendada: sincronizar a cada 30 minutos

Depois de instalar a skill e definir as credenciais, crie uma Scheduled Task no Gateway OpenClaw para correr o sync de 30 em 30 minutos. Guia oficial: docs.openclaw.ai/automation/cron-jobs.

openclaw cron add \
  --name "OpenSync space sync (30m)" \
  --every 30m \
  --session isolated \
  --message "OpenSync: POST .../device/spaces/<spaceId>/files/snapshot com JSON {files} + Bearer OPENSYNC_DEVICE_API_KEY." \
  --tools exec \
  --delivery none

# Ver jobs: openclaw cron list

Ajuste --tz se usar --cron "*/30 * * * *" em vez de --every 30m. O detalhe completo repete-se no SKILL.md abaixo.

Conteúdo completo do SKILL.md (OpenSync)

Depois de gravar, se a skill não aparecer de imediato, inicie uma nova sessão de conversa com o agente.

---
name: opensync
description: OpenSync skill (fonte indisponível neste deploy).
---

# OpenSync

O assistente **não gera tokens**. O utilizador fornece `usk_...` (Configurações → Tokens de acesso) para `opensync init` e `osk_...` para snapshot HTTP se necessário. Instalação Ubuntu (core/VPS): `curl -fsSL` ao `/install/ubuntu-core` do site OpenSync.

Credenciais (substituir no vosso ambiente)

O assistente não gera tokens no OpenSync. O token de workspace (usk_...) vem de Configurações → Tokens de acesso. A API key de agente (osk_...) para snapshot HTTP é criada pelo utilizador no dashboard, no fluxo do space. Em produção use OPENSYNC_API_URL="https://api.opensync.space/api"; em self-hosted, a URL da API Nest termina em /api.

export OPENSYNC_API_URL="https://api.opensync.space/api"
export OPENSYNC_SPACE_ID="<uuid-do-space>"
export OPENSYNC_DEVICE_API_KEY="<api-key-osk_...>"

# Snapshot (substitui estado do space na API; espelho Gitea é assincrono). Ex.:
curl -sS -X POST "${OPENSYNC_API_URL}/device/spaces/${OPENSYNC_SPACE_ID}/files/snapshot" \
  -H "Authorization: Bearer ${OPENSYNC_DEVICE_API_KEY}" \
  -H "Content-Type: application/json" \
  -d '{"files":{"notas/exemplo.md":"# Ola"}}'

Agente Ubuntu

Instalação recomendada: linha curl … | bash a partir de /install/ubuntu-core no site (script instala o .deb e corre opensync init; o utilizador cola o usk_... quando o wizard pedir). Guia de instalação.

Alternativa: Git na VPS

No dashboard OpenSync, Git na VPS permite deploy key e git push direto ao Gitea (fluxo técnico), em paralelo com a API.

Voltar ao início