본문으로 건너뛰기

TClaw을 TuyaClaw에 연결

1. 개요​

TClaw (이전 DuckyClaw)는 IoT 장치에서 실행되는 AI 음성 조수 펌웨어입니다. **ACP 프로토콜 (Agent 클라이언트 프로토콜, WebSocket 기반)**을 통해 TuyaClaw 게이트웨이에 연결하여 AI Agent와 실시간 대화를 가능하게 합니다.

TuyaClaw는 AI Agent 데스크톱 클라이언트이며, Windows, macOS 및 Linux에서 사용할 수 있습니다. OpenClaw 코어를 포함하고 TClaw가 연결되는 Gateway Service (기본 포트 18789)를 노출합니다.

** 연결 아키텍처:**

TClaw (IoT device)
    │  WebSocket (ACP protocol)
    ▼
TuyaClaw Gateway (PC)
    │  Built-in OpenClaw core
    ▼
AI Agent (LLM conversation)

**TuyaClaw 아키텍처: **

제품정보이름 *
Electron 포탄TuyaClaw 신청; 크롬 연출자는 UI를 호스트합니다
OpenClaw 핵심설치 디렉토리에 resources/openclaw/에 위치; 오픈 소스 OpenClaw와 동일
Gateway 서비스내장 ACP WebSocket 서버, 기본 포트 18789
Config 디렉토리~/.tuyaclaw/ (Linux / macOS) 또는 C:\Users\<username>\.tuyaclaw\ (Windows)

2. 필수품​

2.1 소프트웨어​

소프트웨어이름 *다운로드
**TuyaClaw **AI Agent 플랫폼 (Windows / macOS / Linux)[공식 웹 사이트] (https://claw.tuya.ai/)
** TClaw 펌웨어 툴체인 **컴파일 및 플래시 TClaw 펌웨어 필요TClaw 빠른 시작

2.2 네트워크 요구 사항​

  • TClaw 장치 및 TuyaClaw를 실행하는 PC는 ** 동일한 LAN ** 또는 Wi-Fi 네트워크에 있어야 합니다
  • 인터넷 연결을 위해, 항구 운송 또는 유사한을 통해 TuyaClaw 게이트웨이를 노출

2.3 TClaw 기본 설정​

이 가이드를 따르기 전에 TClaw 기본 설정 (Wi-Fi, 펌웨어 번쩍이는)을 완료하십시오.

:::기사 참조 : [TClaw 빠른 시작 (T5-AI)] (ducky-quick-start-T5AI) :::

3. TuyaClaw 구성 파일 위치​

핵심 구성 파일은 openclaw.json입니다. 기본 경로는 운영 체제에 따라 다릅니다.

지원하다Config 파일 경로
**Linux **~/.tuyaclaw/openclaw.json를
**macOS **~/.tuyaclaw/openclaw.json를
**Windows **C:\Users\<username>\.tuyaclaw\openclaw.json를

:::기사 ~는 현재 사용자의 홈 디렉토리, 예를 들어 /home/username (Linux) 또는 /Users/username (macOS)를 나타냅니다. Windows에서 로그인 이름을 가진 <username>를 대체합니다. :::

TuyaClaw는 또한 UI의 토큰을 저장하는 전자 설정 파일이 있습니다.

지원하다Electron 설정 경로
**Linux **~/.config/tuyaclaw/settings.json를
**macOS **~/Library/Application Support/tuyaclaw/settings.json를
**Windows **C:\Users\<username>\AppData\Roaming\tuyaclaw\settings.json를

** Quick-open 폴더:**

전화:

xdg-open ~/.tuyaclaw

** 파일 관리자:**

파일 관리자를 열고, Ctrl+L를 누르고, ~/.tuyaclaw를 입력하고 Enter 키를 누릅니다.

:::가격 .tuyaclaw는 숨겨진 폴더 (KIPTERM1X와 함께 시작). Ctrl+H를 눌러 숨겨진 파일을 표시하십시오. :::

4. TuyaClaw 게이트웨이 구성 변경​

4.1 구성 파일을 백업​

cp ~/.tuyaclaw/openclaw.json ~/.tuyaclaw/openclaw.json.backup

4.2를 config 파일 편집​

전화:

nano ~/.tuyaclaw/openclaw.json

** 파일 관리자:**

  1. ~/.tuyaclaw 폴더를 엽니다 (서 3)
  2. Right-click openclaw.json → **텍스트 편집기로 열기 **

4.3 게이트웨이 구성 섹션 업데이트​

"gateway" 필드를 찾아 다음으로 교체하십시오 (다른 설정이 변경되지 않음) :

"gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan",
    "auth": {
        "mode": "token",
        "token": "your_token_here"
    },
    "controlUi": {
        "dangerouslyAllowHostHeaderOriginFallback": true,
        "allowInsecureAuth": true,
        "dangerouslyDisableDeviceAuth": true
    }
}

