본문으로 건너뛰기

TClaw을 OpenClaw에 연결

1. 개요​

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

OpenClaw는 Linux, macOS 또는 Windows에 배포 될 수있는 오픈 소스 AI Agent 플랫폼입니다. 내장 게이트웨이 서비스는 포트 18789에 기본으로 듣고, TClaw는 로컬 네트워크에 연결(또는 인터넷).

** 연결 아키텍처:**

TClaw (IoT device)
    │  WebSocket (ACP protocol)
    ▼
OpenClaw Gateway (PC / server)
    │
    ▼
AI Agent (LLM conversation)

2. 필수품​

2.1 소프트웨어​

소프트웨어이름 *다운로드
**OpenClaw **AI Agent 플랫폼 - PC 또는 서버에 설치[공식 웹 사이트] (https://openclaw.ai)
** TClaw 펌웨어 툴체인 **컴파일 및 플래시 TClaw 펌웨어 필요TClaw 빠른 시작

2.2 네트워크 요구 사항​

  • LAN 모드: TClaw 장치 및 OpenClaw를 실행하는 PC는 동일한 로컬 네트워크 또는 Wi-Fi에 있습니다
  • 인터넷 모드: OpenClaw는 공용 IP 주소를 가진 서버에 배포됩니다.

2.3 TClaw 기본 설정​

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

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

3. OpenClaw 구성 파일 위치​

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

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

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

** Quick-open 폴더:**

전화:

xdg-open ~/.openclaw

** 파일 관리자:**

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

:::가격 .openclaw는 숨겨진 폴더 (KIPTERM1X와 함께 시작). 그것을 볼 수 없다면, 파일 관리자에서 Ctrl+H를 눌러 숨겨진 파일을 표시하십시오. :::

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

4.1 구성 파일을 백업​

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

4.2를 config 파일 편집​

전화:

nano ~/.openclaw/openclaw.json

** 파일 관리자:**

  1. ~/.openclaw 폴더를 엽니다 (서 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
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    }
  }
}

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

** 서류:**

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

4.4 게이트웨이를 재시작​

openclaw gateway restart

:::기사 openclaw 명령이 유효하지 않은 경우, 완전히 종료하고 OpenClaw 응용 프로그램을 다시 시작합니다. :::

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 게이트웨이 토큰 받기​

토큰은 gateway.auth.token의 openclaw.json에 저장됩니다.

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

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

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

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

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

** 서류:**

제품정보이름 *
OPENCLAW_GATEWAY_HOST를OpenClaw를 실행하는 기계의 LAN IP (섹션 5.1에서)
OPENCLAW_GATEWAY_PORT를18789에 조정, 필요 변화 없음
OPENCLAW_GATEWAY_TOKEN를섹션에서 토큰 5.2
DUCKYCLAW_DEVICE_ID를장치 이름; 고유 식별자를 사용 (예: MAC 주소)

6.3 Recompile와 섬광​

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

7. 문제 해결​

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

장치 로그에 오류자주 묻는 질문수정하기
acp tcp connect failed를차단되는 IP 또는 항구IP를 확인; 포트 18789 방화벽에서 허용
acp upgrade rejected를WebSocket Handhake 거부dangerouslyAllowHostHeaderOriginFallback: true가 설정되고 게이트웨이가 재시작
acp connect res ok=false를토큰 mismatchopenclaw.json를 검증 토큰 일치 펌웨어 OPENCLAW_GATEWAY_TOKEN 정확히
acp connect timeout를네트워크 문제 또는 Gateway가 실행되지 않음OpenClaw를 실행 확인; 브라우저에서 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을 포함한 모든 인터페이스에 성공적으로 연결됩니다.

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

** ufw: **

sudo ufw allow 18789/tcp

방화:

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

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

  • 올바른 파일 편집 확인 (경로를 위해 섹션 3 참조)
  • 게이트웨이를 완전히 재시작 (페이지를 새로 고침하지 않음): openclaw gateway restart
  • 아직 작동하지 않는 경우, 완전히 종료하고 OpenClaw 응용 프로그램을 다시 시작