前言

什么是 OpenClaw？—— 你的本地 AI 智能體執(zhí)行框架

OpenClaw 不僅僅是一個(gè)聊天機(jī)器人，而是一個(gè)功能強(qiáng)大的 AI 智能體執(zhí)行框架。你可以把它想象成一個(gè)能自主思考、調(diào)用工具、并替你完成復(fù)雜任務(wù)的數(shù)字員工。

核心概念

• 智能體：OpenClaw 的核心大腦。它能理解你的自然語(yǔ)言指令，拆解任務(wù)，并決定調(diào)用哪些工具來執(zhí)行。
• 網(wǎng)關(guān)：所有外部訪問的入口。它負(fù)責(zé)處理 WebSocket 連接、管理設(shè)備配對(duì)、路由消息，是你與智能體交互的橋梁。
• 技能：智能體可調(diào)用的具體工具，比如訪問文件、操作瀏覽器、發(fā)送消息、查詢數(shù)據(jù)庫(kù)等。你可以根據(jù)需要擴(kuò)展技能庫(kù)。
• 記憶：OpenClaw 可以存儲(chǔ)對(duì)話歷史和重要信息，實(shí)現(xiàn)長(zhǎng)期記憶和上下文理解，讓交互更連貫。
• 通道：連接外部聊天平臺(tái)的渠道，如 WhatsApp、Telegram、Discord 等。你可以讓智能體通過你熟悉的聊天應(yīng)用與你交互。

它能做什么？

• 自動(dòng)化任務(wù)：例如定時(shí)備份文件、自動(dòng)整理下載文件夾、根據(jù)郵件內(nèi)容回復(fù)、在日歷上創(chuàng)建日程。
• 信息處理：從網(wǎng)頁(yè)抓取數(shù)據(jù)、總結(jié)文檔、翻譯文本、生成報(bào)告。
• 系統(tǒng)交互：在授權(quán)下，它可以執(zhí)行本地命令、管理文件、啟動(dòng)應(yīng)用程序。
• 多平臺(tái)連接：通過通道，你可以讓智能體接入 Slack、Discord 等團(tuán)隊(duì)協(xié)作工具，成為團(tuán)隊(duì)中的 AI 成員。

為什么選擇 OpenClaw？

• 本地運(yùn)行：所有數(shù)據(jù)都在你自己的電腦上，無需上傳到云端，隱私安全可控。
• 模型自由：支持多種 AI 模型提供商（如 OpenAI、Anthropic、硅基流動(dòng)），甚至可以通過 Ollama 使用完全本地化的開源模型，零成本運(yùn)行。
• 高度可擴(kuò)展：通過插件和自定義技能，你可以讓 OpenClaw 適應(yīng)任何你想自動(dòng)化的場(chǎng)景。
• 開源透明：代碼公開，你可以審計(jì)其行為，確保安全。

安全提示

由于 OpenClaw 可以訪問你的系統(tǒng)和數(shù)據(jù)，務(wù)必保護(hù)好你的 API 密鑰和配對(duì) Token。建議在隔離的環(huán)境中測(cè)試，并仔細(xì)審查其技能權(quán)限。

接下來，我們將一步步在 macOS 上通過 Docker 安裝并配置 OpenClaw，讓它真正成為你的個(gè)人 AI 助理。

1. 環(huán)境準(zhǔn)備

1.1 安裝 Docker Desktop for Mac

• 訪問 Docker 官網(wǎng) 下載 Docker Desktop for Mac（Intel 芯片或 Apple Silicon 根據(jù)你的 Mac 選擇）。
• 安裝完成后，啟動(dòng) Docker，確認(rèn)菜單欄出現(xiàn) Docker 圖標(biāo)，并且終端運(yùn)行 docker --version 能正常輸出版本號(hào)。

1.2 拉取 OpenClaw 鏡像

OpenClaw 官方鏡像托管在騰訊云容器鏡像服務(wù)上，執(zhí)行以下命令拉取最新版：

docker pull sgccr.ccs.tencentyun.com/openclaw/openclaw:latest

2. 啟動(dòng) OpenClaw 容器

使用以下命令運(yùn)行容器（注意替換容器名，這里我們用 openclaw）：

docker run -d \
  --name openclaw \
  -p 18789:18789 \
  -v openclaw-data:/data \
  sgccr.ccs.tencentyun.com/openclaw/openclaw:latest \
  openclaw gateway run --bind lan --port 18789 --allow-unconfigured

參數(shù)解釋：

