Matrix 채널 설정
OpenClaw와 Matrix 분산형 메신저를 연동하는 방법을 안내합니다.
개요
Matrix는 분산형 오픈 메신저 프로토콜입니다:
- 중앙 서버 없이 운영 가능 (자체 호스팅)
- Element 등 다양한 클라이언트 지원
- E2E 암호화 지원
- 프라이버시 중시
요구사항
- Matrix 계정 (matrix.org 또는 자체 서버)
- 봇 전용 Matrix 계정 생성 권장
1단계: 봇 계정 생성
matrix.org에서 봇 전용 계정을 만들거나 자체 homeserver에서 생성합니다.
2단계: Access Token 발급
# curl로 로그인하여 access token 발급
curl -XPOST \
'https://matrix.org/_matrix/client/r0/login' \
--data-raw '{"type":"m.login.password","user":"@mybot:matrix.org","password":"bot-password"}'
# 응답에서 access_token 복사
3단계: OpenClaw 설정
{
"channels": {
"matrix": {
"enabled": true,
"homeserverUrl": "https://matrix.org",
"accessToken": "your-matrix-access-token",
"userId": "@mybot:matrix.org",
"rooms": ["!roomid:matrix.org"]
}
}
}
# 환경 변수로 설정
export MATRIX_HOMESERVER_URL="https://matrix.org"
export MATRIX_ACCESS_TOKEN="your-access-token"
특정 방(Room) 설정
{
"channels": {
"matrix": {
"allowedRooms": ["!roomid1:matrix.org", "!roomid2:matrix.org"],
"allowAll": false
}
}
}
자체 홈서버 사용
{
"channels": {
"matrix": {
"homeserverUrl": "https://your-matrix-server.com",
"accessToken": "your-access-token",
"userId": "@mybot:your-matrix-server.com"
}
}
}
트러블슈팅
인증 오류
access token이 만료되지 않았는지 확인하고 재발급합니다.
방에 참여 불가
봇 계정이 해당 방에 초대받지 않은 경우, 방 관리자에게 초대를 요청합니다.
참고: