본문으로 건너뛰기

首次설정

恭喜你完成了 설치！이 글에서는走過首次설정流程，讓 OpenClaw 真正動起來。

설정總覽​

首次설정需要完成以下四個步驟：

  1. 실행互動式설정精靈
  2. 생성 SOUL.md 人格檔案
  3. 連接第一個 LLM 提供者
  4. 테스트基本指令

整個流程約需 5-10 分鐘。

步驟一：실행설정精靈​

OpenClaw 提供互動式설정精靈，能快速完成基本配置：

openclaw setup

精靈會依序詢問以下問題：

🦞 Welcome to OpenClaw Setup!

? Choose your preferred language: 한국어
? Select container engine: Podman (recommended)
? Gateway bind address: 127.0.0.1 (localhost only)
? Gateway port: 18789
? Choose your primary LLM provider: (Use arrow keys)
  ❯ Anthropic (Claude)
    OpenAI (GPT)
    Google (Gemini)
    DeepSeek
    Ollama (Local)
    Skip for now
? Enter your API key: sk-ant-•••••••••
? Create a default SOUL.md personality? Yes

✅ Setup complete! Config saved to ~/.openclaw/
不確定選哪個 LLM？

如果你還沒決定要用哪個 LLM 提供者，可以先選「Skip for now」。稍後可以透過 選擇 AI 模型 頁面了解各模型的比較，再回來설정。

步驟二：생성 SOUL.md 人格檔案​

SOUL.md 是 OpenClaw 最獨特的設計之一——它定義了你的 AI 代理的「靈魂」。설정精靈會為你생성一份基本範本：

# 조회預設的 SOUL.md
cat ~/.openclaw/soul.md

預設內容如下：

# SOUL.md

## 基本資訊
- 名稱：小龍
- 語言：한국어（한국用語）
- 風格：友善、專業、適度幽默

## 行為規範
- 답변時保持簡潔，除非사용자要求詳細說明
- 使用한국慣用語，避免중국用語
- 遇到不確定的問題時，誠實告知而非猜測

## 專長領域
- 一般知識問答
- 日常任務協助
- 技術問題排解

你可以稍後再深入調整 SOUL.md。詳細的人格설정가이드請見 SOUL.md 人格설정。

步驟三：連接 LLM 提供者​

如果你在설정精靈中已經輸入了 API Key，可以直接검증連線：

# 테스트 LLM 連線
openclaw provider test

預期輸出：

Testing connection to Anthropic (Claude)...
✓ API key valid
✓ Model claude-opus-4-6 available
✓ Response time: 342ms
✓ Connection successful!

手動설정 LLM 提供者​

如果你跳過了설정精靈中的 LLM 步驟，可以手動編輯설정 파일：

# 編輯 LLM 提供者설정
nano ~/.openclaw/providers/default.yaml
# ~/.openclaw/providers/default.yaml

provider:
  name: anthropic
  model: claude-opus-4-6
  api_key: "${ANTHROPIC_API_KEY}"  # 建議使用環境變數
  max_tokens: 4096
  temperature: 0.7

# 備用提供者（當主要提供者不可用時自動切換）
fallback:
  name: ollama
  model: llama3.3:70b
  endpoint: "http://127.0.0.1:11434"
API Key 安全

永遠不要將 API Key 直接寫死在설정 파일中。請使用環境變數：

# 在 ~/.bashrc 或 ~/.zshrc 中加入
export ANTHROPIC_API_KEY="sk-ant-your-key-here"
export OPENAI_API_KEY="sk-your-key-here"

설정 파일中使用 ${VARIABLE_NAME} 語法引用環境變數。

步驟四：啟動 OpenClaw 並테스트​

啟動 Gateway​

# 前景模式啟動（適合테스트，按 Ctrl+C 停止）
openclaw start

# 或以背景模式啟動
openclaw start --daemon

啟動後你會看到：

🦞 OpenClaw v4.2.1 starting...
├─ Gateway listening on 127.0.0.1:18789
├─ Memory system: WAL initialized
├─ Container engine: Podman 5.4.0 (rootless)
├─ LLM provider: Anthropic (claude-opus-4-6)
└─ Skills loaded: 0 (install skills from ClawHub!)

Ready! Use 'openclaw chat' to start a conversation.

使用 CLI 進行對話​

# 開啟互動式聊天
openclaw chat
🦞 OpenClaw Chat (type 'exit' to quit)

You: 你好！你是誰？
小龍: 你好！我是小龍，你的 AI 助理 🦞 有什麼我可以幫忙的嗎？

You: 今天天氣如何？
小龍: 我目前還沒有설치天氣查詢的스킬。你可以透過以下指令설치：
      openclaw skill install weather-tw
      설치後我就能幫你查天氣囉！

You: exit
Goodbye! 🦞

테스트 Gateway API​

你也可以直接透過 HTTP API 테스트：

# 發送테스트메시지到 Gateway
curl -X POST http://127.0.0.1:18789/api/v1/chat \
  -H "Content-Type: application/json" \
  -d '{
    "message": "Hello, OpenClaw!",
    "channel": "api",
    "user_id": "test-user"
  }'

預期回應：

{
  "status": "ok",
  "response": "你好！我是小龍，有什麼可以幫忙的嗎？",
  "metadata": {
    "model": "claude-opus-4-6",
    "tokens_used": 42,
    "response_time_ms": 387
  }
}

설치你的第一個스킬​

OpenClaw 剛설치時沒有任何스킬。讓我們설치幾個實用的基礎스킬：

# 검색스킬
openclaw skill search "翻譯"

# 설치翻譯스킬
openclaw skill install translator-pro

# 설치網頁검색스킬
openclaw skill install web-search

# 조회已설치的스킬
openclaw skill list
ClawHub 스킬 보안

在설치任何스킬之前，建議조회其安全評等與社群평가。ClawHavoc 事件中曾有 2,400+ 個惡意스킬被植入 ClawHub。설치前請確認：

  • 스킬作者的검증狀態
  • 社群評分與다운로드數
  • 권한要求是否合理

詳見 스킬稽核清單。

常用管理指令​

指令說明
openclaw start啟動 Gateway
openclaw start --daemon以背景模式啟動
openclaw stop停止 Gateway
openclaw restart重新啟動
openclaw status조회실행狀態
openclaw chat開啟互動式聊天
openclaw doctor실행健康檢查
openclaw logs조회即時로그
openclaw logs --tail 50조회最後 50 行로그
openclaw config edit編輯설정 파일
openclaw skill list列出已설치的스킬

다음 단계​

你的 OpenClaw 已經可以運作了！接下來你可以：