Agente Ubuntu (opensync-ubuntu)

Liga qualquer pasta do Ubuntu a um space OpenSync. O wizard de configuração guia tudo — sem editar ficheiros de configuração manualmente.

1. Instalar e configurar

No Ubuntu (amd64), uma linha: o site serve um script que descarrega o .deb, instala com dpkg e de seguida corre opensync init (o assistente interativo).

curl -fsSL https://opensync.space/install/ubuntu-core | bash

Com curl … | bash o script volta a ligar o teclado ao terminal para o wizard. Para inspecionar o instalador antes de executar, abra o URL no browser ou use curl -fsSL … sem enviar a saída para o bash.

O assistente irá:

1. Pedir o e-mail da conta OpenSync.
2. Pedir o token de workspace (usk_...). Gere-o em Definições → Tokens de acesso.
3. Autenticar e listar os seus spaces para escolher (ou criar um novo).
4. Pedir a pasta local a sincronizar.
5. Gerar automaticamente um token de sincronização para o space.
6. Ativar o serviço systemd para arrancar com o sistema.

2. Gerir o serviço

# Ver estado do sync
opensync status

# Logs em tempo real
journalctl --user -u opensync-ubuntu -f

# Parar / reiniciar
systemctl --user stop opensync-ubuntu
systemctl --user restart opensync-ubuntu

Ficheiros de configuração

• ~/.config/opensync/config.json — space ID, pasta local, API URL.
• ~/.config/opensync/agent.token — token de sincronização (permissões restritas).
• ~/.local/share/opensync-ubuntu/{spaceId}.sqlite — estado local dos ficheiros.

Prefere usar o assistente OpenClaw? Instale a skill OpenSync — inclui os passos de instalação do opensync e guia o agente a configurar tudo automaticamente.