一、介紹

OpenClaw 是一款開源、本地優先的自主 AI 代理工具，可通過聊天軟件接收自然語言指令，自主拆解並執行本地 / 雲端任務，實現真正的自動化操作。

由於會修改本地文件，如果你只是想體驗 OpenClaw，建議基於 Docker 環境安裝 OpenClaw。

二、安裝

1、下載代碼

git clone https://github.com/openclaw/openclaw.git

2、安裝

cd openclaw

./docker-setup.sh

3、配置

剛開始會告知你風險，通過左右箭頭按鍵移動綠點，選擇 "Yes"

緊接着選擇配置模式，選擇 QuickStart

4、設置模型供應商

由於 OpenClaw 只是一個本地 Agent，背後需要大模型驅動，因此需要配置模型供應商。

5、設置聊天軟件

可以安裝飛書，或跳過

6、安裝技能

再之後就是安裝需要的技能，可以通過空格鍵選中具體 skill。

我建議可以先選 "Skip for now"，後面再通過 UI 界面安裝。

7、其它設置

之後還有一系列配置，默認可以先跳過（很多用不到）。

配置完成後，鏡像編譯完成，會自動創建一個 Docker 容器

8、訪問OpenClaw並配置Token

http://127.0.0.1:18789/

注意：首次訪問會看到報錯，這次是因為用於鑑權的 Token 還未配置，下面開始設置token

9、修改配置

vim ~/.openclaw/openclaw.json

配置截圖中用紅框標註的部分，在 openclaw.json 文件中默認是沒有的，需要補充上，否則還是會報錯。

不添加可能報錯：disconnected (1008): pairing required

想了解細節，可以參考這個 issue：https://github.com/openclaw/openclaw/issues/6959

{
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "controlUi": { // 一定要添加
      "enabled": true,
      "allowInsecureAuth": true
    },
    "trustedProxies": ["192.168.65.0/24", "172.17.0.0/16"] // 我測試下來可選
  }
}

10、設置token

查找token

cat ~/.openclaw/openclaw.json

複製token內容，打開頁面並配置token，配置後點擊Connect連接

11、設置模型長度

根據自己的模型做調整，最低16000

"contextWindow": 32000

12、聊天

聊天測試

三、和飛書打通

1、打開飛書開放平台

https://open.feishu.cn/app

2、創建應用

3、啓用機器人能力

左側菜單 → 添加應用能力 → 勾選 機器人

3. 開啓 WebSocket 模式（關鍵！）

左側菜單 → 事件與回調 → 事件配置

上方選擇 使用長連接接收事件

4. 添加事件訂閲

在事件配置頁面添加以下事件：im.message.receive_v1 — 接收消息（必選）

5、添加其它所需權限

im:message — 獲取與發送單聊、羣組消息

im:message:send_as_bot — 以機器人身份發送消息

im:chat:readonly — 獲取羣組信息

contact:user.id:readonly — 獲取用户 ID（可選）

contact:contact.base:readonly

6、發佈應用

四、樣例

1、預定會議室

2、保留技能

把能力保留，方便下次快速使用

/app/skills/ — OpenClaw 自帶的技能
/app/extensions/ — 擴展插件的技能（如飛書相關）
/home/node/.openclaw/workspace/skills/ — 你自己創建或安裝的技能

---保留技能

使用保留的技能預定

3、總結羣消息問題

五、異常排查

1、Chat聊天時一直轉圈

問題：需要查看日誌，context window（上下文窗口）：指模型能處理的最大文本長度（token 數），OpenClaw 的嵌入式代理（agent/embedded）有最低要求（16000 tokens），配置中 contextWindow: 4096 遠低於最小值

查看日誌方法：

cd /Users/robots2/gitProject/openclaw

docker compose logs -f openclaw-gateway

報錯：openclaw-gateway-1  | 2026-02-13T05:15:37.474Z [diagnostic] lane task error: lane=main durationMs=36 error="FailoverError: Model context window too small (4096 tokens). Minimum is 16000."

解決方法：在OpenClaw 的網站中，點擊Config下面的Raw編輯模式

contextWindow修改為："contextWindow": 32000

N、參考文檔

1、https://zhuanlan.zhihu.com/p/2002144306304140149

2、https://github.com/openclaw/openclaw/issues/6959