一、什么是OpenClaw？

OpenClaw是一款開(kāi)源、自托管的AI智能體平臺(tái)，前身為Clawdbot、Moltbot。它的核心特點(diǎn)是**"真正能干活"**，而不是單純的聊天機(jī)器人。與傳統(tǒng)AI助手相比，OpenClaw具備：

• 執(zhí)行權(quán)限：可直接操作文件系統(tǒng)、運(yùn)行終端命令、控制瀏覽器、收發(fā)郵件

• 持久記憶：通過(guò)SQLite向量數(shù)據(jù)庫(kù)存儲(chǔ)對(duì)話(huà)歷史、用戶(hù)偏好和任務(wù)記錄

• 多平臺(tái)連接：支持WhatsApp、Telegram、Discord、飛書(shū)、釘釘?shù)?0+聊天平臺(tái)

• 本地優(yōu)先：所有數(shù)據(jù)存儲(chǔ)在你的設(shè)備上，確保隱私安全

二、核心架構(gòu)與工作原理

三層架構(gòu)

1. Gateway網(wǎng)關(guān)：核心協(xié)調(diào)層，通過(guò)WebSocket協(xié)議（默認(rèn)ws://127.0.0.1:18789）連接聊天工具和電腦系統(tǒng)

2. PiAgent運(yùn)行時(shí)：大腦決策層，對(duì)接GPT、Claude等大模型，將自然語(yǔ)言指令拆解為操作步驟

3. 執(zhí)行層：包含文件操作、瀏覽器控制、Shell命令執(zhí)行等工具，在Docker沙箱中運(yùn)行

混合記憶系統(tǒng)

• 短期記憶：會(huì)話(huà)緩存，保留最近幾輪交互歷史

• 中期記憶：每日摘要與會(huì)話(huà)日志（JSONL文件格式）

• 長(zhǎng)期記憶：核心知識(shí)庫(kù)（Markdown文件），包括MEMORY.md和USER.md

三、正確安裝步驟

系統(tǒng)要求

• Node.js ≥ 22（必須）

• 操作系統(tǒng)：macOS、Linux、Windows（強(qiáng)烈建議使用WSL2）

• 內(nèi)存：至少2GB RAM，推薦4GB以上

推薦安裝方式（一鍵腳本）

1# macOS/Linux用戶(hù)
2curl -fsSL https://openclaw.ai/install.sh | bash
3
4# Windows用戶(hù)（PowerShell）
5iwr -useb https://openclaw.ai/install.ps1 | iex

初始化配置

1# 運(yùn)行配置向?qū)Р惭b后臺(tái)服務(wù)
2openclaw onboard --install-daemon

向?qū)Р襟E：

1. 選擇本地或遠(yuǎn)程Gateway

2. 配置AI模型認(rèn)證（推薦Anthropic API Key）

3. 選擇聊天平臺(tái)（如WhatsApp、Telegram）

4. 安裝守護(hù)進(jìn)程（macOS: launchd, Linux/WSL2: systemd）

四、核心配置要點(diǎn)

1. AI模型配置（必須）

推薦模型：

• Anthropic Claude Opus 4.5（性能最佳）

• Anthropic Claude Sonnet 4-20250514（性?xún)r(jià)比高）

• 國(guó)產(chǎn)模型：MiniMax、Qwen、GLM（國(guó)內(nèi)網(wǎng)絡(luò)友好）

配置文件位置：~/.openclaw/openclaw.json

1{
2  "env": { "ANTHROPIC_API_KEY": "sk-ant-..." },
3  "agents": { 
4    "defaults": { 
5      "model": { "primary": "anthropic/claude-opus-4-5" } 
6    } 
7  }
8}

2. Gateway網(wǎng)關(guān)配置

默認(rèn)設(shè)置：

• 端口：18789

• 綁定地址：127.0.0.1（本地回環(huán)）

• 認(rèn)證方式：token/password

常用命令：

1# 檢查服務(wù)狀態(tài)
2openclaw gateway status
3
4# 手動(dòng)啟動(dòng)網(wǎng)關(guān)
5openclaw gateway --port 18789 --verbose
6
7# 查看實(shí)時(shí)日志
8openclaw logs --follow

3. 聊天平臺(tái)連接

WhatsApp配置

