OpenClaw（小龍蝦）是本地AI智能體框架，支持本地Ollama開源免費模型、國內(nèi)免費云大模型、飛書機器人聯(lián)動，可遠程通過飛書下發(fā)指令操控本地電腦、執(zhí)行文檔/代碼/自動化任務(wù)。

一、安裝前置要求

1. Node.js 版本強制：≥22.19 / 24+，推薦Node24 LTS
2. 系統(tǒng)：Windows10+/macOS全系列/Linux Ubuntu/Debian/WSL2
3. Windows：管理員權(quán)限運行終端，臨時關(guān)閉殺毒/Defender實時防護（避免攔截讀寫、鍵鼠操作）
4. 安裝路徑純英文無中文空格
5. 端口放行：本地網(wǎng)關(guān)默認(rèn)18789，飛書長連接無需公網(wǎng)端口映射

二、全平臺一鍵安裝（推薦新手）

1. Windows（PowerShell管理員）

官方原版腳本

iwr -useb https://openclaw.ai/install.ps1 | iex

國內(nèi)加速鏡像（解決下載超時）

iwr -useb https://open-claw.org.cn/install-cn.ps1 | iex

若提示腳本禁止執(zhí)行，先解鎖權(quán)限：

Set-ExecutionPolicy RemoteSigned -Scope CurrentUser
# 輸入Y確認(rèn)，再執(zhí)行安裝腳本

2. macOS / Linux / WSL2

官方腳本

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

國內(nèi)加速

curl -fsSL https://open-claw.org.cn/install-cn.sh | bash

3. npm手動安裝（開發(fā)者精準(zhǔn)控版本）

# 全局安裝
npm install -g openclaw@latest
# pnpm更快（推薦）
pnpm add -g openclaw@latest
pnpm approve-builds -g

4. 驗證安裝成功

新開終端執(zhí)行，輸出版本號即正常

openclaw --version
# 初始化向?qū)Вㄊ状伪嘏埽?
openclaw onboard
# 啟動網(wǎng)關(guān)服務(wù)（核心后臺）
openclaw gateway start
# 查看網(wǎng)關(guān)運行狀態(tài)
openclaw gateway status

三、免費模型兩種配置方案（零付費）

方案A：本地Ollama開源模型（完全離線、永久免費，首選）

全程不消耗API額度，本地顯卡運行，支持工具調(diào)用（飛書指令執(zhí)行依賴）

步驟1：安裝Ollama

官網(wǎng)下載：ollama.com

• Windows/macOS：圖形安裝包
• Linux一鍵腳本

curl -fsSL https://ollama.com/install.sh | sh

步驟2：拉取適配OpenClaw的免費模型（支持Function Call）

輕量低配電腦（8G內(nèi)存）

ollama pull qwen3.5:7b

16G內(nèi)存通用辦公/代碼

ollama pull qwen2.5:14b
ollama pull deepseek-r1:14b # 推理強，文檔分析

32G內(nèi)存高性能

ollama pull qwen3.5:27b

查看已下載模型

ollama list

步驟3：OpenClaw綁定Ollama本地模型

1. Ollama保持后臺運行（默認(rèn)地址http://127.0.0.1:11434）
2. OpenClaw添加本地模型源

openclaw models add ollama
# 選擇默認(rèn)主模型
openclaw models set ollama/qwen3.5:7b
# 校驗?zāi)Ｐ蜖顟B(tài)
openclaw models status
# 測試對話
openclaw chat "測試本地模型是否可用"

方案B：國內(nèi)云模型免費額度（無顯卡電腦，聯(lián)網(wǎng)使用）

1. 通義千問免費版（阿里百煉，個人每月免費token）

1. 阿里云百煉控制臺創(chuàng)建API Key
2. OpenClaw配置密鑰

openclaw models auth setup-token --provider qwen
# 粘貼API Key，設(shè)置默認(rèn)模型
openclaw models set qwen-portal/coder-model

2. 智譜GLM免費個人套餐

1. 智譜開放平臺獲取API Key
2. 配置命令

openclaw models auth setup-token --provider zhipu
openclaw models set glm-4-flash # 免費高速版

模型通用調(diào)試命令

/model list        # 查看所有可用模型
/model 模型名      # 臨時切換對話模型
openclaw doctor --fix # 自動修復(fù)模型配置異常

四、飛書機器人完整連接教程（長連接無需內(nèi)網(wǎng)穿透）

階段1：飛書開放平臺創(chuàng)建企業(yè)自建應(yīng)用

登錄飛書開放平臺：open.feishu.cn，創(chuàng)建企業(yè)自建應(yīng)用，填寫名稱OpenClaw本地助手

添加應(yīng)用能力 → 開啟【機器人】

復(fù)制基礎(chǔ)憑證：App ID、App Secret、Verification Token

權(quán)限批量導(dǎo)入（必須）

