OpenClaw 入門教學（2026）｜從零開始搭你的 AI 工作站

Q: 安裝要多久？

Node、npm、provider 都備好的話，`setup` 到 `configure` 15-20 分鐘。第一版 AGENTS.md、記憶檔、第一批 skills 通常佔到半天，可以邊用邊調。

Q: skill 沒載入怎麼辦？

九成問題是檔名寫成 `skill.md`，改大寫 `SKILL.md` 就好。再不行才查路徑跟 workspace。

Q: cron/jobs.json 找不到怎麼辦？

正常，setup 不建。`openclaw cron add` 跑過才會有 job 定義。

Q: 設定寫錯了會搞壞 OpenClaw 嗎？

不會。多半是 Markdown 錯亂或 JSON 格式錯，agent 行為怪一下而已。`git diff` 看一下回上一版就好。

第一次裝 OpenClaw 卡住的點，幾乎都不是下載套件，而是搞不清楚哪些檔是 OpenClaw 真的會讀、哪些只是自己後來加的工作筆記。

把 2026-05 實際跑過一輪的順序整理在下面。先講最重要的一句：舊筆記寫 npx openclaw init 的話先別照抄，命令已經換了。 2026.4.26 跟 2026.5.x 兩條線的入門入口都是 setup 和 configure，不是 init。

下面這篇先不碰花俏架構，目標很簡單：把 OpenClaw 跑起來、知道每個設定檔該放什麼、做一個最小 skill，再決定要不要加記憶跟排程。

前置需求

四件事先確認。

Node.js 22 以上。建議直接 Node 24 LTS。打開終端機跑：

node -v
npm -v

Node 還停在 18 的話先升級。OpenClaw 2026 線的工具鏈跟 Node 18 時代已經不一樣了。

一個能用的模型 provider。後續 configure / onboard 流程會處理 credentials、gateway、模型選擇。第一次不用把所有 provider 都研究完，至少準備一個你確定能用的。

乾淨的測試資料夾。剛開始別拿重要專案開刀，新建一個比較好 debug：

mkdir -p ~/openclaw-playground
cd ~/openclaw-playground

文字編輯器。VS Code、Cursor、Vim 都可以。OpenClaw 第一週多半都在改 Markdown、開新 session、問 agent 有沒有讀到設定，這是正常的。

前置需求四件事總覽

安裝 OpenClaw

舊筆記寫 npx openclaw init 的話直接忽略。本文用 setup --workspace .openclaw，這個最容易重跑、也最容易檢查產出。

固定在 4.x 穩定線（推薦入門用）：

npm install -g openclaw@2026.4.26
openclaw --version
openclaw setup --workspace .openclaw

要追 5.x 最新線：

npm install -g openclaw@2026.5.7
openclaw --version
openclaw setup --workspace .openclaw

只想快速跑驗一次，可以用 npx：

npx -y openclaw@2026.4.26 setup --workspace .openclaw

第一次入門先鎖固定版本，等你知道 workspace 裡每個檔案在做什麼，再升新線。這樣比較不會把「自己設定錯」跟「版本行為變了」混在一起。

setup 完之後跑互動設定：

openclaw configure

想一次走完整 onboarding：

openclaw setup --wizard

或照官方流程：

openclaw onboard --install-daemon

三個指令做的事情不太一樣。setup 偏建立本機 config 跟 agent workspace；configure 偏 credentials、channels、models；onboard 偏第一次完整引導。新手把 setup 跟 configure 跑通就夠了。

setup 完會看到什麼

跑完 setup --workspace .openclaw，workspace 大概長這樣：

.openclaw/
  AGENTS.md
  SOUL.md
  IDENTITY.md
  USER.md
  TOOLS.md
  BOOTSTRAP.md
  HEARTBEAT.md

抓兩件事就好：

AGENTS.md 是 OpenClaw 啟動時會自動載入的入口檔。OpenClaw harness 預設讀取檔名就是 AGENTS.md，不需要再寫一個外面的入口去 import 它。
BOOTSTRAP.md 是第一次設定時的啟動任務，跑完 onboarding 後可能會被流程移除。看到它消失不代表壞了。

SOUL.md / IDENTITY.md / USER.md 比較像 agent 的長期身份和使用者偏好；TOOLS.md 是工具使用提醒。剛開始這幾個都不用寫滿，先讓 onboarding 生成基本內容，再慢慢修。

setup 不會預設建立的東西：

MEMORY.md
brain.md
skills/
cron/jobs.json

這幾個找不到是正常。它們是你開始建工作流之後才會慢慢長出來的檔案。

OpenClaw 安裝步驟示意

AGENTS.md：當索引，不要當百科

最常見的入門錯誤：把所有規則塞進 AGENTS.md，寫到 500 行，每次對話光讀設定就吃掉一大塊 context window。

AGENTS.md 的價值不是規則本身，而是「告訴 agent 下一步該去哪裡看」。最小可用版本長這樣：

## Session Startup
- Read AGENTS.md first
- Check brain.md for current work state
- Check MEMORY.md for long-term context

## Working Rules
- Edits scoped to user request
- 不動 secrets 與 runtime 生成檔
- 大改前先講 plan

## Memory
- Long-term index: MEMORY.md
- Today's state: brain.md

## Skills
- Workspace skills: skills/<name>/SKILL.md

幾條紅線、幾個 pointer，就完成了。三個常見錯誤要避開：

把每日進度寫進 AGENTS.md：入口檔幾週後就會臃腫到讀不下去。
把工具細節全塞 AGENTS.md：工具使用偏好留 TOOLS.md、特定能力拆 skill。
「永遠要做」跟「必要時才做」混在一起：每次都要讀的內容越少，啟動越乾淨。

