nanobot

Usuário

Nome de usuário: nanobot

O serviço de gateway roda com o nanobot utilizador

Você pode acessar o sistema de duas formas.

1. SSH diretamente como nanobot

ssh nanobot@<SERVER_IP>

Senha:

cat /root/.cloudzy-creds

2. Faça login como root e troque de usuário

ssh root@<SERVER_IP>
su - nanobot

Uso

0. SSH no servidor

Conecte-se ao seu servidor como root:

ssh root@<SERVER_IP>

Faça login usando sua senha.

1. Alterne para o usuário da aplicação

su -  nanobot

O Nanobot não pode ser executado como usuário root.

2. Configuração

Edite o arquivo de configuração: /home/nanobot/.nanobot/config.json

Configure estas duas seções no seu arquivo de configuração (as demais opções já têm valores padrão).

Adicione ou mescle os blocos a seguir na sua configuração existente, sem substituir o arquivo inteiro.

Bloco de providers (chave API)

Defina sua chave API (ex.: OpenRouter, recomendado para usuários globais):

{
  "providers": {
    "openrouter": {
      "apiKey": "sk-or-v1-xxx"
    }
  }
}

Bloco de agents (model)

Defina seu modelo (opcionalmente fixe um provider; por padrão a detecção é automática):

{
  "agents": {
    "defaults": {
      "provider": "openrouter",
      "model": "anthropic/claude-opus-4-6"
    }
  }
}

3. Reiniciar gateway

Após concluir a configuração, reinicie o serviço de gateway para aplicar as alterações e habilitar a conectividade com aplicativos de chat como Telegram:

sudo systemctl restart nanobot-gateway

nanobot senha do usuário: armazenada em /root/.cloudzy-creds

4. Bate-papo

Iniciar chat interativo:

nanobot agent

Enviar um único prompt:

nanobot agent -m "Hello!"

Integração Telegram

1. Criar bot

Abrir Telegram:

• Pesquisa: @BotFather
• Executar /newbot
• Copiar token do bot

2. Configurar nanobot

Editar configuração: /home/nanobot/.nanobot/config.json

Adicione ou mescle os blocos a seguir na sua configuração existente, sem substituir o arquivo inteiro.

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "YOUR_BOT_TOKEN",
      "allowFrom": ["YOUR_USER_ID"]
    }
  }
}

Definir enabled para verdadeiro.

YOUR_BOT_TOKEN é o token que você recebe do BotFather ao criar o bot Telegram.

YOUR_USER_ID é o seu ID de usuário no Telegram. Ele pode ser encontrado nas configurações do Telegram e aparece como @yourUserId. Copie esse valor sem o @ símbolo e cole no arquivo de configuração.

4. Reiniciar o serviço

sudo systemctl restart nanobot-gateway

Ficheiros e Diretórios Importantes

• Página inicial do usuário /home/nanobot
• Dados do app /home/nanobot/.nanobot
• Arquivo de configuração: /home/nanobot/.nanobot/config.json
• Binário CLI: /home/nanobot/.local/bin/nanobot
• Serviço Systemd: /etc/systemd/system/nanobot-gateway.service
• Arquivo de credenciais: /root/.cloudzy-creds

Notas

• Após qualquer alteração de configuração: systemctl restart nanobot-gateway
• O serviço inicia automaticamente na inicialização
• Usar systemctl e journalctl para gerenciamento
• Redefinir nanobot senha do usuário (como root): passwd nanobot