• -d：后臺(tái)運(yùn)行容器。
• --name openclaw：給容器命名，方便后續(xù)操作。
• -p 18789:18789：將容器的 18789 端口映射到本機(jī)，用于訪問 Web 控制臺(tái)。
• -v openclaw-data:/data：創(chuàng)建一個(gè) Docker 卷 openclaw-data，掛載到容器內(nèi)的 /data 目錄，用于持久化配置和狀態(tài)。
• openclaw gateway run ...：容器啟動(dòng)后執(zhí)行的命令，以網(wǎng)關(guān)模式運(yùn)行，監(jiān)聽所有網(wǎng)絡(luò)接口（--bind lan），端口 18789，允許未完全配置的狀態(tài)下啟動(dòng)（--allow-unconfigured）。

驗(yàn)證容器運(yùn)行：

docker ps

輸出應(yīng)顯示 openclaw 容器狀態(tài)為 Up，且端口映射正確。

3. 首次訪問控制臺(tái)并獲取 Token

3.1 打開控制臺(tái)

在瀏覽器中訪問 http://localhost:18789，你會(huì)看到 OpenClaw 的儀表板頁(yè)面，但狀態(tài)顯示為“Disconnected”，并提示需要 Token。

3.2 獲取初始 Token

OpenClaw 在首次啟動(dòng)時(shí)會(huì)自動(dòng)生成一個(gè) Token。執(zhí)行以下命令查看日志獲取 Token：

docker logs openclaw | grep -i token

你應(yīng)該看到類似：

auth token was missing. Generated a new token and saved it to config (gateway.auth.token).

但日志中并不會(huì)直接打印 Token 值，需要用命令從配置中讀?。?/p>

docker exec openclaw openclaw config get gateway.auth.token

輸出一串長(zhǎng)字符串（例如 ed0904424aca*******0562a93847c142684339138a7），復(fù)制保存，后續(xù)需要用到。

3.3 填入 Token 并嘗試連接

在瀏覽器頁(yè)面中，找到“Gateway Token”輸入框，粘貼復(fù)制的 Token，然后點(diǎn)擊右下角的 Connect 按鈕。此時(shí)可能會(huì)遇到兩種錯(cuò)誤：

• pairing required：表示設(shè)備需要配對(duì)，見下一節(jié)。
• control ui requires device identity：確保你使用的是 http://localhost:18789 而非 IP 地址，否則瀏覽器會(huì)因安全策略阻止連接。

4. 設(shè)備配對(duì)（解決pairing required）

首次連接時(shí)，OpenClaw 要求手動(dòng)批準(zhǔn)設(shè)備。即使 Token 正確，也需要執(zhí)行配對(duì)操作。

4.1 查看待配對(duì)設(shè)備

進(jìn)入容器：

docker exec -it openclaw sh

運(yùn)行：

openclaw devices list

輸出會(huì)列出待處理的配對(duì)請(qǐng)求（Pending），其中應(yīng)包含一個(gè)來自你本地 IP（如 192.168.65.1）的請(qǐng)求。例如：

Pending (2)
┌──────────────────────────────────────┬───────────────────────────────────┬──────────┬──────────────┐
│ Request                              │ Device                            │ Role     │ IP           │
├──────────────────────────────────────┼───────────────────────────────────┼──────────┼──────────────┤
│ a66fb94c-***-***2c4c21241c72 │ d53730f4722d2f9867ff6f0bbb70d2f8... │ operator │ 192.168.65.1 │

4.2 批準(zhǔn)設(shè)備

使用請(qǐng)求 ID（第一列）批準(zhǔn)：

openclaw devices approve a66fb94c-060****8-2c4c21241c72

或使用設(shè)備 ID（第二列）：

openclaw devices approve d53730f4722d2f******43d4d86f85e143f0498b66a98

批準(zhǔn)后，退出容器（exit），刷新瀏覽器頁(yè)面，此時(shí)應(yīng)該顯示“Connected”，網(wǎng)關(guān)狀態(tài)變?yōu)榫G色。

5. 配置 AI 模型提供商（以硅基流動(dòng)為例）

OpenClaw 默認(rèn)使用 Anthropic 的 Claude 模型，但我們需要配置國(guó)內(nèi)可用的硅基流動(dòng)（SiliconFlow）API。

5.1 獲取硅基流動(dòng) API 密鑰

1. 注冊(cè)/登錄 硅基流動(dòng)控制臺(tái)。
2. 在“賬戶管理” -> “API 密鑰”中，點(diǎn)擊“新建 API 密鑰”，生成一個(gè)以 sk- 開頭的密鑰，復(fù)制并妥善保存（注意保密，不要泄露）。

5.2 在 OpenClaw 中添加自定義模型提供商

進(jìn)入容器：

docker exec -it openclaw sh

運(yùn)行交互式命令添加 OpenAI 兼容的提供商：

openclaw models auth add

按提示操作：

