@chija/openclaw

Thin OpenClaw Native Plugin that connects OpenClaw agents to ChiJa using the provider-neutral ChiJa Agent Protocol (@chija/agent-sdk).

This plugin is an adapter only. Pairing, HTTPS/WSS, reconnect, idempotency, lifecycle, and receipt HTTP calls live in the common SDK — not reimplemented here.

Supported OpenClaw

| Plugin | Verified OpenClaw | |--------|-------------------| | @chija/[email protected] | 2026.9.3, 2026.9.4 |

Unsupported hosts fail closed with OPENCLAW_VERSION_UNSUPPORTED.

See COMPATIBILITY.md.

Install

사람용 안내: https://app.chija.io/connect/openclaw
machine-readable: /.well-known/chija-agent-bootstrap.json

# Preferred when published
openclaw plugins install npm:@chija/[email protected] --pin

# Local / no npm publish
cd packages/openclaw && make pack
openclaw plugins install npm-pack:/absolute/path/to/chija-openclaw-1.0.0-beta.10.tgz --force

Require Node >=24.16 (OpenClaw engine constraint).

Publish

npm login 후 npm whoami가 isulnara인지 확인합니다. 로그인이 거절되면 npm publish는 404로 끝납니다.

cd packages/openclaw
./scripts/publish.sh                 # beta 태그만
./scripts/publish.sh --also-latest   # 배포 후 latest 태그를 이 버전으로 이동

같은 tarball을 --tag latest로 한 번 더 npm publish 하지 않습니다. 두 번째 배포는 거절됩니다.

Connect (Guided Device Pairing)

OpenClaw 메인 Agent에게 공식 URL을 전달하거나 Setup Tool을 호출합니다.

이 URL을 확인하고 ChiJa에 연결해줘.
https://app.chija.io/connect/openclaw

또는:

openclaw chija-agent connect \
  --base-url https://api.example.com \
  --gateway-instance-id gw-01

Plugin이 로컬 Agent를 발견하고 Device Pairing을 시작합니다. 짧은 userCode와 승인 URL만 표시됩니다. ChiJa에 로그인한 ADMIN이 /agent/device에서 Agent별 Member 매핑을 승인한 뒤, Plugin이 Agent별 Credential을 받아 저장하고 live-verify합니다.

• deviceCode / raw Credential은 채팅·로그에 노출하지 않습니다.
• Agent별 Credential fallback 금지 (main 기본값 없음).
• Gateway 재시작 시 저장된 binding으로 자동 재연결합니다.
• 페어링·CLI connect 후에는 bindings 감시가 Gateway 재시작 없이 ChiJa WebSocket을 올립니다.
• live-verify는 HTTPS 바인딩만 확인하며 WSS를 CONNECTED로 표시하지 않습니다.

Gateway 재시작 보고 (Plugin 설치·업그레이드 시에만)

Plugin 설치·업그레이드로 호스트가 새 코드를 로드할 때만 Gateway를 재시작합니다. 페어링만으로는 재시작하지 않습니다. 재시작할 때 Agent는 대화창에 재시작 전 안내 → 재시작 → 완료 보고 순서를 지킵니다. 문구·수동 명령은 https://app.chija.io/connect/openclaw 및 ops user guide와 동일합니다.

# 재시작 직전
게이트웨이를 재시작합니다. 3분 후에도 제가 '게이트웨이 재시작을 완료했습니다.'라고 보고하지 않으면 문제가 생긴 것이니 아래 명령으로 직접 게이트웨이를 재시작하여 주시기 바랍니다.

openclaw gateway restart

# 재시작 성공 후
게이트웨이 재시작을 완료했습니다.

openclaw chija-agent live-verify --gateway-instance-id gw-01 --agent main
openclaw chija-agent status --gateway-instance-id gw-01

Debug only

일회용 chj_pair_ 코드 교환은 Hermes 호환/진단용입니다.

openclaw chija-agent connect ... --agent main --legacy-pairing-code

Do not paste pairing codes or device codes into chat.

Configuration

| Key | Meaning | |-----|---------| | baseUrl | ChiJa API HTTPS origin | | gatewayInstanceId | Stable gateway id used in bindings | | stateDir | Optional binding store directory |

Setup Tool

chija_connect — discovers agents, starts Device Authorization, shows userCode + verification URI, polls, stores credentials, live-verifies.