Openclaw용 SSH Remote Control

AI 에이전트가 암호화된 SSH 터널을 통해 원격 Mac 또는 Linux 컴퓨터에 안전하게 연결하고 조작할 수 있게 해주는 강력한 에이전트리스 스킬입니다.

lixiang92229
v1.0.10
Mar 31, 2026
1
1.3k
0

설치 및 다운로드

1. ClawHub CLI

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

npx clawhub@latest install ssh-remote-control

2. 수동 설치

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

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

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

3. 프롬프트 설치

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

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

다운로드를 원하시나요?

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

SSH Remote Control란 무엇인가요?

Openclaw Skills의 SSH Remote Control 스킬은 클라우드 기반 AI 에이전트와 로컬 하드웨어 간의 간극을 메워줍니다. 표준 Secure Shell (SSH) 프로토콜을 활용하여 타겟 머신에 전용 에이전트 소프트웨어를 설치할 필요 없이 AI가 원격 Mac, Linux 또는 WSL 시스템에서 명령을 실행하고, 파일을 관리하며, 애플리케이션을 제어할 수 있도록 합니다.

이 방식은 보안과 간결함을 최우선으로 합니다. 업계 표준 SSH 키 인증을 사용하고 frp나 ngrok 같은 인트라넷 침투 도구와 결합할 수 있어, 사용자가 연결 개방 시점을 완벽하게 물리적으로 제어할 수 있습니다. 이는 원격 AI를 시스템 모니터링, 개발 작업, 심지어 AppleScript를 통한 macOS 전용 자동화까지 수행할 수 있는 실무 관리자로 변모시킵니다.

SSH Remote Control 활용 사례

  • 원격 사무실 관리: 모바일 기기의 AI 에이전트를 사용하여 워크플로우를 트리거하거나 사무실 Mac에서 파일을 검색합니다.
  • 스마트 홈 자동화: AI를 Raspberry Pi나 IoT 기기에 연결하여 로컬 자동화 스크립트를 실행합니다.
  • 교차 기기 조정: 단일 AI 인터페이스를 통해 여러 원격 서버나 워크스테이션을 중앙 집중식으로 관리합니다.
  • DevOps 및 시스템 관리: 로컬 CLI 접근 권한 없이도 원격 환경에서 시스템 리소스를 모니터링하거나, Git 상태를 확인하거나, Docker 컨테이너를 관리합니다.
  • macOS 자동화: AppleScript 통합을 사용하여 원격으로 애플리케이션을 실행하거나, 스크린샷을 캡처하거나, 브라우저 탭을 쿼리합니다.

SSH Remote Control 작동 원리

  1. 타겟 구성: 원격 컴퓨터가 SSH 접근을 허용하도록 구성되며, NAT 뒤에 있는 경우 침투 도구를 사용하여 공용 엔드포인트에 매핑됩니다.
  2. 키 생성: AI 서버가 신뢰 관계를 구축하기 위해 안전한 SSH 키 쌍(예: ED25519)을 생성합니다.
  3. 권한 부여: 공개 키가 원격 컴퓨터의 authorized_keys 파일에 추가되어 암호 없이 안전한 인증을 활성화합니다.
  4. 명령 실행: AI 에이전트가 SSH 터널을 통해 암호화된 명령을 보내고, 실시간 콘솔 출력을 수신하여 다음 행동을 결정합니다.
  5. 수명 주기 관리: 연결은 사용자가 제어하는 터널이나 SSH 서비스가 실행되는 동안만 유지되어 물리적 계층의 보안을 보장합니다.

SSH Remote Control 설정 가이드

원격 호스트 설정 (macOS)

  1. 시스템 설정 -> 공유에서 원격 로그인을 활성화합니다.
  2. AI의 공개 키를 ~/.ssh/authorized_keys에 추가합니다.

원격 호스트 설정 (Linux)

sudo apt install openssh-server
sudo systemctl enable ssh

환경 변수

Openclaw Skills 환경 내에서 다음 변수를 구성하세요:

  • SSH_TARGET_HOST: 원격 PC의 공용 IP 또는 도메인.
  • SSH_TARGET_PORT: SSH 포트(기본값 22).
  • SSH_TARGET_USER: 원격 사용자 이름.
  • SSH_KEY_PATH: 로컬 개인 키 파일 경로.

연결 테스트

ssh -i $SSH_KEY_PATH -p $SSH_TARGET_PORT $SSH_TARGET_USER@$SSH_TARGET_HOST 'echo "SSH Connection Successful"'

SSH Remote Control 데이터 스키마 및 분류 체계

이 스킬은 표준 Unix 스타일 명령 출력 및 파일 전송 프로토콜을 통해 데이터를 관리합니다. 전용 데이터베이스를 유지하지 않으며, 대신 원격 파일 시스템과 직접 상호 작용합니다.

데이터 유형 상호 작용 방법 저장 위치
시스템 메타데이터 sw_vers, df -h, top 휘발성 (AI 컨텍스트)
파일 scp, cat, ls 원격 파일 시스템
자동화 스크립트 osascript (macOS) 원격 시스템 이벤트
인증 SSH Keys 로컬 .ssh 디렉토리

SSH Remote Control 고급 기능

  • AppleScript 통합: Safari, Chrome, NetEase Music과 같은 macOS 앱에 대한 심층 제어.
  • 인트라넷 침투 지원: frp, ngrok, NATAPP과 호환되어 방화벽 뒤의 기기에 도달.
  • 세분화된 권한: authorized_keys에서 command= 제한을 지원하여 AI를 특정 스크립트로 제한.
  • 보안 터널링: 데이터는 제3자 클라우드 서버를 통해 라우팅되지 않으며, SSH 터널이 종단간 암호화를 제공함.
  • 물리적 격리: 로컬 침투 도구를 닫으면 AI 접근을 즉시 차단하는 '킬 스위치'가 생성됨.

SKILL.md


로드 중

관련 Openclaw 스킬

METADATA

Github Stars: 0
forks: 0

추천*