OpenClaw安裝及正確用法總結(jié)指南

一、什么是OpenClaw?
OpenClaw是一款開源、自托管的AI智能體平臺,前身為Clawdbot、Moltbot。它的核心特點是**"真正能干活"**,而不是單純的聊天機器人。與傳統(tǒng)AI助手相比,OpenClaw具備:
執(zhí)行權(quán)限:可直接操作文件系統(tǒng)、運行終端命令、控制瀏覽器、收發(fā)郵件
持久記憶:通過SQLite向量數(shù)據(jù)庫存儲對話歷史、用戶偏好和任務(wù)記錄
多平臺連接:支持WhatsApp、Telegram、Discord、飛書、釘釘?shù)?0+聊天平臺
本地優(yōu)先:所有數(shù)據(jù)存儲在你的設(shè)備上,確保隱私安全
二、核心架構(gòu)與工作原理
三層架構(gòu)
Gateway網(wǎng)關(guān):核心協(xié)調(diào)層,通過WebSocket協(xié)議(默認(rèn)ws://127.0.0.1:18789)連接聊天工具和電腦系統(tǒng)
PiAgent運行時:大腦決策層,對接GPT、Claude等大模型,將自然語言指令拆解為操作步驟
執(zhí)行層:包含文件操作、瀏覽器控制、Shell命令執(zhí)行等工具,在Docker沙箱中運行
混合記憶系統(tǒng)
短期記憶:會話緩存,保留最近幾輪交互歷史
中期記憶:每日摘要與會話日志(JSONL文件格式)
長期記憶:核心知識庫(Markdown文件),包括MEMORY.md和USER.md
三、正確安裝步驟
系統(tǒng)要求
Node.js ≥ 22(必須)
操作系統(tǒng):macOS、Linux、Windows(強烈建議使用WSL2)
內(nèi)存:至少2GB RAM,推薦4GB以上
推薦安裝方式(一鍵腳本)
1# macOS/Linux用戶 2curl -fsSL https://openclaw.ai/install.sh | bash 3 4# Windows用戶(PowerShell) 5iwr -useb https://openclaw.ai/install.ps1 | iex
初始化配置
1# 運行配置向?qū)Р惭b后臺服務(wù) 2openclaw onboard --install-daemon
向?qū)Р襟E:
選擇本地或遠(yuǎn)程Gateway
配置AI模型認(rèn)證(推薦Anthropic API Key)
選擇聊天平臺(如WhatsApp、Telegram)
安裝守護(hù)進(jìn)程(macOS: launchd, Linux/WSL2: systemd)
四、核心配置要點
1. AI模型配置(必須)
推薦模型:
Anthropic Claude Opus 4.5(性能最佳)
Anthropic Claude Sonnet 4-20250514(性價比高)
國產(chǎn)模型:MiniMax、Qwen、GLM(國內(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# 手動啟動網(wǎng)關(guān) 5openclaw gateway --port 18789 --verbose 6 7# 查看實時日志 8openclaw logs --follow
3. 聊天平臺連接
WhatsApp配置
1# 登錄WhatsApp(生成二維碼) 2openclaw channels login whatsapp 3 4# 掃描二維碼:WhatsApp → 設(shè)置 → 已連接設(shè)備
飛書配置(國內(nèi)推薦)
訪問飛書開放平臺創(chuàng)建企業(yè)自建應(yīng)用
獲取App ID和App Secret
安裝飛書插件:
1openclaw plugins install @m1heng-clawd/feishu 2openclaw config set channels.feishu.appId "你的AppID" 3openclaw config set channels.feishu.appSecret "你的AppSecret"
釘釘配置(Stream模式)
釘釘開放平臺創(chuàng)建應(yīng)用,開啟Stream模式
獲取Client ID(AppKey)和Client Secret
配置OpenClaw憑據(jù)
五、安全最佳實踐
1. 部署環(huán)境隔離
絕對不要在主力電腦上部署OpenClaw!推薦以下安全環(huán)境:
| 環(huán)境 | 適用場景 | 優(yōu)點 |
|---|---|---|
| 虛擬機(Lima/Orbstack) | 個人嘗鮮 | 完全隔離,免費 |
| 云服務(wù)器(阿里云/騰訊云) | 生產(chǎn)環(huán)境 | 7x24在線,安全隔離 |
| Docker容器 | 開發(fā)測試 | 輕量級,易于管理 |
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消耗是按量計費,需特別注意:
高消耗原因:
每次對話需加載1.4萬token的"系統(tǒng)說明書"(基礎(chǔ)成本約4美分)
復(fù)雜任務(wù)采用ReAct架構(gòu),token消耗呈平方級增長
可能將整段HTML源碼塞進(jìn)上下文,造成資源浪費
成本控制方法:
定期使用/new命令:開始新對話,重置token累積
選擇合適模型:簡單任務(wù)用輕量模型(如Haiku)
監(jiān)控使用量:定期運行/usage cost查看費用
設(shè)置預(yù)算提醒:在API平臺設(shè)置費用上限
六、實用命令大全
1. 基礎(chǔ)管理命令
1# 查看整體狀態(tài) 2openclaw status 3 4# 檢查網(wǎng)關(guān)健康狀態(tài) 5openclaw health 6 7# 運行深度安全審計 8openclaw security audit --deep
2. 聊天中斜杠命令
| 命令 | 功能 | 使用場景 |
|---|---|---|
| /new | 新開對話 | 切換任務(wù)、節(jié)省token |
| /status | 查看會話狀態(tài) | 監(jiān)控當(dāng)前會話 |
| /model <模型名> | 切換模型 | 根據(jù)任務(wù)復(fù)雜度選擇 |
| /compact | 壓縮上下文 | 長對話時節(jié)省token |
| /usage full | 查看完整用量 | 成本監(jiān)控 |
| /exec host=sandbox | 設(shè)置執(zhí)行環(huán)境 | 安全執(zhí)行命令 |
| /approve <id> allow-once | 批準(zhǔn)操作 | 安全權(quán)限管理 |
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
七、實用場景與指令示例
1. 辦公自動化
1"請幫我: 21. 提取桌面『銷售數(shù)據(jù).xlsx』中A列的客戶名稱和C列的成交金額 32. 篩選出金額大于1萬的記錄 43. 生成新的Excel文件保存到『重要客戶』文件夾"
2. 郵件處理
1"請檢查我的收件箱,整理出: 21. 未讀的重要郵件(來自老板或重要客戶) 32. 需要回復(fù)的郵件列表 43. 本周收到的Newsletter摘要"
3. 文檔處理
1"從~/Downloads/report.pdf中提?。? 21. 關(guān)鍵數(shù)據(jù)指標(biāo) 32. 主要發(fā)現(xiàn) 43. 建議措施 5生成一份不超過500字的摘要"
4. 定時任務(wù)
1"每天早上8點幫我: 21. 檢查GitHub熱點 32. 生成中文簡報 43. 通過WhatsApp發(fā)送給我"
5. 瀏覽器自動化
1"請去MIT公開課官網(wǎng): 21. 搜索Python課程 32. 下載課件到桌面 43. 解壓文件 54. 將第一節(jié)課的課件發(fā)給我"
八、常見問題解決
1. 服務(wù)連接問題
癥狀:控制界面連接超時 解決:
重新生成Token:cat ~/.clawdbot/clawdbot.json | grep tok
檢查18789端口是否放行
重啟服務(wù):openclaw gateway restart
2. 模型調(diào)用失敗
癥狀:百煉模型調(diào)用無響應(yīng) 解決:
檢查API Key有效性
開通對應(yīng)模型調(diào)用權(quán)限
調(diào)整請求頻率,避免速率限制
3. 平臺對接故障
癥狀:釘釘/飛書消息推送失敗 解決:
確認(rèn)回調(diào)地址格式正確
檢查App ID/App Secret配置
開啟事件訂閱功能
4. 性能優(yōu)化
癥狀:服務(wù)運行卡頓 解決:
升級實例規(guī)格(至少4核8GB)
定期清理緩存目錄
啟用斷點續(xù)執(zhí)行功能
九、進(jìn)階功能
1. 多代理設(shè)置
1# 為不同場景創(chuàng)建獨立代理 2openclaw agents add work 3openclaw agents add personal 4 5# 切換代理 6openclaw agents switch work
2. 本地模型部署
1# 使用llama.cpp運行本地模型
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. 技能開發(fā)
技能目錄:~/.openclaw/workspace/skills/
技能文件:SKILL.md(技能說明)
工具開發(fā):支持MCP協(xié)議
十、重要提醒
1. 成本意識
OpenClaw不是固定月費工具,是按量計費的
復(fù)雜任務(wù)可能產(chǎn)生高額費用(有用戶一天花費100美元)
務(wù)必設(shè)置預(yù)算監(jiān)控和費用提醒
2. 安全第一
絕對不要在主力電腦上部署生產(chǎn)環(huán)境
使用沙箱模式執(zhí)行命令
定期備份重要數(shù)據(jù)
3. 合理期望
OpenClaw是強大的工具,但不是萬能的"賈維斯"
需要一定的技術(shù)背景和學(xué)習(xí)成本
從簡單任務(wù)開始,逐步掌握復(fù)雜功能
十一、學(xué)習(xí)資源
官方資源
官方網(wǎng)站:https://open-claw.me/zh
GitHub倉庫:https://github.com/openclaw/openclaw
社區(qū)支持
Discord社區(qū):超過50萬成員
ClawDHub技能市場:超千款技能
中文教程:阿里云、CSDN、腳本之家等平臺有詳細(xì)指南
最后建議:將OpenClaw視為實驗平臺或自動化腳本構(gòu)建器,而不是穩(wěn)定可靠的日常助手。從安全隔離的環(huán)境開始,掌握基礎(chǔ)功能后再逐步探索高級應(yīng)用。務(wù)必做好成本監(jiān)控和數(shù)據(jù)備份,確保在安全可控的前提下享受AI自動化帶來的便利。
到此這篇關(guān)于OpenClaw安裝及正確用法總結(jié)指南的文章就介紹到這了,更多相關(guān)OpenClaw安裝及用法內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章,希望大家以后多多支持腳本之家!
相關(guān)文章
本文檔聚焦輕量應(yīng)用服務(wù)器LS,全方位呈現(xiàn)開源AI助手OpenClaw的配置流程,從服務(wù)器實例創(chuàng)建、端口放行,到API密鑰配置、服務(wù)激活,步驟詳盡2026-03-03
OpenClaw 是一個可以部署在自己服務(wù)器上的 AI Agent,能通過 Telegram、飛書等渠道對話,幫你操控系統(tǒng)、定時任務(wù)、聯(lián)網(wǎng)搜索、寫代碼部署項目的等等,這篇文章記錄了我完整的2026-03-03
在Mac mini上安裝配置OpenClaw AI助手的詳細(xì)過程,包括通過Homebrew安裝、配置模型(如MiniMax、GLM)、連接聊天渠道(WhatsApp、Telegram、Discord),后續(xù)可以參考一下2026-03-03
OpenClaw安裝部署及應(yīng)用場景教程(2026最新完整版)
本文將從OpenClaw核心介紹、兩種主流安裝部署方案(新手友好型+深度定制型)、高頻避坑指南,到實際應(yīng)用場景全解析,全程實操落地,適合各類需求的使用者,收藏備用2026-03-02
OpenClaw(原Clawdbot/Moltbot)是一款開源的本地優(yōu)先AI代理與自動化平臺,支持多渠道通信集成、大模型調(diào)用及自動化任務(wù)執(zhí)行,可滿足個人與小型團(tuán)隊的智能輔助需求,這篇文章主2026-03-02
Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程
在 Windows 系統(tǒng)下的 WSL2 中安裝 OpenClaw 的完整詳細(xì)教程,你可以讓它運行在自己的電腦上,通過 WhatsApp、Telegram、Discord、Slack 等你已經(jīng)在用的聊天軟件與它對話2026-03-01
OpenClaw入門教程之介紹與安裝、配置分享 (原Clawdbot)
OpenClaw 是一個可執(zhí)行任務(wù)的智能體,我們給指令,它不僅回答,還能主動操作系統(tǒng)、訪問網(wǎng)頁、處理郵件、整理文件、發(fā)起提醒甚至自動編寫代碼2026-03-01