1# 登錄WhatsApp（生成二維碼）
2openclaw channels login whatsapp
3
4# 掃描二維碼：WhatsApp → 設(shè)置 → 已連接設(shè)備

飛書(shū)配置（國(guó)內(nèi)推薦）

1. 訪(fǎng)問(wèn)飛書(shū)開(kāi)放平臺(tái)創(chuàng)建企業(yè)自建應(yīng)用

2. 獲取App ID和App Secret

3. 安裝飛書(shū)插件：

1openclaw plugins install @m1heng-clawd/feishu
2openclaw config set channels.feishu.appId "你的AppID"
3openclaw config set channels.feishu.appSecret "你的AppSecret"

釘釘配置（Stream模式）

1. 釘釘開(kāi)放平臺(tái)創(chuàng)建應(yīng)用，開(kāi)啟Stream模式

2. 獲取Client ID（AppKey）和Client Secret

3. 配置OpenClaw憑據(jù)

五、安全最佳實(shí)踐

1. 部署環(huán)境隔離

絕對(duì)不要在主力電腦上部署OpenClaw！推薦以下安全環(huán)境：

2. 權(quán)限控制

1{
2  "fileSystem": {
3    "allowedPaths": ["/home/user/documents"],
4    "blockedPaths": ["/etc", "/var", "/root"]
5  },
6  "agents": {
7    "defaults": {
8      "sandbox": { "mode": "non-main" }
9    }
10  }
11}

3. 成本控制策略

OpenClaw的token消耗是按量計(jì)費(fèi)，需特別注意：

高消耗原因：

• 每次對(duì)話(huà)需加載1.4萬(wàn)token的"系統(tǒng)說(shuō)明書(shū)"（基礎(chǔ)成本約4美分）

• 復(fù)雜任務(wù)采用ReAct架構(gòu)，token消耗呈平方級(jí)增長(zhǎng)

• 可能將整段HTML源碼塞進(jìn)上下文，造成資源浪費(fèi)

成本控制方法：

1. 定期使用/new命令：開(kāi)始新對(duì)話(huà)，重置token累積

2. 選擇合適模型：簡(jiǎn)單任務(wù)用輕量模型（如Haiku）

3. 監(jiān)控使用量：定期運(yùn)行/usage cost查看費(fèi)用

4. 設(shè)置預(yù)算提醒：在API平臺(tái)設(shè)置費(fèi)用上限

六、實(shí)用命令大全

1. 基礎(chǔ)管理命令

1# 查看整體狀態(tài)
2openclaw status
3
4# 檢查網(wǎng)關(guān)健康狀態(tài)
5openclaw health
6
7# 運(yùn)行深度安全審計(jì)
8openclaw security audit --deep

2. 聊天中斜杠命令

3. 技能管理

1# 列出可用技能
2openclaw skills list
3
4# 安裝技能（如網(wǎng)絡(luò)搜索）
5openclaw skills install web-search
6
7# 啟用技能
8openclaw skills enable github
9
10# 更新所有技能
11openclaw skills update all

七、實(shí)用場(chǎng)景與指令示例

1. 辦公自動(dòng)化

1"請(qǐng)幫我：
21. 提取桌面『銷(xiāo)售數(shù)據(jù).xlsx』中A列的客戶(hù)名稱(chēng)和C列的成交金額
32. 篩選出金額大于1萬(wàn)的記錄
43. 生成新的Excel文件保存到『重要客戶(hù)』文件夾"

2. 郵件處理

1"請(qǐng)檢查我的收件箱，整理出：
21. 未讀的重要郵件（來(lái)自老板或重要客戶(hù)）
32. 需要回復(fù)的郵件列表
43. 本周收到的Newsletter摘要"

3. 文檔處理

1"從~/Downloads/report.pdf中提?。?
21. 關(guān)鍵數(shù)據(jù)指標(biāo)
32. 主要發(fā)現(xiàn)
43. 建議措施
5生成一份不超過(guò)500字的摘要"

4. 定時(shí)任務(wù)

1"每天早上8點(diǎn)幫我：
21. 檢查GitHub熱點(diǎn)
32. 生成中文簡(jiǎn)報(bào)
43. 通過(guò)WhatsApp發(fā)送給我"

5. 瀏覽器自動(dòng)化

1"請(qǐng)去MIT公開(kāi)課官網(wǎng)：
21. 搜索Python課程
32. 下載課件到桌面
43. 解壓文件
54. 將第一節(jié)課的課件發(fā)給我"

