Forem: ageofclick

Synology NAS에 OpenClaw 설치하기

ageofclick — Wed, 20 May 2026 04:12:45 +0000

들어가며

이번 글에서는 Synology NAS에 OpenClaw를 Docker Compose 기반으로 신규 설치하는 과정을 정리한다.

Synology DSM 환경은 일반적인 Ubuntu 서버와 다르다. NAS에 직접 Node.js/npm 기반으로 OpenClaw를 설치할 수도 있지만, 장기 운영 관점에서는 Docker Compose 기반 구성이 더 깔끔하다.

Docker Compose로 구성하면 다음 장점이 있다.

OpenClaw 실행 환경을 Synology host와 분리할 수 있음
gateway와 CLI 실행 환경을 일관되게 유지할 수 있음
재부팅 후 자동 실행을 restart: unless-stopped로 처리할 수 있음
.openclaw 설정과 workspace를 volume으로 분리해 보존할 수 있음
GitHub CLI, ripgrep, jq 같은 코딩 작업용 도구를 이미지에 함께 포함할 수 있음
Synology 터미널의 TTY/리치 출력 문제를 우회하기 쉬움

최종 구성

최종 디렉터리 구조는 다음과 같이 잡는다.

/volume1/docker/openclaw
├── docker-compose.yml
├── Dockerfile
├── .env
└── .openclaw/
    ├── workspace/
    ├── logs/
    └── cron/

컨테이너 내부에서는 OpenClaw 설정 경로를 다음처럼 사용한다.

/home/node/.openclaw
/home/node/.openclaw/workspace

즉, NAS host의 실제 경로는 다음이지만,

/volume1/docker/openclaw/.openclaw

컨테이너 내부에서는 다음 경로로 보이게 한다.

/home/node/.openclaw

이 구조의 핵심은 다음과 같다.

OpenClaw 설정과 workspace는 NAS의 /volume1/docker/openclaw/.openclaw에 보존
컨테이너는 언제든 삭제/재생성 가능
OpenClaw CLI는 host에 직접 설치하지 않고 openclaw-cli 컨테이너로 실행
OpenClaw gateway는 openclaw-gateway 컨테이너로 상시 실행

사전 준비

Synology NAS에는 DSM의 Container Manager가 설치되어 있어야 한다.

SSH 터미널에서 Docker와 Compose가 정상 동작하는지 확인한다.

sudo docker version
sudo docker compose version

Synology에서는 일반 사용자 계정이 Docker daemon socket에 직접 접근하지 못하는 경우가 많다.

확인:

ls -al /var/run/docker.sock

예시:

srw-rw---- 1 root root 0 docker.sock

이 경우 일반 사용자로는 docker pull 같은 명령이 실패한다.

따라서 이 글에서는 모든 Docker 명령을 다음처럼 sudo 기준으로 실행한다.

sudo docker compose ...

설치 디렉터리 생성

OpenClaw Compose 프로젝트용 디렉터리를 만든다.

sudo mkdir -p /volume1/docker/openclaw
cd /volume1/docker/openclaw

OpenClaw 설정과 workspace를 저장할 .openclaw 디렉터리도 미리 만든다.

sudo mkdir -p /volume1/docker/openclaw/.openclaw
sudo mkdir -p /volume1/docker/openclaw/.openclaw/workspace
sudo mkdir -p /volume1/docker/openclaw/.openclaw/logs
sudo mkdir -p /volume1/docker/openclaw/.openclaw/cron

권한 정리

OpenClaw Docker 이미지는 컨테이너 내부에서 node 사용자로 실행된다. 일반적으로 이 사용자의 UID는 1000이다.

따라서 host의 .openclaw 디렉터리를 컨테이너 내부 사용자가 쓸 수 있도록 권한을 맞춘다.

sudo chown -R 1000:1000 /volume1/docker/openclaw/.openclaw

권한이 맞지 않으면 다음과 같은 에러가 발생할 수 있다.

EACCES: permission denied, open '/home/node/.openclaw/logs/config-health.json'

커스텀 Dockerfile 작성

OpenClaw 기본 이미지만으로도 gateway 실행은 가능하다. 하지만 코딩 에이전트 용도로도 사용할 계획이라면 gh, ripgrep, jq를 함께 넣어두는 것이 편하다.

/volume1/docker/openclaw/Dockerfile

FROM ghcr.io/openclaw/openclaw:latest

USER root

