OpenClaw 설정 가이드
Ami에게 데스크톱 제어 기능을 — 메모, 리마인더, 캘린더, 음악 등.
사전 요구 사항
macOS 는 Apple Notes, 리마인더, 캘린더, 음악 도구에 필요합니다.
Node.js 22+ — 확인: node --version
Node 22+가 없는 경우:
brew install node@22OpenClaw 설치
터미널에서 설치 스크립트를 실행하세요:
curl -fsSL https://openclaw.ai/install.sh | bashCLI가 설치되고 설정 마법사가 자동으로 시작됩니다.
설치 확인
openclaw doctoropenclaw 을 찾을 수 없으면 PATH에 추가하세요:
echo 'export PATH="$(npm prefix -g)/bin:$PATH"' >> ~/.zshrc
source ~/.zshrc게이트웨이 시작
설정 마법사가 백그라운드 데몬을 설치합니다. 실행 확인:
openclaw gateway status수동으로 시작해야 하는 경우:
openclaw gateway --port 18789게이트웨이 토큰 찾기
토큰은 ~/.openclaw/openclaw.json 의 gateway.auth.token. 확인 명령:
cat ~/.openclaw/openclaw.json | grep '"token"' | head -1Ami를 OpenClaw에 연결
- Ami 앱을 열고 설정으로 이동
- 고급 섹션까지 스크롤
- OpenClaw Gateway 확장
- 필드 입력:
| 필드 | 값 |
|---|---|
| 게이트웨이 URL | ws://127.0.0.1:18789 |
| 게이트웨이 토큰 | (2단계의 토큰 붙여넣기) |
5. 웹 채팅을 OpenClaw을 통해 라우팅 활성화
6. 저장 클릭
선택적 설정
| 설정 | 기능 |
|---|---|
| 아이덴티티 동기화 | Ami의 이름과 성격을 게이트웨이에 전송 |
| 메모리 가져오기 | 캐릭터 로드 시 워크스페이스에서 메모리 가져오기 |
| 메모리 보내기 | 10분마다 앱 메모리를 워크스페이스에 자동 동기화 |
에이전트 워크스페이스 설정
OpenClaw은 워크스페이스 폴더를 사용합니다. 기본 경로: ~/.openclaw/workspace-ami/
두 개의 파일이 필요합니다:
SOUL.md — 성격
이 파일은 앱에서 자동 동기화됩니다. Ami의 성격과 응답 방식을 정의합니다.
~/.openclaw/workspace-ami/SOUL.mdTOOLS.md — 도구 지침
Ami의 macOS 도구 사용 치트시트. 이미 설정되어 있을 것입니다.
~/.openclaw/workspace-ami/TOOLS.md파일에는 osascript 명령이 포함되어 있습니다.
사용 가능한 도구
연결 후, Ami에게 다음을 요청할 수 있습니다:
Apple 메모
“장보기 목록 메모 작성해줘”
“주말 계획 제목으로 메모 저장”
리마인더
“오후 3시에 치과 전화 리마인더”
“내일 식물 물주기 리마인더”
캘린더
“오늘 일정이 뭐야?”
“금요일 오후 2시에 Jake 미팅 추가”
음악
“음악 틀어줘”
“음악 일시정지”
“다음 곡”
“지금 뭐 재생 중이야?”
시스템 컨트롤
“다크 모드 전환”
“5분 타이머 설정”
“배터리 잔량?”
앱 & URL 열기
“Safari 열어줘”
“twitter.com 열어줘”
문제 해결
OpenClaw 업데이트
npm update -g openclaw또는 설치 프로그램 재실행:
curl -fsSL https://openclaw.ai/install.sh | bash아키텍처
궁금하신 분들을 위해 — Ami가 데스크톱과 통신하는 방법:
┌──────────────┐ WebSocket ┌──────────────────┐ osascript ┌──────────────┐
│ Ami App │ ──────────────────► │ OpenClaw Gateway │ ────────────────► │ macOS APIs │
│ (browser) │ ◄────────────────── │ (localhost) │ ◄──────────────── │ Notes, Music │
│ │ SSE streaming │ Port 18789 │ tool results │ Calendar etc │
└──────────────┘ └──────────────────┘ └──────────────┘
│
┌──────┴──────┐
│ Workspace │
│ SOUL.md │
│ TOOLS.md │
└─────────────┘1. 브라우저에서 Ami에게 메시지 전송
2. 앱이 도구 요청을 감지하고 미리보기 카드를 즉시 표시
3. 메시지가 WebSocket을 통해 OpenClaw 게이트웨이로 라우팅
4. 게이트웨이 에이전트가 TOOLS.md를 읽고 적절한 osascript 명령 실행
5. 에이전트가 확인으로 응답하고, Ami가 사용자에게 전달