#openclaw#web-ui#configuration#setup#bindings

설정 파일을 만지지 않아도 된다: Web UI 만으로 OpenClaw 설정하기

5 min read

너무 많은 튜토리얼이 첫날부터 JSON 을 수정하라고 하고, 초보자가 도망가면 왜 그런지 궁금해합니다. 좋은 소식은 이겁니다. 클릭할 수 있는 UI 가 있습니다.

이번 글에서 배울 것

  • Web UI 를 열고 인증 마치기
  • 폼 모드와 Raw JSON 모드의 차이 이해하기
  • UI 에서 여러 Workspace 라우팅 설정하기
  • 주요 기능 위치 파악하기

Web UI 열기

1단계: Gateway 가 실행 중인지 확인

openclaw gateway

2단계: 브라우저 열기

http://127.0.0.1:18789/

basePath 를 예를 들어 /openclaw 로 설정했다면:

http://127.0.0.1:18789/openclaw

3단계: 인증 처리

화면 해결 방법
pairing required openclaw devices list 후 openclaw devices approve <requestId>
token 요청 온보딩 token 붙여넣기

💡 UI 언어는 Access 섹션에서 바꿀 수 있습니다.

Config 편집 방식 두 가지: 폼 모드 vs Raw JSON

Config 페이지에 들어가면 두 가지 방식이 보입니다.

폼 모드: 보기 좋고 입력 필드가 잘 정리되어 있어 초보자나 소규모 수정에 적합합니다.

Raw JSON 모드: 설정 파일을 직접 수정하므로 고급 사용자나 큰 수정에 적합합니다.

둘 다 같은 파일 ~/.openclaw/openclaw.json 을 편집합니다.

가장 흔한 설정: Telegram 그룹마다 다른 비서 쓰기

시나리오 A: 같은 봇, 다른 그룹, 다른 워크스페이스

Raw JSON 으로 전환한 뒤 다음 구조를 추가합니다.

{
  "agents": {
    "list": [
      { "id": "main",      "name": "Main",      "workspace": "~/.openclaw/workspace-main",      "default": true },
      { "id": "project-a", "name": "Project A", "workspace": "~/.openclaw/workspace-project-a" },
      { "id": "project-b", "name": "Project B", "workspace": "~/.openclaw/workspace-project-b" }
    ]
  },
  "bindings": [
    { "agentId": "project-a", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1001234567890" } } },
    { "agentId": "project-b", "match": { "channel": "telegram", "peer": { "kind": "group", "id": "-1009876543210" } } },
    { "agentId": "main",      "match": { "channel": "telegram" } }
  ],
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your bot token",
      "dmPolicy": "pairing",
      "groups": { "*": { "requireMention": true } }
    }
  }
}

그룹 ID 찾는 방법

  • 방법 1: 그룹에 메시지를 보내고 openclaw logs --follow 로 chat.id 확인
  • 방법 2: 메시지를 @userinfobot 에 전달

시나리오 B: Bot 계정마다 다른 Workspace

{
  "agents": {
    "list": [
      { "id": "main",   "workspace": "~/.openclaw/workspace-main" },
      { "id": "alerts", "workspace": "~/.openclaw/workspace-alerts" }
    ]
  },
  "bindings": [
    { "agentId": "main",   "match": { "channel": "telegram", "accountId": "default" } },
    { "agentId": "alerts", "match": { "channel": "telegram", "accountId": "alerts" } }
  ],
  "channels": {
    "telegram": {
      "accounts": {
        "default": { "botToken": "123456:ABC...", "dmPolicy": "pairing" },
        "alerts":  { "botToken": "987654:XYZ...", "dmPolicy": "allowlist", "allowFrom": ["tg:123456789"] }
      }
    }
  }
}

저장을 잊지 마세요

Save / Apply 를 누르면 OpenClaw 가 다음을 수행합니다.

  1. 설정 형식 검증
  2. 적용. 보통은 핫 리로드

⚠️ baseHash conflict 가 뜨면 다른 곳에서 설정이 바뀐 것입니다. 다시 불러오고 재시도하세요.

Web UI 로 또 무엇을 할 수 있을까?

섹션 할 수 있는 일
Chat 브라우저에서 바로 비서와 대화
Sessions 세션 확인 및 관리
Cron 예약 작업 추가, 수정, 즉시 실행
Skills Skill 활성화, 비활성화, 설치
Channels 채널 상태 확인
Debug / Logs 로그 확인과 수동 RPC 실행

빠른 참고표

내가 하고 싶은 것 Web UI 에서 찾는 위치
Telegram 그룹마다 다른 Workspace 연결 Config → Raw JSON → agents + bindings
Bot 계정마다 다른 Workspace 연결 Config → channels.telegram.accounts + bindings
Bot Token 변경 Config → channels.telegram.botToken
스케줄 관리 Cron 탭
실시간 로그 보기 Debug / Logs 탭

핵심은 이것입니다. Workspace 라우팅은 항상 agents 와 bindings 가 결정 합니다. Web UI 는 그걸 더 편하게 편집하게 해 줄 뿐입니다.

관련 글