:::대여 "token" 필드의 기존 값 유지. your_token_here를 말 그대로 쓰지 마십시오. 실제 토큰으로 교체하십시오. ( 섹션 5.2). :::

** 서류:**

제품정보이름 *
"bind": "lan"를127.0.0.1 대신 LAN 네트워크 인터페이스에서 게이트웨이를 듣게 됩니다. ** TClaw에 연결하려면**가 필요합니다.
dangerouslyAllowHostHeaderOriginFallback: true를WebSocket 연결을 열려면 non-UI 클라이언트(예: IoT 장치)를 허용
allowInsecureAuth: true를HTTPS(LAN 시나리오) 없이 인증 가능
dangerouslyDisableDeviceAuth: true를장치 수준 이차 입증을 비활성화; 토큰 전용 오

4.4 TuyaClaw 게이트웨이 재시작​

config를 저장한 후, 변경 사항에 대한 게이트웨이를 다시 시작합니다.

** CLI에서: **

~/.config/tuyaclaw/resources/cli/openclaw gateway restart

** 또는:** TuyaClaw 트레이 아이콘 → Quit를 마우스 오른쪽 버튼으로 클릭한 다음 TuyaClaw를 다시 시작하세요.

5. IP 주소 및 토큰 받기​

1 니다. LAN IP 주소 받기​

ip addr show | grep -E "inet " | awk '{print $2}' | cut -d'/' -f1 | grep -v "^127"

또는:

hostname -I

:::가격 **same LAN 세그먼트 **에 IP 주소를 사용하여 TClaw 장치 (일반적으로 192.168.x.x 또는 10.x.x.x). 유선 이더네트 연결은 Wi-Fi 보다는 안정되어 있습니다. :::

5.2 게이트웨이 토큰 받기​

grep '"token"' ~/.tuyaclaw/openclaw.json

또는 정확한 값을 읽으십시오:

python3 -c "import json; d=json.load(open('$HOME/.tuyaclaw/openclaw.json')); print(d['gateway']['auth']['token'])"

5.3 게이트웨이 접근성 검증​

TClaw와 같은 네트워크의 장치에 브라우저를 열고 방문:

http://<your-LAN-IP>:18789/

모든 HTTP 응답 (실버 페이지 일)는 게이트웨이가 LAN 주소에 들리는 것을 의미합니다. 연결이 꺼지면 방화벽을 확인하십시오 (제 7 조 참조).

6. TClaw 펌웨어 구성​

6.1 config 파일 생성​

DuckyClaw 프로젝트 루트 디렉토리에서 예제 파일을 복사하고 이름을 변경하십시오.

cp include/tuya_app_config_secrets.h.example include/tuya_app_config_secrets.h

:::기사 tuya_app_config_secrets.h는 .gitignore에 목록으로 만들고 버전 통제에 투입되지 않을 것입니다. 민감한 구성을 저장하는 것이 좋습니다. :::

# # 6.2 # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # # config 파일 편집​

include/tuya_app_config_secrets.h를 열고 ACP 게이트웨이 매크로를 채우십시오.