• 當(dāng)出現(xiàn)“Token provider”時(shí)，選擇 custom（或 OpenAI-compatible）。
• 輸入 Provider id：例如 siliconflow。
• 輸入 Base URL：https://api.siliconflow.cn/v1
• 輸入 API Key：粘貼你剛獲取的密鑰。
• 輸入 Default model：選擇一個(gè)模型 ID，例如 deepseek-ai/DeepSeek-V3（可從硅基流動(dòng)的“模型廣場(chǎng)”查找）。
• 其他選項(xiàng)（如模型類型、是否設(shè)為默認(rèn)）按回車接受默認(rèn)。

完成添加后，會(huì)自動(dòng)將模型寫入配置?？梢则?yàn)證：

openclaw config get models.providers.siliconflow

輸出應(yīng)包含 baseUrl、apiKey、models 數(shù)組等信息。

5.3 設(shè)置默認(rèn)模型

雖然上一步設(shè)置了默認(rèn)模型，但為了確保，可以手動(dòng)指定：

openclaw models set siliconflow/deepseek-ai/DeepSeek-V3

如果模型 ID 格式正確，會(huì)提示配置文件已更新。

退出容器：exit

5.4 重啟容器使配置生效

docker restart openclaw

重啟后，查看日志確認(rèn)模型已切換：

docker logs openclaw --tail 20 | grep "agent model"

應(yīng)輸出類似：

[gateway] agent model: siliconflow/deepseek-ai/DeepSeek-V3

6. 測(cè)試 AI 對(duì)話

回到瀏覽器 http://localhost:18789，進(jìn)入 Chat 頁(yè)面。在輸入框中發(fā)送任意消息，Agent 應(yīng)該會(huì)調(diào)用硅基流動(dòng)的模型進(jìn)行回復(fù)。如果出現(xiàn)錯(cuò)誤，請(qǐng)檢查：

• 硅基流動(dòng)賬戶是否有余額（新注冊(cè)用戶通常有免費(fèi)額度）。
• API 密鑰是否有效，是否被泄露（如有泄露請(qǐng)立即吊銷并重新生成）。
• 控制臺(tái)日志：docker logs openclaw --tail 50 查看詳細(xì)錯(cuò)誤。

7. 常見問題與解決方案

7.1 容器啟動(dòng)后立即退出

• 原因：?jiǎn)?dòng)命令中未保持前臺(tái)進(jìn)程，或配置缺失導(dǎo)致網(wǎng)關(guān)退出。
• 解決：使用本教程提供的命令（直接運(yùn)行 openclaw gateway run，不加 sh -c 和后臺(tái)符）。

7.2 連接時(shí)提示pairing required但 devices list 為空

• 原因：沒有觸發(fā)配對(duì)請(qǐng)求，或 token 不正確。
• 解決：在瀏覽器中清除站點(diǎn)數(shù)據(jù)（LocalStorage），重新填入 token 并點(diǎn)擊 Connect，同時(shí)實(shí)時(shí)監(jiān)控日志 docker logs -f openclaw，觀察是否有配對(duì)碼出現(xiàn)。也可嘗試重啟容器。

7.3 配置模型時(shí)出現(xiàn)Config validation failed: models.providers.siliconflow.models: expected array

• 原因：手動(dòng)設(shè)置提供商配置時(shí)缺少 models 字段。
• 解決：使用 openclaw models auth add 交互式添加，會(huì)自動(dòng)生成正確結(jié)構(gòu)。

7.4 發(fā)送消息后返回 HTTP 403

• 原因：默認(rèn)模型仍為 Anthropic，或硅基流動(dòng) API 密鑰無效/余額不足。
• 解決：確保 gateway.agent.model 已改為硅基流動(dòng)的模型 ID，并檢查密鑰有效性。

7.5 如何更新 OpenClaw 版本？

• 進(jìn)入容器：docker exec -it openclaw sh
• 運(yùn)行：openclaw update
• 退出并重啟：docker restart openclaw

8. 安全提醒

• API 密鑰保護(hù)：切勿將密鑰明文分享或提交到公開代碼庫(kù)。
• 定期輪換：建議每隔一段時(shí)間更換 API 密鑰，降低風(fēng)險(xiǎn)。
• 數(shù)據(jù)持久化：使用 Docker 卷（-v openclaw-data:/data）確保配置和狀態(tài)不會(huì)因容器刪除而丟失。

通過以上步驟，你應(yīng)該能在 macOS 上成功運(yùn)行 OpenClaw，并連接到硅基流動(dòng)的 AI 模型?，F(xiàn)在你可以開始探索 OpenClaw 的更多功能，如連接聊天頻道、管理 Agent 等。如果遇到其他問題，歡迎查閱官方文檔或社區(qū)支持。

到此這篇關(guān)于macOS系統(tǒng)上通過Docker本地安裝OpenClaw的文章就介紹到這了,更多相關(guān)Docker本地安裝OpenClaw內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論