本篇將從普通用戶視角，分享在 deepin 25 上安裝OpenClaw 的步驟及飛書接入方法。

*該方法也適配 Ubuntu、統(tǒng)信UOS 等多數(shù) Linux 系統(tǒng)。

一、升級(jí) Node.js

deepin 25 倉庫的 Node.js 版本為 18.19.1：

$ node -v
v18.19.1

而 OpenClaw 要求 Node.js 的版本為 22+，所以第一步來升級(jí) Node.js。關(guān)于在 deepin 系統(tǒng)上升級(jí) Node.js，可參考教程：

在 deepin 系統(tǒng)中搭建 Node.js 開發(fā)環(huán)境

雖然這篇教程是針對(duì) deepin 23 的，但在 deepin 25 上同樣適用。

首先，安裝 nvm，這是一個(gè)命令行工具，用于管理和切換不同版本的 Node.js 環(huán)境。通過 nvm，你可以輕松地安裝多個(gè)版本的 Node.js，并在它們之間切換，無需手動(dòng)刪除和重新安裝。

curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.4/install.sh | bash

接下來關(guān)閉當(dāng)前終端窗口，打開一個(gè)新的終端窗口。然后安裝 v22 版本 Node.js。

nvm install v22

安裝完成后，確認(rèn)是否已切換到新版本：

$ node -v
v22.22.0
$ npm -v
10.9.4

二、安裝 OpenClaw

根據(jù)官方推薦方式，下載并執(zhí)行腳本：

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

  OpenClaw Installer
 I speak fluent bash, mild sarcasm, and aggressive tab-completion energy.

? Detected: linux
? Node.js v22.22.0 found
? Git already installed
→ Installing OpenClaw 2026.1.29...

安裝完畢，進(jìn)入配置后會(huì)看到安全提示頁：

總結(jié)一下安全風(fēng)險(xiǎn)：

OpenClaw 是測試階段的業(yè)余項(xiàng)目，存在不穩(wěn)定和安全風(fēng)險(xiǎn)；

啟用工具后風(fēng)險(xiǎn)更高：它可以讀文件、執(zhí)行操作，惡意或不當(dāng)提示詞可能誘導(dǎo)其做出不安全行為；

不具備基礎(chǔ)安全能力的人不建議直接使用，尤其是在啟用工具或?qū)ν獗┞肚?，?yīng)請(qǐng)有經(jīng)驗(yàn)的人協(xié)助。

所以不是專業(yè)人員，建議不要直接嘗試。

在了解了安全風(fēng)險(xiǎn)后，選擇 Yes 就可以繼續(xù)往下了。

簡單起見，Onboarding mode 選擇 QuickStart。然后就是選擇大模型提供商，國內(nèi)的大模型可以選擇 MinMax、Qwen（千問）、Moonshot AI（月之暗面）、Z.AI (GLM 4.7)（智譜）等。

本次選擇 Z.AI (GLM 4.7)，然后輸入 API Key。

至此，大模型配置部分就結(jié)束了，接下來就是配置 Channel：

這里沒有列出我們所要接入的飛書，所以選擇最后一個(gè)選項(xiàng)，先暫時(shí)跳過這一步。

接著是配置 Skills。OpenClaw 的 Skills = AI 的“動(dòng)手能力模塊”。沒有 Skills，它只能聊天；而有了 Skills，它就可以執(zhí)行命令、讀寫文件、調(diào)用 API。

Skill 功能如下：

系統(tǒng)操作：執(zhí)行命令、重啟服務(wù)

文件操作：讀 / 寫文件

網(wǎng)絡(luò)請(qǐng)求：HTTP / API

自動(dòng)化：瀏覽器操作、腳本執(zhí)行

運(yùn)維集成：部署、監(jiān)控、日志 ...

這里當(dāng)然選擇 Yes，否則它與一般的 AI 聊天工具就沒有兩樣了。

接著往下走，提示安裝 Homebrew，按照提示的命令，另外開一個(gè)終端，執(zhí)行如下命令：

/bin/bash -c"$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安裝后有如下提示：

Warning: /home/linuxbrew/.linuxbrew/bin is notinyour PATH.
 Instructions on how to configure your shellforHomebrew
 can be foundinthe'Next steps'section below.

這是由于 Homebrew 安裝到了 /home/linuxbrew/.linuxbrew/ 下，需要按照提示做一些配置：

 echo>> /home/uos/.bashrc
 echo'eval "$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"'>> /home/uos/.bashrc
 eval"$(/home/linuxbrew/.linuxbrew/bin/brew shellenv bash)"

安裝完畢 Homebrew 后，再回到 OpenClaw，繼續(xù)配置。接著選擇 npm 作為 node 包管理器。

最后選擇 Skills 依賴：

這里未做選擇，全部安裝。這里有個(gè)小技巧，按空格鍵選中。

由于上一步安裝 Homebrew 是新開終端安裝的，其環(huán)境變量在這里還沒生效，所以會(huì)提示：

Install failed: 1password — brew not installed
Tip: run `openclaw doctor` to review skills + requirements.
Docs: https://docs.openclaw.ai/skills

可暫時(shí)忽略。接下來會(huì)提示配置 GOOGLE_PLACES_API_KEY、GEMINI_API_KEY 等，先跳過。

隨后詢問是否啟用 Hooks。這里 Hook 的概念應(yīng)該類似 Git hook，就是在執(zhí)行某些指令時(shí)，自動(dòng)執(zhí)行后臺(tái)動(dòng)作。