/* openclaw / tuyaclaw gateway configuration */
#define OPENCLAW_GATEWAY_HOST            "xxx.xxx.xxx.xxx"   /* Replace with TuyaClaw host LAN IP */
#define OPENCLAW_GATEWAY_PORT            18789
#define OPENCLAW_GATEWAY_TOKEN           "xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"  /* Replace with Token from Section 5.2 */
#define DUCKYCLAW_DEVICE_ID              "duckyclaw-001"     /* Device ID, customizable */

** 서류:**

제품정보이름 *
OPENCLAW_GATEWAY_HOST를TuyaClaw를 실행하는 기계의 LAN IP (섹션 5.1에서)
OPENCLAW_GATEWAY_PORT를18789에 조정, 필요 변화 없음
OPENCLAW_GATEWAY_TOKEN를섹션에서 토큰 5.2
DUCKYCLAW_DEVICE_ID를장치 이름; TuyaClaw에 있는 다수 장치를 구별하는 유일한 식별자 (예를들면 MAC 주소)를 사용하십시오

6.3 Recompile와 섬광​

구성을 저장 한 후, 펌웨어를 제거하고 TClaw 장치에 깜박입니다.

7. 문제 해결​

7.1 TClaw는 연결할 수 없습니다​

장치 로그에 오류자주 묻는 질문수정하기
acp tcp connect failed를차단되는 IP 또는 항구IP 확인; 포트 18789 방화벽에서 허용
acp upgrade rejected를WebSocket Handhake는 Gateway에 의해 거부dangerouslyAllowHostHeaderOriginFallback: true가 설정되고 게이트웨이가 재시작
acp connect res ok=false를토큰 mismatchopenclaw.json를 검증 토큰 일치 펌웨어 OPENCLAW_GATEWAY_TOKEN 정확히
acp connect timeout를네트워크 문제 또는 Gateway가 실행되지 않음TuyaClaw를 실행 확인; 브라우저에서 http://<IP>:18789/를 방문
acp dns resolve failed를호스트명은 해결할 수 없습니다.호스트 이름 대신 IP 주소를 사용합니다.

7.2 Verify 게이트웨이는 LAN 주소에 있습니다.​

netstat -tlnp | grep 18789
# or
ss -tlnp | grep 18789

Local Address가 0.0.0.0:18789를 보여주면 Gateway는 LAN을 포함한 모든 인터페이스에 성공적으로 연결됩니다.

127.0.0.1:18789를 보여주는 경우, bind: lan는 영향을받지 않았습니다 — openclaw.json 편집 및 재시작 TuyaClaw.

7.3 방화벽에서 포트 18789 열기​

** ufw: **

sudo ufw allow 18789/tcp

방화:

sudo firewall-cmd --add-port=18789/tcp --permanent
sudo firewall-cmd --reload

7.4 Config는 효력을 가지고 가지 않는 변화합니다​

  • 올바른 openclaw.json 파일 편집 확인 (경로를 위해 섹션 3 참조)
  • JSON는 유효하다 - 필요한 경우 온라인 JSON 검증기를 사용하십시오
  • 게이트웨이를 완전히 재시작하십시오 (KipTERM1X 과정과 재시작이 필요하면 페이지를 새로 고침하지 마십시오)

7.5 OpenClaw에 연결의 차이​

제품 정보OpenClaw를TuyaClaw를
지원되는 OSLinux / macOS / WindowsLinux / macOS / Windows
Core config 파일~/.openclaw/openclaw.json를~/.tuyaclaw/openclaw.json를
기본 Gateway 바인딩local (케터M1X로 변경)local (케터M1X로 변경)
항구 항구1878918789 (사임)
토큰 받기grep '"token"' ~/.openclaw/openclaw.json를grep '"token"' ~/.tuyaclaw/openclaw.json를
휴식 게이트웨이openclaw gateway restart를TuyaClaw UI 또는 내장 CLI
TClaw 펌웨어 구성같은 매크로같은 매크로