｜項(xiàng)目簡(jiǎn)介

本教程旨在指導(dǎo)開發(fā)者在 AI算力本MTT AIBOOK 上部署和使用 OpenClaw，一個(gè)由開源社區(qū)構(gòu)建的個(gè)人 AI 助手框架，幫助您快速上手本地智能助手的部署與使用。

OpenClaw 簡(jiǎn)介：OpenClaw 是一個(gè)由開源社區(qū)構(gòu)建的個(gè)人 AI 助手框架，它將 LLM（大語(yǔ)言模型）與本地系統(tǒng)完全集成，創(chuàng)造了一個(gè)可以主動(dòng)感知、記憶并行動(dòng)的真正自主助手。與傳統(tǒng)的聊天機(jī)器人不同，OpenClaw 不僅僅是一個(gè)對(duì)話工具——它是一個(gè) 24/7 運(yùn)行在您計(jì)算機(jī)上的“代理”，擁有完整的系統(tǒng)訪問(wèn)權(quán)限，能夠讀寫文件、執(zhí)行命令、操控瀏覽器，并可以通過(guò) QQ、飛書、釘釘 等多種國(guó)內(nèi)聊天軟件渠道與您溝通。

風(fēng)險(xiǎn)提示：本文或視頻為第三方開源AI智能體OpenClaw的部署與使用演示教程。根據(jù)國(guó)家工信部及互聯(lián)網(wǎng)應(yīng)急中心預(yù)警，該軟件存在權(quán)限濫用、數(shù)據(jù)泄露、系統(tǒng)被控等已知風(fēng)險(xiǎn)。請(qǐng)您在充分了解技術(shù)原理、自行評(píng)估風(fēng)險(xiǎn)后自行決定是否使用。如因個(gè)人部署操作產(chǎn)生任何影響，摩爾線程不為此承擔(dān)相關(guān)責(zé)任。

難度：初級(jí)，適合新手入門體驗(yàn)

｜前置條件

在開始本教程之前，請(qǐng)確保您已滿足以下所有條件：

▼ 硬件：

AI算力本MTT AIBOOK，型號(hào)A141。

網(wǎng)絡(luò)連接（用于下載 OpenClaw 安裝包及依賴組件）。

充足的存儲(chǔ)空間（>=3GB可用空間）。

▼ 軟件：

MTT AIBOOK 操作系統(tǒng) AIOS（1.33-B17）。

Node.js >= 22。

已配置管理員權(quán)限（可使用sudo命令）。

網(wǎng)絡(luò)環(huán)境通暢，可訪問(wèn)互聯(lián)網(wǎng)。

｜環(huán)境部署

本章節(jié)描述如何安裝并配置 OpenClaw。

▼打開終端

打開終端有兩種方式：

1. 右鍵單擊桌面或文件夾空白處，選擇“在終端中打開”。

2. 在應(yīng)用列表中找到“終端”應(yīng)用。

▼安裝 curl

首先需要安裝 curl 工具，用于下載 OpenClaw 安裝腳本：

打開終端后，直接輸入以下命令后回車執(zhí)行

sudo apt install curl -y

▼安裝 OpenClaw

執(zhí)行以下命令安裝 OpenClaw：

打開終端后，直接輸入以下命令后回車執(zhí)行

curl -fsSL https://openclaw.ai/install.sh | bash

安裝過(guò)程中，系統(tǒng)會(huì)自動(dòng)檢測(cè)并安裝所需的依賴組件（包括 Node.js 等）。請(qǐng)耐心等待安裝完成。

▼初始化配置

安裝完成后，openclaw會(huì)自動(dòng)啟動(dòng)初始化配置（Onboarding）流程。注意，如果配置過(guò)程中出錯(cuò)導(dǎo)致中斷，那么可以重新打開終端，輸入以下命令重啟初始化配置流程：

openclaw onboard

初始化配置流程按照以下步驟進(jìn)行配置：

1. 安全提示頁(yè)面：

系統(tǒng)會(huì)顯示安全提示，告知 OpenClaw 的權(quán)限風(fēng)險(xiǎn)。讀取說(shuō)明后，選擇 Yes ，按回車鍵進(jìn)入下一步。

2. 模式選擇界面：

選擇初始化方式，推薦選擇“快速啟動(dòng)”（QuickStart）模式，按回車鍵進(jìn)入下一步。

3. 模型選擇界面：

選擇云端接入的模型，根據(jù)實(shí)際情況進(jìn)行選擇，本文檔以選擇 Qwen為例。選擇Qwen(OAuth)后，按回車鍵確認(rèn)，此時(shí)會(huì)自動(dòng)打開Qwen帳號(hào)登錄界面。

4. 認(rèn)證方式：

確認(rèn)認(rèn)證方式，按提示登錄您的 Qwen 賬號(hào)。

5. 默認(rèn) AI 模型選擇：