入口檔當索引示意

記憶系統：MEMORY.md + brain.md

先講重點：MEMORY.md 跟 brain.md 都不是 OpenClaw setup 預設產物。 它們是社群慣例的命名，自己 touch 出來、自己定義要怎麼用。叫別的名字也可以，這套架構不會強制檔名。

不預設替你建這兩個檔反而是好事。記憶一開始就塞滿，幾週後會變成雜訊。

MEMORY.md：地圖

touch .openclaw/MEMORY.md
mkdir -p .openclaw/memory

寫法是「索引 + 讀取策略」，不裝資料本身：

## Always Check
- brain.md：當前工作狀態

## Project Memory
- memory/project.md：專案背景、長期決策
- memory/style.md：寫作偏好、踩過的坑

## Archive
- memory/archive/：過期但可能要查的資料

MEMORY.md 是告訴 agent 什麼記憶在哪、什麼時候該看，本身不存內容。

brain.md：今天的便條紙

touch .openclaw/brain.md

## Current Focus
- 重寫 OpenClaw 入門教學

## Next Actions
- 跑一次本機 setup 驗事實
- FAQ 校對

## Notes
- brain.md 每週清一次，過期的丟 archive 或刪

控制在 30-60 行內。一旦變成流水帳，agent 反而會被昨天、上週、上個月的雜訊干擾。

希望 OpenClaw 每次 session 都檢查它的話，就在 AGENTS.md 的 startup 區寫一行「需要當前工作狀態時，先讀 brain.md」。比把 brain 內容塞進 AGENTS.md 乾淨很多。

記憶系統分層示意

第一個 skill

OpenClaw skills 走 AgentSkills 相容結構。資料夾名稱小寫，但檔名一定要大寫 SKILL.md。最常見的入門錯誤就是寫成 skill.md，agent 直接找不到。

mkdir -p .openclaw/skills/hello-openclaw
$EDITOR .openclaw/skills/hello-openclaw/SKILL.md

最小版本：

---
name: hello-openclaw
description: 使用者要求測試 OpenClaw skill 載入時，回覆簡短檢查訊息。
---

當被觸發時：
- 確認此 skill 已載入
- 提到目前 active workspace（如有）
- 回覆控制在 5 行內

存檔後，開新 session 或跑：

openclaw skills list
openclaw skills check

skill 沒被載入時先查三件事：路徑是不是 .openclaw/skills/<name>/SKILL.md、檔名是不是大寫、CLI 推到的 workspace 是不是同一個 .openclaw/。

第一個 skill 結構示意

排程：先放著

OpenClaw 有 cron，但入門第一天先別碰。基本 workspace 沒跑穩之前加排程，反而變成 debug 時的雜訊源。

等日常跑順了再用：

openclaw cron add
openclaw cron list

排程定義會落在 cron/jobs.json，執行狀態落在 cron/jobs-state.json。這兩個 setup 都不會預設建，所以前面找不到很正常。

常見問題

Q：安裝要多久？

Node、npm、provider 都備好的話，setup 到 configure 15-20 分鐘。第一版 AGENTS.md、記憶檔、第一批 skills 通常佔到半天，可以邊用邊調。

Q：AGENTS.md 要寫多長？

新 agent 打開 30 秒內讀完知道下一步去哪裡看的長度。超過就拆。

Q：setup 後沒有 MEMORY.md 或 brain.md，是壞了嗎？

不是。它們是你設計記憶系統時自己加的，OpenClaw setup 只負責 bootstrap 那組檔案。

Q：MEMORY.md 跟 brain.md 到底差在哪？

MEMORY.md 是地圖（哪些記憶在哪），brain.md 是今天桌上的便條紙（現在進行式）。前者很少改、後者每天動。

Q：skill 沒載入怎麼辦？

九成問題是檔名寫成 skill.md，改大寫 SKILL.md 就好。再不行才查路徑跟 workspace。

Q：cron/jobs.json 找不到怎麼辦？

正常，setup 不建。openclaw cron add 跑過才會有 job 定義。

Q：設定寫錯了會搞壞 OpenClaw 嗎？

不會。多半是 Markdown 錯亂或 JSON 格式錯，agent 行為怪一下而已。git diff 看一下回上一版就好。

Q：Windows 可以用嗎？

往 WSL2 走。原生 Windows 路徑、shell、daemon 會多踩很多小坑，不值得。

常見入門踩坑示意

下一步

做到這裡 workspace 已經能用。接下來慢慢加：

AGENTS.md 收斂到只剩 startup、紅線、pointer
MEMORY.md 寫地圖
brain.md 寫當前狀態
1-3 個真的會用到的 SKILL.md
日常跑順了再加 openclaw cron 跟多 agent

不用一天搞定。OpenClaw 的甜蜜點要花一段時間調，定位本來就是給彈性高、願意自己動手的人。對 CLI 完全過敏的話，這條路會比較痛苦。

小企鵝的經驗

OpenClaw 是每天主力在跑的工具，從寫文章、管專案到排 cron 都靠它。第一個月最痛的真的是記憶這塊，剛上手時 brain.md 越塞越亂、agent 越來越笨。後來把核心檔案精簡到只剩人格、自我敘事、當下狀態，配合 MEMORY.md 索引才穩下來。

最有感的一條：AGENTS.md 短到「30 秒讀完知道下一步」是底線，超過就拆。短的入口檔讓 agent 每次開工都很乾淨。

OpenClaw 還有不少可以最佳化的地方，定位本來就是給願意自己動手調的人。對 CLI 完全過敏的話，這條路會比較痛苦。

整理：Penna｜小企鵝 Penchan