權(quán)限管理 → 批量導(dǎo)入，粘貼最小權(quán)限JSON：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:chat",
      "contact:user",
      "docx:document:readonly",
      "drive:file:readonly"
    ]
  }
}

事件訂閱配置（關(guān)鍵）

• 訂閱方式：長連接接收事件（無需公網(wǎng)IP/ngrok）
• 添加事件：im.message.receive_v1（接收消息）
• 保存并開通事件權(quán)限

版本管理 → 發(fā)布應(yīng)用到企業(yè)內(nèi)部

階段2：OpenClaw配置飛書通道

終端添加飛書渠道

openclaw channel add feishu

按交互提示依次粘貼：AppID、AppSecret、VerificationToken

進階參數(shù)手動配置（允許私聊、全群響應(yīng)）

openclaw config set channels.feishu.dmPolicy open
openclaw config set channels.feishu.allowFrom '["*"]' --strict-json

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

openclaw gateway restart

階段3：測試驗證

1. 飛書搜索機器人名稱，添加至群聊/發(fā)起單聊
2. @機器人發(fā)送指令：列出桌面所有文件
3. 本地OpenClaw執(zhí)行任務(wù)并返回結(jié)果即對接成功

多機器人擴展

# 添加第二個獨立飛書機器人
openclaw channel add feishu --name feishu_work

五、高頻常見問題與一鍵排查方案

安裝啟動類報錯

1.openclaw 不是有效命令

原因：npm全局路徑未加入系統(tǒng)環(huán)境變量

修復(fù)：

• Windows：環(huán)境變量Path新增C:\Users\用戶名\AppData\Roaming\npm
• 重裝全局包：npm uninstall -g openclaw && npm install -g openclaw

2.網(wǎng)關(guān)啟動失敗、端口18789被占用

# Windows查找占用端口進程
netstat -ano | findstr 18789
# Linux/macOS
lsof -i:18789
# 強制重啟網(wǎng)關(guān)
openclaw gateway stop && openclaw gateway start

3.殺毒軟件直接刪除OpenClaw文件

臨時關(guān)閉實時防護，解壓/安裝完成后添加安裝目錄信任白名單

模型配置異常

1.Ollama模型調(diào)用超時、無返回

• 確認(rèn)ollama服務(wù)運行：ollama list有輸出
• 修改配置文件~/.openclaw/config.yaml，添加超時參數(shù)

modelGateway:
  ollamaTimeout: 60000

重啟網(wǎng)關(guān)：openclaw gateway restart

2.工具調(diào)用失敗（飛書下發(fā)指令無操作）

原因：模型不支持Function Call（如舊版Llama、Gemma2基礎(chǔ)版）

修復(fù)：切換Qwen2.5/DeepSeek-R1系列模型

3.提示上下文窗口不足

編輯config.yaml增大上下文

contextWindow: 65536

4.云模型提示No API key found

# 重新綁定密鑰
openclaw models auth setup-token --provider qwen
openclaw models status

飛書機器人無響應(yīng)（最常見）

1.@機器人完全不回復(fù)消息

排查流程：

① 檢查網(wǎng)關(guān)：openclaw gateway status必須顯示running

② 查看實時日志定位錯誤

openclaw logs --follow

③ 飛書后臺校驗：權(quán)限全部開通、事件訂閱為長連接、應(yīng)用已發(fā)布

④ 重新錄入AppID/AppSecret并重啟網(wǎng)關(guān)

2.機器人能收到消息，但執(zhí)行本地任務(wù)報錯

• 關(guān)閉Windows UAC權(quán)限限制，以管理員啟動OpenClaw
• 確認(rèn)Ollama/云模型正常運行

3.只能單聊、群聊@無響應(yīng)

修改配置放開群聊權(quán)限：

openclaw config set channels.feishu.allowGroup true
openclaw gateway restart

通用萬能排查命令

# 自動檢測并修復(fù)全部配置問題
openclaw doctor --fix
# 實時查看運行日志
openclaw logs --follow
# 重置全部配置（無法修復(fù)時終極方案）
openclaw config reset
openclaw gateway restart

六、基礎(chǔ)運維常用命令匯總

# 網(wǎng)關(guān)生命周期
openclaw gateway start    # 啟動后臺服務(wù)
openclaw gateway stop     # 停止服務(wù)
openclaw gateway restart  # 重載配置
openclaw gateway status   # 運行狀態(tài)檢查

# 模型管理
openclaw models list
openclaw models set [模型名]
openclaw models status

# 飛書渠道管理
openclaw channel list
openclaw channel remove feishu # 刪除失效機器人配置

# 日志與診斷
openclaw logs --follow
openclaw doctor --fix

到此這篇關(guān)于2026最新OpenClaw完整入門教程:安裝、免費模型配置與問題排查詳解的文章就介紹到這了,更多相關(guān)OpenClaw入門教學(xué)內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論