RUN apt-get update \
  && apt-get install -y --no-install-recommends gh ripgrep jq \
  && rm -rf /var/lib/apt/lists/*

USER node

각 도구의 용도는 다음과 같다.

gh: GitHub CLI
ripgrep: 빠른 코드 검색용 rg
jq: JSON 출력 확인 및 가공

`.env` 작성

/volume1/docker/openclaw/.env

OPENCLAW_CONFIG_DIR=/volume1/docker/openclaw/.openclaw
OPENCLAW_WORKSPACE_DIR=/volume1/docker/openclaw/.openclaw/workspace

OPENCLAW_GATEWAY_PORT=18789
OPENCLAW_TZ=Asia/Seoul

# GitHub CLI 또는 GitHub Copilot 연동이 필요할 경우 입력
GH_TOKEN=
GITHUB_TOKEN=
COPILOT_GITHUB_TOKEN=

.env에는 GitHub token, Copilot token 같은 민감정보가 들어갈 수 있으므로 권한을 제한한다.

sudo chmod 600 /volume1/docker/openclaw/.env

docker-compose.yml 작성

/volume1/docker/openclaw/docker-compose.yml

services:
  openclaw-gateway:
    build:
      context: .
      dockerfile: Dockerfile
    image: local/openclaw-gh:latest
    container_name: openclaw-gateway
    env_file:
      - .env
    environment:
      HOME: /home/node
      OPENCLAW_HOME: /home/node
      TERM: xterm-256color

      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_CONFIG_DIR: /home/node/.openclaw
      OPENCLAW_WORKSPACE_DIR: /home/node/.openclaw/workspace

      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN:-}
      OPENCLAW_ALLOW_INSECURE_PRIVATE_WS: ${OPENCLAW_ALLOW_INSECURE_PRIVATE_WS:-}
      OPENCLAW_DISABLE_BONJOUR: ${OPENCLAW_DISABLE_BONJOUR:-}

      GH_TOKEN: ${GH_TOKEN:-}
      GITHUB_TOKEN: ${GITHUB_TOKEN:-}
      COPILOT_GITHUB_TOKEN: ${COPILOT_GITHUB_TOKEN:-}

      TZ: ${OPENCLAW_TZ:-Asia/Seoul}
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    ports:
      - "127.0.0.1:${OPENCLAW_GATEWAY_PORT:-18789}:18789"
    extra_hosts:
      - "host.docker.internal:host-gateway"
    cap_drop:
      - NET_RAW
      - NET_ADMIN
    security_opt:
      - no-new-privileges:true
    init: true
    restart: unless-stopped
    command:
      [
        "node",
        "dist/index.js",
        "gateway",
        "--bind",
        "lan",
        "--port",
        "18789"
      ]
    healthcheck:
      test:
        [
          "CMD",
          "node",
          "-e",
          "fetch('http://127.0.0.1:18789/healthz').then((r)=>process.exit(r.ok?0:1)).catch(()=>process.exit(1))"
        ]
      interval: 30s
      timeout: 5s
      retries: 5
      start_period: 20s

  openclaw-cli:
    image: local/openclaw-gh:latest
    network_mode: "service:openclaw-gateway"
    env_file:
      - .env
    environment:
      HOME: /home/node
      OPENCLAW_HOME: /home/node
      TERM: xterm-256color

      OPENCLAW_STATE_DIR: /home/node/.openclaw
      OPENCLAW_CONFIG_PATH: /home/node/.openclaw/openclaw.json
      OPENCLAW_CONFIG_DIR: /home/node/.openclaw
      OPENCLAW_WORKSPACE_DIR: /home/node/.openclaw/workspace

      OPENCLAW_GATEWAY_TOKEN: ${OPENCLAW_GATEWAY_TOKEN:-}
      OPENCLAW_ALLOW_INSECURE_PRIVATE_WS: ${OPENCLAW_ALLOW_INSECURE_PRIVATE_WS:-}

      GH_TOKEN: ${GH_TOKEN:-}
      GITHUB_TOKEN: ${GITHUB_TOKEN:-}
      COPILOT_GITHUB_TOKEN: ${COPILOT_GITHUB_TOKEN:-}

      BROWSER: echo
      TZ: ${OPENCLAW_TZ:-Asia/Seoul}
    volumes:
      - ${OPENCLAW_CONFIG_DIR}:/home/node/.openclaw
      - ${OPENCLAW_WORKSPACE_DIR}:/home/node/.openclaw/workspace
    cap_drop:
      - NET_RAW
      - NET_ADMIN
    security_opt:
      - no-new-privileges:true
    stdin_open: true
    tty: true
    init: true
    entrypoint: ["node", "dist/index.js"]
    depends_on:
      - openclaw-gateway

여기서 중요한 점은 두 가지다.

첫째, .env의 OPENCLAW_CONFIG_DIR와 OPENCLAW_WORKSPACE_DIR는 NAS host 경로다.

OPENCLAW_CONFIG_DIR=/volume1/docker/openclaw/.openclaw
OPENCLAW_WORKSPACE_DIR=/volume1/docker/openclaw/.openclaw/workspace

둘째, compose의 environment 안에 있는 OPENCLAW_CONFIG_DIR와 OPENCLAW_WORKSPACE_DIR는 컨테이너 내부 경로다.

OPENCLAW_CONFIG_DIR: /home/node/.openclaw
OPENCLAW_WORKSPACE_DIR: /home/node/.openclaw/workspace

둘을 혼동하면 컨테이너 안에서 host 경로를 만들려고 하거나, permission error가 발생할 수 있다.

bridge 모드로 운영하는 이유

이 compose 파일은 Docker bridge 모드를 기준으로 한다.

ports:
  - "127.0.0.1:18789:18789"

이 설정은 OpenClaw gateway를 NAS의 127.0.0.1:18789에만 노출한다.

즉, 같은 내부망에 있는 다른 기기에서 직접 http://NAS_IP:18789로 접근할 수 없고, SSH 터널을 통해서만 접근한다.

이 방식의 장점은 다음과 같다.

gateway를 외부 네트워크에 직접 노출하지 않음
기존 SSH 터널 접속 방식과 잘 맞음
Synology 방화벽과 별개로 노출 범위를 줄일 수 있음

왜 gateway bind는 `lan`인가

처음에는 gateway를 loopback으로 두는 것이 더 안전해 보인다.

하지만 Docker bridge 모드에서는 컨테이너 내부의 loopback은 NAS host의 loopback이 아니라 컨테이너 자기 자신의 loopback이다.

따라서 host의 published port를 통해 컨테이너 gateway에 접근하려면, 컨테이너 내부 OpenClaw는 loopback이 아니라 lan으로 bind하는 것이 안전하다.

compose에서는 다음처럼 설정했다.

command:
  [
    "node",
    "dist/index.js",
    "gateway",
    "--bind",
    "lan",
    "--port",
    "18789"
  ]

host 쪽 포트는 여전히 127.0.0.1:18789에만 열어두기 때문에 외부 노출 범위는 제한된다.

커스텀 이미지 빌드

Compose 프로젝트 폴더로 이동한다.

cd /volume1/docker/openclaw

커스텀 이미지를 빌드한다.

sudo docker compose build

캐시 없이 다시 빌드하려면 다음 명령을 사용한다.

sudo docker compose build --no-cache

OpenClaw gateway 실행

gateway를 실행한다.

sudo docker compose up -d openclaw-gateway

빌드와 실행을 한 번에 하려면 다음 명령을 사용한다.

sudo docker compose up -d --build openclaw-gateway

상태 확인:

sudo docker compose ps

로그 확인:

sudo docker compose logs -f openclaw-gateway

health check

NAS host에서 gateway health check를 확인한다.

curl -fsS http://127.0.0.1:18789/healthz
curl -fsS http://127.0.0.1:18789/readyz

정상이라면 HTTP 응답이 반환된다.

SSH 터널로 대시보드 접속

이 구성에서는 gateway가 NAS의 127.0.0.1:18789에만 노출되어 있으므로, 외부 기기에서는 SSH 터널을 통해 접속한다.

ssh -L 18789:127.0.0.1:18789 agent@<NAS_IP>

그 다음 브라우저에서 접속한다.

http://127.0.0.1:18789

이 방식은 브라우저의 localhost secure context 조건을 만족시키기 쉽고, OpenClaw gateway를 내부망에 직접 노출하지 않아도 된다.

OpenClaw CLI 실행 방식

Docker Compose 구조에서는 host에 openclaw CLI를 직접 설치하지 않는다. 대신 openclaw-cli 서비스를 통해 실행한다.

버전 확인:

sudo docker compose run -T --rm openclaw-cli --version

상태 확인:

sudo docker compose run -T --rm openclaw-cli status --json

doctor:

sudo docker compose run -T --rm openclaw-cli doctor

모델 상태 확인:

sudo docker compose run -T --rm openclaw-cli models status --json

cron 목록 확인:

sudo docker compose run -T --rm openclaw-cli cron list

`-T` 옵션을 언제 쓰고 언제 빼야 하나

Docker Compose에서 -T는 pseudo-TTY 할당을 끄는 옵션이다.

Synology 터미널에서 리치 출력이 불안정하거나, JSON 출력만 확인할 때는 -T를 붙이는 편이 안정적이다.

예:

sudo docker compose run -T --rm openclaw-cli status --json
sudo docker compose run -T --rm openclaw-cli doctor

하지만 로그인, wizard, device auth처럼 interactive TTY가 필요한 명령에는 -T를 붙이면 안 된다.

잘못된 예:

sudo docker compose run -T --rm openclaw-cli models auth login --provider github-copilot

이 경우 다음 에러가 날 수 있다.

models auth login requires an interactive TTY

올바른 예:

sudo docker compose run --rm openclaw-cli models auth login-github-copilot

정리하면 다음과 같다.

상태 확인, doctor, JSON 출력 → -T 사용
로그인, wizard, device auth → -T 제거

컨테이너 내부 shell 접속

CLI 컨테이너 shell:

sudo docker compose run --rm --entrypoint sh openclaw-cli

실행 중인 gateway 컨테이너 shell:

sudo docker compose exec openclaw-gateway sh

명령만 실행:

sudo docker compose run -T --rm --entrypoint sh openclaw-cli -lc 'pwd && ls -al'

설치한 도구 확인:

sudo docker compose run -T --rm --entrypoint sh openclaw-cli -lc 'gh --version && rg --version && jq --version'

GitHub CLI 토큰 설정

컨테이너 안에서 gh를 사용하려면 GitHub token을 .env에 넣는다.

GH_TOKEN=github_pat_xxxxxxxxxxxxxxxxx
GITHUB_TOKEN=github_pat_xxxxxxxxxxxxxxxxx

.env 수정 후 gateway를 재시작한다.

sudo docker compose restart openclaw-gateway

컨테이너 안에서 gh 인증 상태 확인:

sudo docker compose run -T --rm --entrypoint gh openclaw-cli auth status

repo 접근 확인:

sudo docker compose run -T --rm --entrypoint gh openclaw-cli repo list

.env에는 민감정보가 들어가므로 공개 저장소에 올리면 안 된다.

자주 쓰는 명령어

프로젝트 폴더 이동

cd /volume1/docker/openclaw

이미지 빌드

sudo docker compose build

캐시 없이 빌드

sudo docker compose build --no-cache

gateway 실행

sudo docker compose up -d openclaw-gateway

빌드 포함 실행

sudo docker compose up -d --build openclaw-gateway

gateway 로그 확인

sudo docker compose logs -f openclaw-gateway

gateway 재시작

sudo docker compose restart openclaw-gateway

중지 및 컨테이너 제거

sudo docker compose down

상태 JSON 확인

sudo docker compose run -T --rm openclaw-cli status --json

doctor 실행

sudo docker compose run -T --rm openclaw-cli doctor

shell 접속

sudo docker compose run --rm --entrypoint sh openclaw-cli

설치 도구 확인

sudo docker compose run -T --rm --entrypoint sh openclaw-cli -lc 'gh --version && rg --version && jq --version'

업데이트

sudo docker compose pull
sudo docker compose build --no-cache
sudo docker compose down
sudo docker compose up -d openclaw-gateway

자주 만난 에러와 해결

1. `no configuration file provided: not found`

no configuration file provided: not found

원인:

docker-compose.yml이 없는 디렉터리에서 docker compose 실행

해결:

cd /volume1/docker/openclaw
sudo docker compose run -T --rm openclaw-cli doctor

또는 compose 파일 경로를 직접 지정한다.

sudo docker compose \
  -f /volume1/docker/openclaw/docker-compose.yml \
  --env-file /volume1/docker/openclaw/.env \
  run -T --rm openclaw-cli doctor

2. `.openclaw` EACCES

EACCES: permission denied, open '/home/node/.openclaw/logs/config-health.json'

원인:

컨테이너 내부 node 사용자(uid 1000)가 host bind mount 폴더에 쓰기 불가

해결:

sudo chown -R 1000:1000 /volume1/docker/openclaw/.openclaw

3. Docker socket permission denied

permission denied while trying to connect to the Docker daemon socket

원인:

agent 계정이 /var/run/docker.sock 접근 권한 없음

해결:

sudo docker compose ...

Synology에서는 Docker socket 권한을 넓히는 것보다 sudo 또는 DSM Container Manager UI를 쓰는 편이 안전하다.

4. `models auth login requires an interactive TTY`

models auth login requires an interactive TTY

원인:

interactive login 명령에 -T 옵션을 붙임

해결:

sudo docker compose run --rm openclaw-cli models auth login-github-copilot

상태 확인이나 JSON 출력에는 -T를 쓰고, 로그인류 명령에는 -T를 빼면 된다.

DSM Container Manager에서 관리하기

SSH에서 Compose를 실행해도 되지만, DSM UI에서는 Container Manager의 Project로 관리할 수 있다.

흐름:

/volume1/docker/openclaw 폴더 생성
Dockerfile, .env, docker-compose.yml 작성
DSM Container Manager → Project → Create
경로를 /volume1/docker/openclaw로 지정
compose 내용을 확인하고 생성

이렇게 하면 DSM UI에서도 컨테이너 상태, 로그, 재시작을 확인할 수 있다.

마무리

Synology NAS에 OpenClaw를 Docker Compose로 신규 설치하면 host 환경에 직접 의존하지 않고 안정적으로 gateway와 CLI를 운영할 수 있다.

이번 구성에서 가장 중요한 포인트는 다음 네 가지다.

.openclaw는 host에 보존하고 컨테이너에는 /home/node/.openclaw로 mount한다.
OpenClaw 컨테이너는 uid 1000의 node 사용자로 실행되므로 host 폴더 권한을 맞춘다.
bridge 모드에서는 gateway bind를 lan으로 두고, host에는 127.0.0.1:18789만 노출한다.
CLI 명령은 openclaw-cli 컨테이너로 실행하고, 비대화형 명령에는 -T를 붙인다.

이 구조를 잡아두면 OpenClaw gateway 실행, CLI 상태 확인, Telegram 채널 설정, 모델 인증, cron 테스트까지 모두 Docker Compose 안에서 일관되게 관리할 수 있다.

GeekNews AI Weekly Deep Dive - 2026-05-18

ageofclick — Mon, 18 May 2026 04:21:53 +0000

이번 주 AI 이슈는 새 모델 과시보다 실제 운영 단위에서 AI를 어떻게 끼워 넣고 통제할지에 더 무게가 실렸습니다. 제품 경험에 자연스럽게 녹이는 통합 전략, 실제 하드웨어·예산에 맞는 선택, 그리고 프로세스 병목을 정확히 짚는 운영 감각이 공통 화두로 떠올랐습니다.

1. AI는 기술이지, 제품이 아니다

핵심 내용 요약: 이 글은 AI를 독립적인 ‘킬러 제품’으로 보기보다, 무선 네트워킹처럼 모든 제품에 스며드는 기반 기술로 봐야 한다고 주장합니다. 저자는 AI가 아이폰 사용 경험을 바꾸는 것은 맞지만, 2030년에도 호출·소통·확인 같은 핵심 상호작용의 중심 기기는 여전히 스마트폰일 가능성이 높다고 봅니다. 결론적으로 애플의 경쟁력은 AI 자체를 전면에 내세우는 것이 아니라, 사용자가 기술을 의식하지 않게 제품 경험으로 통합하는 데 있다는 관점입니다.

원문 링크: https://daringfireball.net/2026/05/ai_is_technology_not_a_product

2. whichllm - 내 하드웨어에서 실제로 돌아가고 최고 성능을 내는 로컬 LLM 찾기

핵심 내용 요약: whichllm은 하드웨어에서 ‘돌아가기만 하는’ 모델이 아니라, 실제 벤치마크와 최신성·신뢰도 보정을 반영해 가장 성능이 좋은 로컬 LLM을 고르는 CLI 도구입니다. GPU·CPU·RAM 자동 감지 후 모델을 랭킹하고, 근거 수준 태깅과 계보 기반 감점으로 오래되거나 과장된 점수의 영향력을 줄여 추천 정확도를 높입니다. 또한 run·plan·upgrade 같은 명령으로 즉시 실행, 구매 전 시뮬레이션, 업그레이드 비교까지 한 흐름에서 지원해 실사용 의사결정을 단순화합니다.

원문 링크: https://github.com/Andyyyy64/whichllm

3. AI 구독은 엔터프라이즈의 시한폭탄

핵심 내용 요약: 이 글은 주요 AI 기업들이 낮은 구독 가격으로 기업 도입을 빠르게 늘렸지만, 실제 토큰 비용과의 격차가 커 향후 가격 인상·사용량 제한·종량제 전환이 불가피하다고 주장합니다. 특히 에이전트형 사용이 늘면서 좌석당 계산 자원이 급증해, 현재는 작아 보이는 비용이 기업 예산에서 별도 관리가 필요한 수준으로 바뀔 수 있다고 경고합니다. 따라서 기업은 좌석 수가 아니라 실제 사용량을 기준으로 비용을 추적하고, 가격 충격에 대비한 시나리오와 벤더 대안을 미리 준비해야 한다고 제안합니다.

원문 링크: https://www.thestateofbrand.com/news/ai-subscription-time-bomb

4. AI가 여러분의 프로세스를 더 빠르게 만들지는 않을 것 같습니다

핵심 내용 요약: 이 글은 소프트웨어 개발 속도의 핵심 병목이 코딩 자체가 아니라 모호한 요구사항을 실행 가능한 문제로 정제하는 상류 과정에 있다고 설명합니다. AI가 코드 생성을 빠르게 해도 도메인 지식과 상세한 맥락이 부족하면 결과 품질이 떨어지므로, 실제로는 더 정교한 입력과 지속적인 사람의 개입이 필요하다는 점을 강조합니다. 결국 프로세스 개선의 우선순위는 병목 단계에 고품질·예측 가능한 입력을 공급하는 구조를 만드는 것이며, AI는 그 기반 위에서만 의미 있게 속도를 높일 수 있다고 결론짓습니다.

원문 링크: https://frederickvanbrabant.com/blog/2026-05-15-i-dont-think-ai-will-make-your-processes-go-faster/

5. dev3000 - AI 디버깅을 위한 웹 앱 개발 타임라인 통합 캡처 도구

핵심 내용 요약: dev3000은 개발 서버 실행 중 발생하는 서버 로그, 브라우저 콘솔, 네트워크 요청, 사용자 상호작용, 자동 스크린샷을 시간순으로 통합 기록해 AI가 문제 맥락을 한 번에 이해하도록 돕는 디버깅 도구입니다. 수집된 기록은 프로젝트별 로그와 스크린샷으로 저장되며, 통합 에러 조회·심층 분석·URL 크롤링 같은 진단 명령을 통해 원인 파악과 수정 과정을 빠르게 반복할 수 있도록 설계되었습니다. 또한 다양한 웹 프레임워크와 Chromium 계열 브라우저, 헤드리스 실행, 에이전트 분할 화면 연동을 지원해 로컬 개발부터 CI 환경까지 동일한 흐름으로 활용할 수 있습니다.

원문 링크: https://github.com/vercel-labs/dev3000

6. AI와 함께 일하며 복리처럼 쌓아 성장하는 법

핵심 내용 요약: 이 글은 AI 협업 성과를 누적시키는 핵심 원칙으로 컨텍스트를 체계적으로 정리하고, 선호와 작업 규칙을 설정 파일에 명시하며, 저비용 검증 루프를 앞단에 배치하고, 더 큰 단위의 일을 위임한 뒤 피드백을 다시 시스템에 반영하는 과정을 제시합니다. 특히 프로젝트 문서와 메모리 계층을 구조화해 세션마다 빠르게 온보딩하고, 스킬과 가이드를 지연 로딩 방식으로 운영해 컨텍스트 비용을 줄이면서도 재현 가능한 워크플로를 만드는 점을 강조합니다. 나아가 병렬 세션 운영과 드리프트 점검, 트랜스크립트 기반 규칙 개선을 통해 개인 생산성을 팀 단위 협업 품질로 확장할 수 있다고 설명합니다.

원문 링크: https://eugeneyan.com/writing/working-with-ai/

7. Google의 생성형 AI 검색 기능 최적화 공식 가이드

핵심 내용 요약: Google은 AI Overviews·AI Mode 같은 생성형 검색 기능도 기존 검색 랭킹·품질 시스템 위에서 동작하므로, 기술적 SEO 기본기와 사람 중심의 고유한 콘텐츠 전략이 여전히 핵심이라고 명확히 안내했습니다. 특히 LLMS.txt, 인위적 청킹, AI 전용 문체 재작성, 부자연스러운 멘션 확보 같은 이른바 AEO/GEO ‘핵’은 효과가 없거나 비권장하며, 대신 크롤링 가능 구조·중복 최소화·이미지/영상 품질·사용자 만족도를 우선하라고 강조했습니다. 또한 브라우저 에이전트 등 에이전틱 경험 확산에 대비해 사이트 접근성과 구조적 명확성을 갖추는 것이 중장기 가시성에 유리하다고 정리했습니다.

원문 링크: https://developers.google.com/search/docs/fundamentals/ai-optimization-guide

이번 주 실행 제안

실무적으로는 더 강한 모델을 붙이는 것보다 비용 구조, 하드웨어 적합성, 입력 품질, 운영 제어 지점을 함께 설계하는 팀이 유리해 보입니다. 특히 AI를 별도 마법 상자로 다루기보다 기존 제품과 워크플로에 어떻게 스며들게 할지까지 포함해 판단해야 시행착오를 줄일 수 있습니다.

GeekNews Frontend Weekly Deep Dive - 2026-05-18

ageofclick — Mon, 18 May 2026 04:21:23 +0000

이번 주 프론트엔드 흐름은 웹 개발 도구가 더 정교한 실행 맥락과 작업 기록을 다루는 방향으로 진화하는 한편, 검색 노출과 텍스트 UI처럼 오래된 문제도 생성형 AI 시대 기준으로 다시 재설계되고 있음을 보여줬습니다. 특히 디버깅, 문서 탐색, 업무 기록, 에이전트 실행 환경이 한층 더 운영 친화적인 형태로 묶이는 흐름이 두드러졌습니다.

1. dev3000 - AI 디버깅을 위한 웹 앱 개발 타임라인 통합 캡처 도구

핵심 내용 요약: dev3000은 개발 서버 실행 중의 서버 로그, 브라우저 콘솔, 네트워크 요청, 자동 스크린샷, 사용자 인터랙션을 시간순으로 함께 수집해 AI가 문제 맥락을 한 번에 파악하도록 돕는 디버깅 도구입니다. Chrome DevTools Protocol 기반 모니터링 결과를 프로젝트별 로그와 스크린샷으로 저장하고, 에러 조회·심층 분석·크롤링 같은 명령으로 원인 추적을 빠르게 수행할 수 있게 설계되었습니다. 프레임워크 종류와 무관하게 적용 가능하며 에이전트 연동, 헤드리스 실행, 프로젝트별 브라우저 프로필 유지까지 지원해 실전 개발 흐름에 바로 붙일 수 있습니다.

원문 링크: https://github.com/vercel-labs/dev3000

2. Google의 생성형 AI 검색 기능 최적화 공식 가이드

핵심 내용 요약: Google은 AI Overviews와 AI Mode 같은 생성형 검색에서도 기존 SEO 원칙이 그대로 유효하다고 밝히며, 단기적인 ‘AEO/GEO 핵’보다 사용자에게 실제로 유용한 독창적 콘텐츠를 우선하라고 권고합니다. 특히 인덱싱 가능성과 크롤링 접근성, 명확한 페이지 구조, 중복 최소화 같은 기술 기반을 갖추고, 검색 변형별 억지 페이지 양산이나 AI 전용 재작성 같은 조작적 전략은 피해야 한다고 강조합니다. 또한 로컬·이커머스 정보 정비와 에이전트 친화적 웹 준비를 병행하되, 핵심은 사람 중심의 신뢰 가능한 비범용 콘텐츠를 꾸준히 제공하는 것이라고 정리합니다.

원문 링크: https://developers.google.com/search/docs/fundamentals/ai-optimization-guide

3. 끝까지 네이티브로, 텍스트가 필요해지기 전까지

핵심 내용 요약: 작성자는 SwiftUI·AppKit·TextKit을 오가며 Markdown 채팅 UI를 구현했지만, 전체 선택과 스트리밍 안정성 같은 기본 요구를 만족시키는 과정에서 성능 저하와 복잡성이 반복된다고 지적합니다. 반면 WebKit과 Electron에서는 텍스트 선택, 렌더링 품질, 타이포그래피, 통합 동작이 비교적 자연스럽게 확보되어 장문 대화형 UI에서 웹 기반 접근이 실용적이라는 결론에 이릅니다. 결국 문제의 핵심은 네이티브 기술의 우열보다도, 현대 텍스트 인터페이스를 제품 수준으로 빠르게 완성할 수 있는 구현 경로가 어디에 더 성숙해 있는가에 있다는 주장입니다.

원문 링크: https://justsitandgrin.im/posts/native-all-the-way-until-you-need-text/

4. Show GN: glowed - Ghostty용 터미널 Markdown 브라우저/에디터

핵심 내용 요약: glowed는 실행한 디렉터리를 기준으로 Markdown 파일을 스캔해 검색·미리보기·원문 편집을 한 흐름 안에서 처리하고, 선택한 문맥을 외부 LLM CLI 세션으로 넘길 수 있게 설계된 Ghostty 중심 TUI 도구입니다. 작성자는 보안 자격 증명을 앱이 직접 다루지 않고 기존에 로그인된 CLI를 호출하는 방식과, 백업을 포함한 원자적 저장 등 실사용 안정 장치를 초기 버전에 반영했다고 설명합니다. 다만 현재는 macOS+Ghostty 환경 최적화와 제한적인 호환성 검증을 전제로 하며, 사용자별 포크와 Homebrew tap 배포를 권장하는 분산형 운영 모델을 채택하고 있습니다.

원문 링크: https://github.com/khw1031/glowed

5. Show GN: 셜록 - 당신이 오늘 뭘 했는지를 다 알고 있는 AI 노트 앱

핵심 내용 요약: 셜록은 회의 기록에 한정된 기존 노트 도구와 달리, 사용자의 화면에서 실제 업무 맥락을 읽어 일과를 자동으로 정리해 주는 Mac용 AI 노트 앱입니다. 별도 앱 연동 없이 브라우징·메신저·문서 작업 흐름을 기반으로 요약과 후속 할 일을 만들어 주며, 필요한 경우 하루 업무를 질문형 챗으로 다시 꺼내볼 수 있게 설계됐습니다. 데이터는 로컬 저장을 기본으로 하고 캡처 중지·기록 삭제 같은 제어권을 사용자에게 두어 프라이버시 우려를 줄이려는 방향이 분명합니다.

원문 링크: https://getsherlock.xyz

6. Zerostack - 순수 Rust로 작성된 Unix에서 영감을 받은 코딩 에이전트

핵심 내용 요약: Zerostack은 Rust로 만든 초경량 코딩 에이전트로, 낮은 메모리 사용량과 빠른 반응성을 강점으로 내세우며 다양한 LLM 제공자와 도구 실행 흐름을 지원합니다. 파일 편집·검색·셸 실행 같은 핵심 기능에 권한 모드와 승인 체계를 붙여 자동화 편의성과 안전성 사이를 조절할 수 있고, 세션 재개·프롬프트 전환·반복 루프·워크트리 연계 등 장기 개발 작업을 위한 운영 기능도 폭넓게 갖췄습니다. 커뮤니티 반응은 특히 저사양 환경에서의 실사용성과 확장 가능성에 주목하면서도, 일부 제공자 호환성과 기능 성숙도는 추가 개선이 필요하다는 평가를 함께 보여줍니다.

원문 링크: https://crates.io/crates/zerostack/1.0.0

7. Google 검색의 생성형 AI 기능을 위한 웹사이트 최적화

핵심 내용 요약: 구글은 AI Overviews·AI Mode 같은 생성형 검색에서도 별도의 비법보다 기존 SEO 원칙이 여전히 핵심이라고 명확히 밝히며, AI 응답 역시 검색 인덱스 기반의 RAG와 쿼리 팬아웃으로 신뢰 가능한 페이지를 찾아 구성된다고 설명합니다. 따라서 흔한 정보 재가공보다 고유한 관점과 실제 경험이 담긴 비범용 콘텐츠, 그리고 크롤링·인덱싱·접근성·페이지 경험 같은 기술적 기반을 꾸준히 갖추는 것이 장기적인 노출 성과를 좌우한다고 강조합니다. 반대로 llms.txt 신설, 기계적 청킹, 과도한 롱테일 삽입, 인위적 언급 늘리기 같은 ‘AEO/GEO 해킹’은 불필요하거나 스팸 정책 위험이 있어 피해야 한다고 정리합니다.

원문 링크: https://developers.google.com/search/docs/fundamentals/ai-optimization-guide

이번 주 실행 제안

실행 관점에서는 새 도구의 데모보다 팀 워크플로에 안전하게 붙는지, 원문 품질과 맥락 보존을 실제로 개선하는지를 먼저 검증하는 편이 좋습니다. 특히 검색 최적화나 에이전트 도구 도입은 눈에 띄는 편법보다 구조적 접근성, 기록성, 검수 가능성을 확보하는 쪽이 오래 남습니다.

Forem: ageofclick

Synology NAS에 OpenClaw 설치하기

들어가며

최종 구성

사전 준비

설치 디렉터리 생성

권한 정리

커스텀 Dockerfile 작성

.env 작성

docker-compose.yml 작성

bridge 모드로 운영하는 이유

왜 gateway bind는 lan인가

커스텀 이미지 빌드

OpenClaw gateway 실행

health check

SSH 터널로 대시보드 접속

OpenClaw CLI 실행 방식

-T 옵션을 언제 쓰고 언제 빼야 하나

컨테이너 내부 shell 접속

GitHub CLI 토큰 설정

자주 쓰는 명령어

프로젝트 폴더 이동

이미지 빌드

캐시 없이 빌드

gateway 실행

빌드 포함 실행

gateway 로그 확인

gateway 재시작

중지 및 컨테이너 제거

상태 JSON 확인

doctor 실행

shell 접속

설치 도구 확인

업데이트

자주 만난 에러와 해결

1. no configuration file provided: not found

2. .openclaw EACCES

3. Docker socket permission denied

4. models auth login requires an interactive TTY

DSM Container Manager에서 관리하기

마무리

GeekNews AI Weekly Deep Dive - 2026-05-18

1. AI는 기술이지, 제품이 아니다

2. whichllm - 내 하드웨어에서 실제로 돌아가고 최고 성능을 내는 로컬 LLM 찾기

3. AI 구독은 엔터프라이즈의 시한폭탄

4. AI가 여러분의 프로세스를 더 빠르게 만들지는 않을 것 같습니다

5. dev3000 - AI 디버깅을 위한 웹 앱 개발 타임라인 통합 캡처 도구

6. AI와 함께 일하며 복리처럼 쌓아 성장하는 법

7. Google의 생성형 AI 검색 기능 최적화 공식 가이드

이번 주 실행 제안

GeekNews Frontend Weekly Deep Dive - 2026-05-18

1. dev3000 - AI 디버깅을 위한 웹 앱 개발 타임라인 통합 캡처 도구

2. Google의 생성형 AI 검색 기능 최적화 공식 가이드

3. 끝까지 네이티브로, 텍스트가 필요해지기 전까지

4. Show GN: glowed - Ghostty용 터미널 Markdown 브라우저/에디터

5. Show GN: 셜록 - 당신이 오늘 뭘 했는지를 다 알고 있는 AI 노트 앱

6. Zerostack - 순수 Rust로 작성된 Unix에서 영감을 받은 코딩 에이전트

7. Google 검색의 생성형 AI 기능을 위한 웹사이트 최적화

이번 주 실행 제안

`.env` 작성

왜 gateway bind는 `lan`인가

`-T` 옵션을 언제 쓰고 언제 빼야 하나

1. `no configuration file provided: not found`

2. `.openclaw` EACCES

4. `models auth login requires an interactive TTY`