Skip to content

Commit b4a0de5

Browse files
author
박성모
committed
docs: step 5 — add Path B (direct docker-setup.sh) for manual install
1 parent e79c7c0 commit b4a0de5

1 file changed

Lines changed: 98 additions & 0 deletions

File tree

docs/GUIDE-MANUAL-INSTALL.md

Lines changed: 98 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -712,6 +712,19 @@ mv ~/openclaw-main ~/DEV/openclaw
712712
713713
### 5단계 — `openclaw` 첫 실행
714714

715+
> 🔀 **경로 선택**: 이 가이드는 두 가지 첫 실행 방법을 제공합니다.
716+
717+
| | **경로 A — 관리 도구 사용** | **경로 B — 수동 직접 실행** |
718+
|---|---|---|
719+
| 대상 | openclaw-workspace 도구로 나머지를 자동화 | openclaw 레포에서 직접 기동 |
720+
| 명령 위치 | `~/DEV/openclaw-workspace/openclaw-mgr/` | `~/DEV/openclaw/` |
721+
| 첫 명령 | `./openclaw doctor` | `./docker-setup.sh` |
722+
| 권장 대상 | 처음 설치하는 경우 | 이미 openclaw 레포를 직접 받은 경우 |
723+
724+
---
725+
726+
#### 경로 A — 관리 도구로 기동 (권장)
727+
715728
```bash
716729
cd ~/DEV/openclaw-workspace/openclaw-mgr
717730
./openclaw doctor
@@ -741,6 +754,43 @@ Disk free ✓ 60GB
741754

742755
브라우저로 **http://localhost:8000** 열기 → OpenClaw UI 등장.
743756

757+
---
758+
759+
#### 경로 B — 수동 직접 기동 (openclaw 레포를 직접 받은 경우)
760+
761+
> 이미 `git clone https://github.com/openclaw/openclaw.git ~/DEV/openclaw` 으로 본체를 받아뒀다면, `docker-setup.sh` 한 번으로 이미지 빌드 + 초기 설정 + 컨테이너 기동이 모두 됩니다.
762+
763+
```bash
764+
cd ~/DEV/openclaw
765+
766+
# ① 초기 설정 스크립트 실행 (인터랙티브 — 처음 한 번만)
767+
./docker-setup.sh
768+
```
769+
770+
스크립트가 순서대로:
771+
1. Docker 이미지를 로컬 빌드 (`DOCKER_BUILDKIT=1 docker build`)
772+
2. 초기 설정 파일(`.env`) 자동 생성
773+
3. 온보딩 안내 출력 (채널 연결 선택, 건너뛰어도 됨)
774+
4. `docker compose up -d openclaw-gateway` 로 컨테이너 기동
775+
776+
완료 후 확인:
777+
```bash
778+
docker compose ps # State=running 이면 OK
779+
docker compose logs -f --tail=50 # 로그 실시간 확인 (Ctrl+C 로 종료)
780+
```
781+
782+
브라우저로 **http://localhost:8000** → UI 등장.
783+
784+
> 💡 이후 일상적인 시작/종료는:
785+
> ```bash
786+
> cd ~/DEV/openclaw
787+
> docker compose up -d # 시작
788+
> docker compose down # 종료
789+
> docker compose logs -f # 로그
790+
> ```
791+
792+
브라우저로 **http://localhost:8000** 열기 → OpenClaw UI 등장.
793+
744794
### 5b단계 — `openclaw install` 없이 모든 것을 수동으로 (각 단계 이해)
745795
746796
> 🎯 `doctor` 끝에 **"⚠ N 개 항목이 미설정입니다 — './openclaw install' 로 자동 해결됩니다"** 가 보일 때, 자동에 의존하지 않고 **무엇이 일어나는지 정확히 알면서 직접 처리**하고 싶다면 이 절을 따라하세요.
@@ -1494,6 +1544,19 @@ If `~/DEV/openclaw` already exists, `./openclaw install` will skip the clone ste
14941544
14951545
### Step 5 — First run of `openclaw`
14961546

1547+
> 🔀 **Choose your path:**
1548+
1549+
| | **Path A — Use the management tool** | **Path B — Run directly (manual)** |
1550+
|---|---|---|
1551+
| For | Letting openclaw-workspace automate the rest | You already cloned the openclaw repo directly |
1552+
| Directory | `~/DEV/openclaw-workspace/openclaw-mgr/` | `~/DEV/openclaw/` |
1553+
| First command | `./openclaw doctor` | `./docker-setup.sh` |
1554+
| Best if | First-time install | You've already cloned `openclaw/openclaw` |
1555+
1556+
---
1557+
1558+
#### Path A — Start via management tool (recommended)
1559+
14971560
```bash
14981561
cd ~/DEV/openclaw-workspace/openclaw-mgr
14991562
./openclaw doctor
@@ -1521,6 +1584,41 @@ If everything is ✓:
15211584

15221585
Open **http://localhost:8000** in your browser → OpenClaw UI.
15231586

1587+
---
1588+
1589+
#### Path B — Direct first run (already cloned the openclaw repo)
1590+
1591+
> If you already ran `git clone https://github.com/openclaw/openclaw.git ~/DEV/openclaw`, one script handles everything: image build, initial config, and container startup.
1592+
1593+
```bash
1594+
cd ~/DEV/openclaw
1595+
1596+
# ① Run the setup script (interactive — one-time only)
1597+
./docker-setup.sh
1598+
```
1599+
1600+
The script will:
1601+
1. Build the Docker image locally (`DOCKER_BUILDKIT=1 docker build`)
1602+
2. Auto-generate the `.env` config file
1603+
3. Print onboarding info (channel connections optional — skip if you want)
1604+
4. Start the container: `docker compose up -d openclaw-gateway`
1605+
1606+
Verify after completion:
1607+
```bash
1608+
docker compose ps # State=running → OK
1609+
docker compose logs -f --tail=50 # Live logs (Ctrl+C to exit)
1610+
```
1611+
1612+
Open **http://localhost:8000** → UI appears.
1613+
1614+
> 💡 Day-to-day start/stop after this:
1615+
> ```bash
1616+
> cd ~/DEV/openclaw
1617+
> docker compose up -d # start
1618+
> docker compose down # stop
1619+
> docker compose logs -f # logs
1620+
> ```
1621+
15241622
### Step 5b — Skip `openclaw install` and do everything manually (understand each step)
15251623
15261624
> 🎯 When `doctor` ends with **"⚠ N items unconfigured — './openclaw install' will fix them"**, follow this section if you'd rather **understand exactly what happens** instead of letting the script run.

0 commit comments

Comments
 (0)