八、常見(jiàn)問(wèn)題解決

1. 服務(wù)連接問(wèn)題

癥狀：控制界面連接超時(shí) 解決：

1. 重新生成Token：cat ~/.clawdbot/clawdbot.json | grep tok

2. 檢查18789端口是否放行

3. 重啟服務(wù)：openclaw gateway restart

2. 模型調(diào)用失敗

癥狀：百煉模型調(diào)用無(wú)響應(yīng) 解決：

1. 檢查API Key有效性

2. 開(kāi)通對(duì)應(yīng)模型調(diào)用權(quán)限

3. 調(diào)整請(qǐng)求頻率，避免速率限制

3. 平臺(tái)對(duì)接故障

癥狀：釘釘/飛書(shū)消息推送失敗 解決：

1. 確認(rèn)回調(diào)地址格式正確

2. 檢查App ID/App Secret配置

3. 開(kāi)啟事件訂閱功能

4. 性能優(yōu)化

癥狀：服務(wù)運(yùn)行卡頓 解決：

1. 升級(jí)實(shí)例規(guī)格（至少4核8GB）

2. 定期清理緩存目錄

3. 啟用斷點(diǎn)續(xù)執(zhí)行功能

九、進(jìn)階功能

1. 多代理設(shè)置

1# 為不同場(chǎng)景創(chuàng)建獨(dú)立代理
2openclaw agents add work
3openclaw agents add personal
4
5# 切換代理
6openclaw agents switch work

2. 本地模型部署

1# 使用llama.cpp運(yùn)行本地模型
2git clone https://github.com/ggerganov/llama.cpp.git
3cd llama.cpp
4make -j$(nproc) llama-cli llama-server
5
6# 配置OpenClaw使用本地模型
7{
8  "models": {
9    "providers": {
10      "local-llama": {
11        "baseUrl": "http://localhost:8080/v1",
12        "apiKey": "sk-no-key-required"
13      }
14    }
15  }
16}

3. 技能開(kāi)發(fā)

• 技能目錄：~/.openclaw/workspace/skills/

• 技能文件：SKILL.md（技能說(shuō)明）

• 工具開(kāi)發(fā)：支持MCP協(xié)議

十、重要提醒

1. 成本意識(shí)

• OpenClaw不是固定月費(fèi)工具，是按量計(jì)費(fèi)的

• 復(fù)雜任務(wù)可能產(chǎn)生高額費(fèi)用（有用戶(hù)一天花費(fèi)100美元）

• 務(wù)必設(shè)置預(yù)算監(jiān)控和費(fèi)用提醒

2. 安全第一

• 絕對(duì)不要在主力電腦上部署生產(chǎn)環(huán)境

• 使用沙箱模式執(zhí)行命令

• 定期備份重要數(shù)據(jù)

3. 合理期望

• OpenClaw是強(qiáng)大的工具，但不是萬(wàn)能的"賈維斯"

• 需要一定的技術(shù)背景和學(xué)習(xí)成本

• 從簡(jiǎn)單任務(wù)開(kāi)始，逐步掌握復(fù)雜功能

十一、學(xué)習(xí)資源

官方資源

• 官方網(wǎng)站：https://open-claw.me/zh

• GitHub倉(cāng)庫(kù)：https://github.com/openclaw/openclaw

• 文檔中心：https://docs.openclaw.ai

社區(qū)支持

• Discord社區(qū)：超過(guò)50萬(wàn)成員

• ClawDHub技能市場(chǎng)：超千款技能

• 中文教程：阿里云、CSDN、腳本之家等平臺(tái)有詳細(xì)指南

最后建議：將OpenClaw視為實(shí)驗(yàn)平臺(tái)或自動(dòng)化腳本構(gòu)建器，而不是穩(wěn)定可靠的日常助手。從安全隔離的環(huán)境開(kāi)始，掌握基礎(chǔ)功能后再逐步探索高級(jí)應(yīng)用。務(wù)必做好成本監(jiān)控和數(shù)據(jù)備份，確保在安全可控的前提下享受AI自動(dòng)化帶來(lái)的便利。

到此這篇關(guān)于OpenClaw安裝及正確用法總結(jié)指南的文章就介紹到這了,更多相關(guān)OpenClaw安裝及用法內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論