Bambu Printer Control para Openclaw

Uma ferramenta de AI-agent projetada para gerenciar arquivos e verificar o status de uma impressora 3D Bambu P1S usando FTPS seguro e scripts de nível de sistema.

mayf3
v1.0.0
Jun 18, 2026
0
447
0

Instalar e Baixar

1. ClawHub CLI

A maneira mais rápida de instalar uma habilidade diretamente do registro.

npx clawhub@latest install bambu-printer

2. Instalação Manual

Copie a pasta da habilidade para um desses locais

Global
~/.openclaw/skills/
Espaço de trabalho
<project>/skills/

Prioridade: Espaço de Trabalho > Local > Integrado

3. Instalação do Prompt

Copie este prompt para o OpenClaw para instalá-lo automaticamente.

Ajude-me a instalar o bambu-printer usando o Clawhub. Se o Clawhub não estiver instalado, instale-o primeiro (npm i -g clawhub).

Prefere baixar?

Obtenha os arquivos originais da habilidade em um arquivo ZIP.

O que é Bambu Printer Control?

A skill Bambu Printer Control permite que desenvolvedores gerenciem e controlem impressoras 3D Bambu P1S diretamente por meio de scripts leves em nível de sistema local. Projetada especificamente para contornar restrições de rede local do macOS que normalmente bloqueiam runtimes instalados pelo Homebrew, como Node.js ou Python, esta ferramenta depende de binários nativos assinados pela Apple, como curl (para FTPS) e Perl (para sondagem de MQTT).

Como parte do ecossistema em expansão de Openclaw Skills, esta skill fornece uma ponte robusta entre AI-agents locais e hardware físico, garantindo uma conectividade de rede local confiável. Desenvolvedores podem consultar facilmente o status online do dispositivo, navegar pelos sistemas de arquivos da impressora 3D e lidar com transferências em lote de arquivos 3MF ou GCODE fatiados sem depender de aplicativos CLI externos pesados.

Casos de uso do Bambu Printer Control

  • Agendamento de trabalhos de impressão 3D automatizado: Coloque modelos 3MF ou GCODE fatiados na fila do diretório de cache de impressão da sua Bambu P1S diretamente do seu fluxo de trabalho de desenvolvedor.
  • Extração de Timelapse: Automatize a recuperação de vídeos de timelapse gravados do diretório da impressora para compartilhamento de progresso ou monitoramento.
  • Monitoramento de status de rede local: Verifique programaticamente se a impressora 3D está online e ativa sem sair do seu ambiente CLI ou terminal.
  • Manutenção e limpeza de arquivos: Monitore e limpe facilmente o cache, modelos e espaços de armazenamento de registros de impressão da impressora para liberar armazenamento local.

Como o Bambu Printer Control funciona

  1. Sondagem de conectividade: A skill verifica a conexão local com a Bambu P1S por meio de scripts Perl nativos que sondam as portas MQTT, FTPS e da câmera.
  2. Chamadas seguras de Shell FTPS: Usando comandos curl assinados pelo sistema, o agente executa operações de arquivo (listar, enviar, baixar, excluir) via FTPS com segurança.
  3. Análise de diretório: A saída do comando FTPS é estruturada e analisada para exibir a hierarquia interna de diretórios da impressora (cache, timelapse, modelo, etc.).
  4. Execução e limpeza: Arquivos como gcode ou 3mf são enviados para o cache ou baixados para o seu caminho local, com erros relatados em um formato JSON claro e estruturado.

Configuração do Bambu Printer Control

Configure suas configurações locais criando um arquivo config.json contendo os detalhes da sua impressora Bambu P1S (IP, serial, código de acesso). Execute verificações de status e gerencie transferências de arquivos diretamente via comandos do terminal:

# 1. Verificar status da conexão
/usr/bin/perl scripts/status.pl

# 2. Listar o diretório raiz da impressora
bash scripts/ftp.sh list /

# 3. Enviar um modelo 3D fatiado para o cache da impressora
bash scripts/ftp.sh upload my_model.gcode.3mf

# 4. Baixar um arquivo de vídeo de timelapse
bash scripts/ftp.sh download /timelapse/video_example.avi ./

Esquema de Dados e Taxonomia de Bambu Printer Control

A skill depende de uma configuração local config.json e mapeia a estrutura de diretório interna da Bambu P1S da seguinte forma:

Caminho do diretório Descrição Operações suportadas
/ Diretório raiz da impressora List
/cache/ Diretório de cache para arquivos de impressão List, Upload, Download, Delete
/timelapse/ Vídeos de timelapse da câmera automatizados List, Download, Delete
/recorder/ Logs e registros da impressora (.bin) List, Download, Delete
/image/ Imagens armazenadas List, Download, Delete
/model/ Diretórios de arquivos de modelo List, Download, Delete

Esquema JSON de status

A consulta de status (scripts/status.pl) retorna uma saída JSON limpa para fácil validação programática:

{
  "status": "online",
  "ftps": "ok",
  "mqtt_auth": "ok",
  "camera_port": "open",
  "ping": "ok"
}

Recursos avançados do Bambu Printer Control

  • Contorno de Sandboxing do macOS: Usa utilitários assinados pelo sistema (curl, perl) para acessar redes locais de forma confiável e contornar as restrições do macOS em pacotes Node.js ou Python instalados pelo Homebrew.
  • Busca flexível de mídia: Ideal para integração com suítes de automação residencial ou dashboards personalizados para sincronizar automaticamente vídeos AVI /timelapse/ imediatamente após a impressão.
  • Análise direcionada da pegada de armazenamento: Use argumentos de linha de comando (como scripts/ftp.sh size [path]) para analisar rapidamente a utilização total do armazenamento no cartão SD interno.

SKILL.md


Carregamento

Habilidades relacionadas do Openclaw

METADATA

Github Stars: 0
forks: 0

Apresentou*