｜項(xiàng)目簡介

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

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

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

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

｜前置條件

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

▼ 硬件：

AI算力本MTT AIBOOK，型號A141。

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

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

▼ 軟件：

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

Node.js >= 22。

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

網(wǎng)絡(luò)環(huá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

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

▼初始化配置

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

openclaw onboard

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

1. 安全提示頁面：

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

2. 模式選擇界面：

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

3. 模型選擇界面：

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

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

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

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”跳過該設(shè)置。

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

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

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

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

9. Hooks 功能配置：

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

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

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

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

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

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

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

▼ session-memory (會話記憶)：

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

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

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

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

11. 啟動方式選擇：

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

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

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

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

｜最佳實(shí)踐

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

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

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

1. 查看日志

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

openclaw logs --follow

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

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

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

openclaw doctor

3. 更新到最新版本

更新 OpenClaw 到最新版本：

openclaw update

場景2: 與 AI 助手對話

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

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

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

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

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

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

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

代碼編寫：幫助您編寫和調(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

查看版本號

openclaw --version

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

openclaw dashboard

查看完整配置

openclaw config get

查看skills列表

openclaw skills list

查看models列表

openclaw models list

啟動網(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)勢：

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

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

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

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

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

模型切換

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

以下是模型切換步驟：

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

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

2. 交互式切換步驟：

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

a) 啟動配置命令：

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

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

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

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

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

c) 填寫 API Key：

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

d) 輸入或選擇模型 ID：

手動輸入該廠商的具體模型名稱，如：

DeepSeek 選：deepseek-chat 或 deepseek-reasoner

智譜 選：glm-4

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

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

3. 會話中快速切換

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

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

常見問題