選擇 OpenClaw 默認(rèn)使用的大模型，根據(jù)實(shí)際需求進(jìn)行選擇，本文檔以使用qwen-portal/coder-model模型為例，按回車確認(rèn)后進(jìn)入下一步。

6. 聊天渠道選擇：

選擇 OpenClaw 的交互渠道，可以選擇瀏覽器、QQ、飛書、釘釘?shù)龋颂幬覀兿冗x擇”Skip for now”跳過(guò)該設(shè)置。

7. 網(wǎng)絡(luò)搜索提供商選擇：

根據(jù)實(shí)際需求選擇具體的網(wǎng)絡(luò)搜索服務(wù)提供商。由于需要Search provider的API Key，且該服務(wù)不是強(qiáng)需求，因此本文檔我們選擇“Skip for now”先跳過(guò)配置。

8. 技能配置確認(rèn)：

啟用并配置技能（skills），最大的好處就是讓 AI 從“只能陪你聊天的機(jī)器人”變成“能幫你干活的數(shù)字員工”。此處我們先不啟用技能功能，新手可以先選 No，后續(xù)隨時(shí)可以開啟。按下回車鍵確認(rèn)后進(jìn)入下一步。

9. Hooks 功能配置：

這是一個(gè)進(jìn)階的自動(dòng)化功能。啟用后，你可以設(shè)定一些“條件觸發(fā)”任務(wù)。例如：“每天早上 8 點(diǎn)自動(dòng)抓取某網(wǎng)站的新聞并總結(jié)發(fā)到我的 Slack”，或者“當(dāng)我指定的文件夾有新文件時(shí)，自動(dòng)讓 AI 進(jìn)行分析”。為了更好地體驗(yàn)openclaw強(qiáng)大功能，推薦勾選以下hook，空格選中后，按回車鍵確認(rèn)進(jìn)入下一步設(shè)置：

▼ boot-md (啟動(dòng)加載 Markdown)：

作用：在 OpenClaw 每次啟動(dòng)（Boot）時(shí)，自動(dòng)讀取并加載一個(gè)特定的 Markdown (.md) 文件作為“初始系統(tǒng)提示詞（System Prompt）”或“行為規(guī)范”。

場(chǎng)景：你可以寫一個(gè) rules.md 文件，里面規(guī)定“你是一個(gè)嚴(yán)謹(jǐn)?shù)?Python 專家，請(qǐng)始終用中文回復(fù)，并且每次寫代碼前都要先寫測(cè)試”。開啟這個(gè) Hook 后，AI 每次啟動(dòng)都會(huì)自動(dòng)帶上這些規(guī)矩，不需要你每次都重復(fù)強(qiáng)調(diào)。

▼ bootstrap-extra-files (啟動(dòng)加載額外文件)：

作用：在 AI 啟動(dòng)時(shí)，自動(dòng)將指定的額外文件或整個(gè)文件夾的內(nèi)容“喂”給 AI 作為背景上下文。

場(chǎng)景：如果你正在讓 AI 幫你開發(fā)一個(gè)大型項(xiàng)目，你可以開啟這個(gè)選項(xiàng)，讓它每次開機(jī)自動(dòng)讀取你的項(xiàng)目結(jié)構(gòu)文件、API 文檔或者配置文件。這樣 AI 一上來(lái)就對(duì)你的項(xiàng)目了如指掌。

▼ session-memory (會(huì)話記憶)：

作用：賦予 AI “長(zhǎng)期記憶”。它會(huì)自動(dòng)保存你當(dāng)前會(huì)話的上下文和歷史記錄。

場(chǎng)景：默認(rèn)情況下，很多 AI 工具一重啟就會(huì)“失憶”，完全忘記昨天你們聊過(guò)什么。開啟這個(gè)選項(xiàng)后，下次啟動(dòng) OpenClaw，AI 就能無(wú)縫接續(xù)上次的工作進(jìn)度，記住之前的對(duì)話細(xì)節(jié)。

10. 網(wǎng)關(guān)服務(wù)配置：

選擇重啟網(wǎng)關(guān)服務(wù)以應(yīng)用配置。

11. 啟動(dòng)方式選擇：

選擇openclaw啟動(dòng)方式，建議直接選擇“Open the web UI”，直接打開openclaw圖形界面。

配置完成后，系統(tǒng)會(huì)自動(dòng)打開瀏覽器窗口，您即可開始與 OpenClaw 對(duì)話。

后續(xù)您可以通過(guò)在瀏覽器輸入：http://127.0.0.1:18789

隨時(shí)進(jìn)入openclaw web頁(yè)面與您的龍蝦進(jìn)行對(duì)話。

｜最佳實(shí)踐

本章節(jié)指導(dǎo)您使用 OpenClaw 的核心功能和常用操作。

場(chǎng)景1: 監(jiān)控與維護(hù)

OpenClaw 提供了一系列命令用于監(jiān)控和維護(hù)系統(tǒng)：

