前言

OpenClaw 是一款開源的 AI Agent 工具，但對第一次接觸的用户來説，完整跑通流程並不直觀。本文以 Linux 環境為例，詳細記錄了 OpenClaw 的安裝、初始化流程、模型選擇、TUI 使用方式，以及 TUI 與 Web UI 認證不一致導致的常見問題與解決方法，幫助你最快速度把 OpenClaw 真正跑起來

環境準備

1）安裝nodejs

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

> node --version
v22.22.0

2）安裝openclaw

npm install -g openclaw@latest

> openclaw --version
2026.2.25

初始化openclaw

openclaw onboard --install-daemon

• 為了快速跑起來，先選擇QuickStart

• 選擇模型提供商，為了快速測試，這裏直接選擇Qwen方便快速跑通流程

• 選擇完成之後，會在瀏覽器彈出登陸頁面

  • 有為老哥提出疑問：為什麼沒有支付寶或者手機之類的登陸方式呢？因為openclaw 作為一個開源工具，其默認的 Qwen 配置（qwen-portal）通常指向國際版 API，國際版顯然沒有支付寶、國內手機號直接登錄等登陸方式，取而代之的是Google 賬號、GitHub 賬號等，如果沒有賬號，註冊一個賬號即可
  • 選擇Qwen也是因為門檻地，快速上手，國際版往往提供針對開發者的免費試用額度（如每天 2000 次請求）
  • 後面可以換模型供應商，所以當前的目標是快速搭建並且跑通流程，所以選擇Qwen。繼續...

• 完成登陸之後回到控制枱，選擇具體模型，選擇默認的即可

• 下一步，選擇渠道，這裏先跳過，因為這一步後面會詳細描述，這裏的目標還是先完成安裝並且跑通

• 選擇是否配置skills，是

• 同樣，先跳過，後面再來配置

• 下面的全選否

  • Set GOOGLE_PLACES_API_KEY for goplaces，是否要選擇Google Places API 來查詢現實世界中的地點信息（比如電影院、餐館等），首先是不能使用google服務，並且不在我們本文的流程中，暫時不需要，選否
  • Set GEMINI_API_KEY for nano-banana-pro，詢問你是否要為名為 nano-banana-pro 設置 Google Gemini API 密鑰，問題還是不能使用google的服務，選否。至於nano-banana-pro是什麼東西，我也不知道...
  • Set NOTION_API_KEY for notion?，配置notion的使用權限，notion是什麼？Notion 是一款集筆記、文檔、任務管理、數據庫和協作於一體的“超級辦公室”軟件。用不上，選否
  • Set ELEVENLABS_API_KEY for sag?，讓openclaw説話，而不是隻有文字交流，而説話的能力正是ElevenLabs賦予的，它提供的服務是目前行業內領先的文本轉語音（Text-to-Speech, TTS）平台。其生成的語音非常自然、富有情感，聽起來幾乎和真人一樣。不在當前流程，先選否

• 下一步詢問你是否要啓用 Hooks（鈎子/插件），選擇session-memory，讓 AI “記住”之前的對話內容或項目上下文，即使你關閉了終端再重新打開，它也能延續之前的話題

• 到此基本配置已經結束，下一步問你怎麼孵化小機器人，直接選擇推薦的方式，使用tui（terminal ui）完成最後一步

• 這是終結者要來了嗎？斯瓦辛格從天而將，並且bgm：”洞洞咚，懂凍，洞洞咚，懂洞咚“

  斯瓦辛格能不能説中文阿？

• 能説中文啊，那就更簡單了，現在需要告訴配置初始化一下這個機器人，就像星級穿越裏面，男主重新配置TAS一樣

• 配置完成，迴歸測試一下

安裝完成

頁面配置

為什麼tui配置成功了，在webui卻一直報錯，因為tui和webui使用的是兩套完全獨立的認證系統

需要把token給應用在頁面上就可以了

1）獲取token

> cat ~/.openclaw/openclaw.json | grep -o '"token": "[^"]*"'
"token": "7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f"

2）將參數補充在頁面上，token=7da3f004ff2a1e700f229a87fb5ea12c150b37d58199295f

注：如果訪問http://127.0.0.1:18789/會有自動跳轉，那使用&將參數補充在後面即可

頁面也正常了，並且把之前在控制枱的聊天記錄也同步過來了

總結

本文在linux下實現了安裝openclaw，並且完成了基本流程的搭建，至於後面發掘openclaw的更多功能，敬請期待

聯繫我

• 聯繫我，做深入的交流

至此，本文結束
在下才疏學淺，有撒湯漏水的，請各位不吝賜教...