openclaw channels

게이트웨이에서 채팅 채널 계정과 런타임 상태를 관리합니다.

관련 문서:

일반 명령어

openclaw channels list
openclaw channels status
openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123
openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels logs --channel all

계정 추가 / 제거

openclaw channels add --channel telegram --token <bot-token>
openclaw channels remove --channel telegram --delete

팁: openclaw channels add --help로 채널별 플래그(토큰, 앱 토큰, signal-cli 경로 등)를 확인할 수 있습니다.

플래그 없이 openclaw channels add를 실행하면 대화형 마법사가 다음을 안내합니다:

  • 선택한 채널별 계정 ID
  • 해당 계정의 선택적 표시 이름
  • 구성된 채널 계정을 지금 에이전트에 바인딩하시겠습니까?

지금 바인딩을 확인하면, 마법사는 각 구성된 채널 계정을 소유할 에이전트를 묻고 계정 범위 라우팅 바인딩을 기록합니다.

나중에 openclaw agents bindings, openclaw agents bind, openclaw agents unbind로 동일한 라우팅 규칙을 관리할 수도 있습니다(agents 참조).

아직 단일 계정 최상위 설정(channels.<channel>.accounts 항목 없음)을 사용하는 채널에 기본이 아닌 계정을 추가하면, OpenClaw은 계정 범위 단일 계정 최상위 값을 channels.<channel>.accounts.default로 이동한 다음 새 계정을 기록합니다. 이렇게 하면 멀티 계정 구조로 전환하면서 원래 계정 동작이 유지됩니다.

라우팅 동작은 일관되게 유지됩니다:

  • 기존 채널만 바인딩(accountId 없음)은 기본 계정에 계속 매칭됩니다.
  • channels add는 비대화형 모드에서 바인딩을 자동 생성하거나 재작성하지 않습니다.
  • 대화형 설정에서 선택적으로 계정 범위 바인딩을 추가할 수 있습니다.

설정이 혼합 상태(이름이 지정된 계정이 있고, default가 누락되고, 최상위 단일 계정 값이 설정된 상태)인 경우, openclaw doctor --fix를 실행하여 계정 범위 값을 accounts.default로 이동하세요.

로그인 / 로그아웃 (대화형)

openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp

문제 해결

  • 전반적인 점검은 openclaw status --deep를 실행하세요.
  • 안내된 수정은 openclaw doctor를 사용하세요.
  • openclaw channels list가 Claude: HTTP 403 ... user:profile을 출력 → 사용량 스냅샷에 user:profile 범위가 필요합니다. --no-usage를 사용하거나, claude.ai 세션 키(CLAUDE_WEB_SESSION_KEY / CLAUDE_WEB_COOKIE)를 제공하거나, Claude Code CLI를 통해 재인증하세요.
  • openclaw channels status는 게이트웨이에 접근할 수 없을 때 설정 전용 요약으로 폴백합니다. 지원되는 채널 자격 증명이 SecretRef로 구성되어 있지만 현재 명령어 경로에서 사용할 수 없는 경우, 구성되지 않은 것으로 표시하는 대신 성능 저하 참고와 함께 구성됨으로 보고합니다.

기능 점검

프로바이더 기능 힌트(사용 가능한 경우 인텐트/범위)와 정적 기능 지원을 가져옵니다:

openclaw channels capabilities
openclaw channels capabilities --channel discord --target channel:123

참고:

  • --channel은 선택 사항입니다; 생략하면 모든 채널(확장 프로그램 포함)을 나열합니다.
  • --target은 channel:<id> 또는 순수 숫자 채널 ID를 받으며 Discord에만 적용됩니다.
  • 점검은 프로바이더별로 다릅니다: Discord 인텐트 + 선택적 채널 권한; Slack 봇 + 사용자 범위; Telegram 봇 플래그 + 웹훅; Signal 데몬 버전; MS Teams 앱 토큰 + Graph 역할/범위(알려진 경우 주석 포함). 점검이 없는 채널은 Probe: unavailable을 보고합니다.

이름을 ID로 해석

프로바이더 디렉토리를 사용하여 채널/사용자 이름을 ID로 해석합니다:

openclaw channels resolve --channel slack "#general" "@jane"
openclaw channels resolve --channel discord "My Server/#support" "@someone"
openclaw channels resolve --channel matrix "Project Room"

참고:

  • --kind user|group|auto로 대상 유형을 강제할 수 있습니다.
  • 동일한 이름을 가진 여러 항목이 있을 때 활성 매칭을 우선합니다.
  • channels resolve는 읽기 전용입니다. 선택된 계정이 SecretRef로 구성되어 있지만 현재 명령어 경로에서 해당 자격 증명을 사용할 수 없는 경우, 전체 실행을 중단하는 대신 참고와 함께 성능 저하된 미해석 결과를 반환합니다.
arrow_back
이전
Browser
다음
Clawbot
arrow_forward