1. 查看日志

實(shí)時(shí)查看 OpenClaw 的運(yùn)行日志：

openclaw logs --follow

日志查看完畢后，可以按下Ctrl+C退出。

2. 檢查系統(tǒng)健康

檢查 OpenClaw 系統(tǒng)的健康狀態(tài)：

openclaw doctor

3. 更新到最新版本

更新 OpenClaw 到最新版本：

openclaw update

場(chǎng)景2: 與 AI 助手對(duì)話

配置完成后，您可以通過(guò)以下方式與 OpenClaw 交互：

瀏覽器界面：直接在瀏覽器中輸入問(wèn)題，OpenClaw 會(huì)實(shí)時(shí)回復(fù)。

聊天軟件：如果配置了 QQ、飛書或釘釘，可以直接在這些平臺(tái)上與 OpenClaw 對(duì)話。

OpenClaw 支持以下類型的任務(wù)：

文件操作：讀取、寫入、管理本地文件

命令執(zhí)行：執(zhí)行系統(tǒng)命令并返回結(jié)果

瀏覽器操控：打開網(wǎng)頁(yè)、獲取信息

代碼編寫：幫助您編寫和調(diào)試代碼

常用操作命令

安裝 curl

sudo apt install curl -y

安裝 OpenClaw

curl -fsSL https://openclaw.ai/install.sh | bash

查看日志

openclaw logs --follow

檢查系統(tǒng)健康

openclaw doctor

更新到最新版本

openclaw update

查看版本號(hào)

openclaw --version

打印web網(wǎng)頁(yè)鏈接地址

openclaw dashboard

查看完整配置

openclaw config get

查看skills列表

openclaw skills list

查看models列表

openclaw models list

啟動(dòng)網(wǎng)關(guān)

openclaw gateway start

停止網(wǎng)關(guān)

openclaw gateway stop

重啟網(wǎng)關(guān)

openclaw gateway restart

查看網(wǎng)關(guān)運(yùn)行狀態(tài)

openclaw gateway status

卸載OpenClaw

openclaw uninstall --all

｜附錄

核心亮點(diǎn)

OpenClaw 具有以下核心優(yōu)勢(shì)：

本地集成：與本地系統(tǒng)完全集成，擁有完整的系統(tǒng)訪問(wèn)權(quán)限

24/7 運(yùn)行：持續(xù)運(yùn)行，隨時(shí)響應(yīng)您的需求

多渠道支持：支持瀏覽器、QQ、飛書、釘釘?shù)榷喾N交互方式

智能行動(dòng)：不僅可以對(duì)話，還能執(zhí)行任務(wù)、操作文件

開源免費(fèi)：完全開源，免費(fèi)使用

模型切換

openclaw 支持接入多種國(guó)產(chǎn)和國(guó)際大模型，您可以根據(jù)自己的需要選擇合適的大模型供應(yīng)商，不僅可以讓你暢玩龍蝦，更能讓您的龍蝦更匹配您的需求。

以下是模型切換步驟：

1. 準(zhǔn)備工作：獲取 API Key

在切換前，請(qǐng)確保你已經(jīng)擁有大模型的API Key。

2. 交互式切換步驟：

這是修改默認(rèn)配置最直觀的方法，能確保 OpenClaw 正確識(shí)別供應(yīng)商：

a) 啟動(dòng)配置命令：

在終端輸入 openclaw config，先選擇Local，按下回車鍵確認(rèn)。

隨后選擇Model，按下回車鍵確認(rèn)，即可進(jìn)入供應(yīng)商選擇列表。

b) 選擇供應(yīng)商 (Auth Provider)：

如果列表中已有對(duì)應(yīng)的名字，如 MiniMax、Moonshot（即kimi）、Qwen、Z.AI（即智譜），直接選中。

如果沒(méi)有，請(qǐng)選擇 OpenAI (Custom)，因?yàn)閲?guó)內(nèi)廠商大多使用兼容 OpenAI 的接口協(xié)議，如接入deepseek-r1模型時(shí)，需要通過(guò)此方式。

c) 填寫 API Key：

粘貼你從官網(wǎng)獲取的長(zhǎng)字符串密鑰。

d) 輸入或選擇模型 ID：

手動(dòng)輸入該廠商的具體模型名稱，如：

DeepSeek 選：deepseek-chat 或 deepseek-reasoner

智譜 選：glm-4

保存并重啟：按回車完成剩余步驟。

注意：以上步驟的詳細(xì)說(shuō)明，請(qǐng)參考各個(gè)大模型廠商官方配置文檔。

3. 會(huì)話中快速切換

如果你已經(jīng)配置好了多個(gè)供應(yīng)商的環(huán)境變量，可以在聊天中直接通過(guò)指令切換。在 OpenClaw 運(yùn)行界面輸入：

切換到 DeepSeek: /model deepseek/deepseek-chat

常見問(wèn)題