Openclaw용 Tailnet SSH 파일 관리자

보안 Tailscale SSH 연결을 통해 원격 기기 간 파일을 관리, 전송 및 동기화하기 위한 전문 스킬입니다.

xeon0v0
v1.0.0
Apr 15, 2026
0
710
0

설치 및 다운로드

1. ClawHub CLI

레지스트리에서 스킬을 바로 설치하는 가장 빠른 방법입니다.

npx clawhub@latest install ssh-filemanager

2. 수동 설치

스킬 폴더를 다음 위치 중 하나로 복사하세요

글로벌
~/.openclaw/skills/
워크스페이스
<project>/skills/

우선순위: 워크스페이스 > 로컬 > 번들

3. 프롬프트 설치

이 프롬프트를 OpenClaw에 복사하면 자동으로 설치됩니다.

Clawhub를 사용해서 ssh-filemanager 설치를 도와줘. Clawhub가 설치되어 있지 않다면 먼저 설치해 줘 (npm i -g clawhub).

다운로드를 원하시나요?

ZIP 아카이브 형태의 원본 스킬 파일을 받으세요.

Tailnet SSH 파일 관리자란 무엇인가요?

Tailnet SSH 파일 관리자는 Openclaw Skills 생태계를 위해 설계된 강력한 도구로, OpenClaw 게이트웨이와 원격 노드 간의 원활한 파일 작업을 지원합니다. Tailscale SSH, scp 및 sftp의 복잡성을 통합된 인터페이스로 추상화하여, 포트를 공용 인터넷에 노출하지 않고도 사설 Tailnet 내에서 안전하게 파일을 조작할 수 있게 합니다.

이 스킬은 성능과 신뢰성을 위해 설계되었으며, 다양한 파일 크기를 효율적으로 처리하는 지능형 기능을 내장하고 있습니다. Tailscale ACL의 보안과 MagicDNS의 단순함을 활용하여, 개발자와 시스템 관리자에게 AI 코딩 에이전트를 통해 직접 원격 파일 시스템 작업을 자동화할 수 있는 강력한 방법을 제공합니다.

Tailnet SSH 파일 관리자 활용 사례

  • 로컬 개발 기기에서 여러 원격 OpenClaw 노드로 구성 파일이나 스크립트 배포.
  • 로컬 분석을 위해 원격 서버에서 로그나 진단 데이터 검색.
  • chmod를 통한 재귀적 삭제, 이동 및 권한 업데이트를 포함한 원격 디렉토리 구조 관리.
  • 원격 find 작업을 사용하여 분산된 기기 네트워크에서 특정 파일 검색.
  • 보안 scp 프로토콜을 사용하여 노드 간 이진 자산 동기화.

Tailnet SSH 파일 관리자 작동 원리

  1. 이 스킬은 Tailscale IP 또는 MagicDNS 호스트 이름을 사용하여 대상 원격 호스트를 식별합니다.
  2. 특정 파일 시스템 작업(예: 나열, 읽기, 푸시)을 결정하고 대상 경로를 검증합니다.
  3. 파일 크기 평가가 수행됩니다. 3KB 미만의 파일은 인라인 텍스트/base64 스트림으로 처리되며, 더 큰 파일은 자동으로 scp 기반 푸시/풀 작업을 트리거합니다.
  4. 이 스킬은 기본 SSH/SCP 명령을 래핑하는 Python 기반 보조 스크립트를 실행합니다.
  5. 결과는 JSON 페이로드로 반환되어 사용자에게 상태 업데이트 또는 파일 메타데이터를 제공합니다.

Tailnet SSH 파일 관리자 설정 가이드

Openclaw Skills 프레임워크 내에서 이 스킬을 활용하려면 환경이 다음 요구 사항을 충족하는지 확인하세요:

  1. 게이트웨이를 Tailnet에 연결합니다.
  2. 대상 노드에서 Tailscale SSH를 활성화하고 적절한 ACL을 구성합니다.
  3. 내장된 체크 도구를 사용하여 연결을 확인합니다:
python3 ./scripts/ssh_tunnel.py check --host <your-node-hostname>
  1. 전체 메타데이터 지원을 위해 원격 노드에 Python 3이 설치되어 있는지 확인합니다.

Tailnet SSH 파일 관리자 데이터 스키마 및 분류 체계

이 스킬은 Openclaw Skills 워크플로우와의 호환성을 보장하기 위해 모든 작업에 대해 구조화된 JSON 데이터를 반환합니다. 주요 메타데이터는 다음과 같습니다:

속성 설명
host 노드의 Tailscale 식별자(IP 또는 MagicDNS).
path 원격 파일 시스템의 절대 경로.
metadata 크기, 모드(권한), UID, GID 및 mtime을 포함합니다.
success 작업 결과를 나타내는 불리언 값.
error 작업 실패 시 자세한 오류 메시지.

Tailnet SSH 파일 관리자 고급 기능

  • 지능형 SCP 폴백: 페이로드 제한을 방지하기 위해 3KB보다 큰 파일의 경우 인라인 페이로드에서 scp로 자동 전환합니다.
  • 재귀적 작업: 복잡한 정리 또는 배포 작업을 위해 재귀적 디렉토리 복사 및 삭제를 지원합니다.
  • 다중 형식 읽기: 이진 호환성을 위해 원격 파일을 일반 텍스트 또는 base64 인코딩 문자열로 읽을 수 있습니다.
  • 도달 가능성 진단: 파일 작업을 시도하기 전에 연결 문제를 진단하기 위해 ssh_tunnel 도구와 통합됩니다.
  • 권한 관리: 시스템 보안 상태를 유지하기 위해 원격 chmod 및 stat 작업을 기본적으로 지원합니다.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*