boot-md：啟動(dòng)時(shí)先讀一段規(guī)則

command-logger：記錄你對(duì) Agent 的指令

session-memory： 保存當(dāng)前會(huì)話到長期記憶

不管三七二十一，都選上吧。后續(xù)可以通過如下命令管理 hooks：

openclaw hooks list                  
openclaw hooksenable              
openclaw hooksdisable

接下來會(huì)自動(dòng)安裝系統(tǒng)服務(wù)：lingering 和 Gateway。

再往后是長篇幅的提示：

按回車，又是不少提示：

至此，總算把 OpenClaw 配置完畢。在這個(gè)界面就可以和 AI 進(jìn)行對(duì)話。但我們的目標(biāo)是接入飛書，所以按兩次 Ctrl + C，先退出這個(gè)界面。

三、配置飛書

安裝飛書插件

直接輸入如下命令安裝飛書插件：

$ openclaw plugins install @m1heng-clawd/feishu

 OpenClaw 2026.1.29 (a5b4d22) — Meta wishes they shipped this fast.

Downloading @m1heng-clawd/feishu…
Extracting /tmp/openclaw-npm-pack-T0pzzA/m1heng-clawd-feishu-0.1.4.tgz…
Installing to /home/uos/.openclaw/extensions/feishu…
Installing plugin dependencies…
Installed plugin: feishu
Restart the gateway to load plugins.

等待系統(tǒng)自動(dòng)拉取安裝依賴，當(dāng)看到飛書插件安裝成功的提示，即表示第一步安裝完成。根據(jù)提示，重啟 openclaw gateway：

openclaw gateway restart

配置飛書插件

在瀏覽器中輸入 https://open.feishu.cn/app 進(jìn)入飛書的開發(fā)者后臺(tái)。創(chuàng)建一個(gè)應(yīng)用，比如我給應(yīng)用取名 “openclaw機(jī)器人”。創(chuàng)建完成后，進(jìn)入應(yīng)用的憑證與基礎(chǔ)信息頁，記下應(yīng)用的 appid 和 app secret。

接下來給飛書插件配置 appid 和 app secret。這里我們使用“openclaw 機(jī)器人”這個(gè)應(yīng)用進(jìn)行配置。

按照前面的 OpenClaw 的安裝最后步驟的 Web UI 地址，打開瀏覽器，打開 Web UI。

進(jìn)入 Chat 界面，發(fā)出配置指令：

后面還有很多回復(fù)，配置成功了沒有呢？AI 認(rèn)為配置成功了，但實(shí)際并非如此，還是手動(dòng)配置吧：

# 設(shè)置飛書應(yīng)用的 App ID
openclaw configsetchannels.feishu.appId"cli_xxxx"
# 設(shè)置飛書應(yīng)用的 App Secret
openclaw configsetchannels.feishu.appSecret"your_app_secret"
# 啟用飛書通道
openclaw configsetchannels.feishu.enabledtrue
# 重啟 openclaw gateway
openclaw gateway restart

然后通過以下命令驗(yàn)證配置狀態(tài)：

openclaw status

如果飛書通道顯示為ON和OK狀態(tài)，說明配置已成功加載。

配置飛書應(yīng)用

接著進(jìn)入飛書的開發(fā)者后臺(tái)，完成以下關(guān)鍵配置，讓插件正常收發(fā)消息 ：

添加應(yīng)用能力：在應(yīng)用詳情頁的應(yīng)用能力部分，必須為應(yīng)用添加“機(jī)器人”能力。

開通API權(quán)限：在權(quán)限管理頁面，搜索并開通以下核心權(quán)限 ：

contactreadonly(獲取用戶信息)

im:message(收發(fā)消息)

imreadonly(接收單聊消息)

imreadonly(接收群聊@消息)

imsend_as_bot(以機(jī)器人身份發(fā)送消息)

事件訂閱：在事件與回調(diào)頁面 ：

訂閱方式：選擇“長連接（WebSocket）”。

添加事件：至少需添加im.message.receive_v1（接收消息事件）等。

添加回調(diào)：至少添加card.action.trigger(卡片回傳交互) 和profile.view.get(查看自定義名片頁卡片)。

發(fā)布應(yīng)用：最后，在版本管理與發(fā)布中創(chuàng)建版本并發(fā)布應(yīng)用。發(fā)布后，才能在飛書客戶端中搜索到你的機(jī)器人并進(jìn)行測試 。

和 OpenClaw 機(jī)器人對(duì)話

打開飛書 App，找到我創(chuàng)建的openclaw機(jī)器人應(yīng)用，在對(duì)話框中輸入問題，比如：“武漢天氣怎么樣？” 機(jī)器人就會(huì)給予回復(fù)。

到此，可以確認(rèn) OpenClaw 配置成功，也成功接入到了飛書。

寫在最后：

看到這里，你可能有疑問，就這？這不是現(xiàn)在所有 AI 都能做到的事情嗎？

當(dāng)然OpenClaw肯定不止一個(gè)簡單的問答機(jī)器人，否則也不會(huì)引起那么多人的關(guān)注。只是本篇文章的主旨是介紹OpenClaw的安裝配置以及飛書接入。更多更高級(jí)的玩法，需要一些配置，這其中還涉及讓渡一些權(quán)限給 AI，比如文件讀寫，不得不謹(jǐn)慎一些。

如果你有更多關(guān)于 deepin 和 AI 的問題，也歡迎來到deepin社區(qū)論壇，與我們一同討論！