背景說明

本教程基于 Docker 部署的 OpenClaw 環(huán)境編寫，所有命令都已適配 Docker 容器化場景：

• OpenClaw 運(yùn)行在 Docker 容器中（容器名：openclaw-gateway）
• 配置目錄：/opt/openclaw/
• 所有 openclaw 命令需通過 docker exec -it openclaw-gateway 執(zhí)行
• 環(huán)境變量通過 .env 文件和 docker-compose.yml 配置

如果你尚未部署 OpenClaw，請先完成基礎(chǔ)部署。

一、飛書開放平臺配置

1.1 創(chuàng)建企業(yè)自建應(yīng)用

1. 訪問 飛書開放平臺，用飛書賬號掃碼登錄
2. 點擊「開發(fā)者后臺」→「創(chuàng)建企業(yè)自建應(yīng)用」
3. 填寫應(yīng)用名稱（如"OpenClaw助手"）、描述，上傳圖標(biāo)
4. 點擊「創(chuàng)建」

1.2 添加機(jī)器人能力

在應(yīng)用管理頁面，點擊「添加應(yīng)用能力」→ 選擇「機(jī)器人」→ 點擊「添加」

1.3 獲取應(yīng)用憑證

在左側(cè)菜單「憑證與基礎(chǔ)信息」中，復(fù)制并保存：

• App ID（格式如 cli_xxx）
• App Secret

妥善保管，后續(xù)會用到

1.4 配置權(quán)限

在「權(quán)限管理」頁面，點擊「批量導(dǎo)入權(quán)限」，粘貼以下 JSON：

{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:chat",
      "im:chat:readonly",
      "im:chat.members:bot_access",
      "im:resource",
      "contact:user.base:readonly"
    ]
  }
}

點擊「確認(rèn)開通」。

1.5 配置事件訂閱

1. 進(jìn)入「事件與回調(diào)」頁面
2. 訂閱方式選擇「長連接接收事件」
3. 點擊「添加事件」，搜索并添加「接收消息 v2.0」（im.message.receive_v1）
4. 點擊「保存」

使用長連接（WebSocket）模式無需公網(wǎng)域名，適合 Docker 部署環(huán)境

二、OpenClaw Docker 配置

2.1 設(shè)置環(huán)境變量

編輯 /opt/openclaw/.env 文件：

cd /opt/openclaw
nano .env

添加以下內(nèi)容：

FEISHU_APP_ID=cli_你的AppID
FEISHU_APP_SECRET=你的AppSecret

2.2 修改 docker-compose.yml

nano /opt/openclaw/docker-compose.yml

在 environment: 部分添加：

environment:
  - NODE_ENV=production
  - LOG_LEVEL=info
  - OPENCLAW_GATEWAY_TOKEN=${OPENCLAW_TOKEN}
  - FEISHU_APP_ID=${FEISHU_APP_ID}
  - FEISHU_APP_SECRET=${FEISHU_APP_SECRET}

2.3 配置飛書渠道

# 進(jìn)入容器
docker exec -it openclaw-gateway sh

# 配置飛書
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.appId ${FEISHU_APP_ID}
openclaw config set channels.feishu.appSecret ${FEISHU_APP_SECRET}
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true

# 退出容器
exit

2.4 重啟容器

cd /opt/openclaw
docker compose down
docker compose up -d

2.5 驗證容器狀態(tài)

docker compose ps
# 應(yīng)顯示 Up 狀態(tài)
docker compose logs --tail=30
# 應(yīng)看到 feishu 相關(guān)日志

三、發(fā)布應(yīng)用

1. 返回飛書開放平臺
2. 點擊「版本管理與發(fā)布」
3. 點擊「創(chuàng)建版本」，填寫版本號和更新說明
4. 點擊「保存」→「確認(rèn)發(fā)布」
5. 等待審核（企業(yè)自建應(yīng)用通常自動通過）

四、配對與測試

4.1 在飛書中找到機(jī)器人

打開飛書客戶端，在搜索欄輸入應(yīng)用名稱，找到你的機(jī)器人。

4.2 發(fā)送消息觸發(fā)配對

向機(jī)器人發(fā)送任意消息（如"你好"），機(jī)器人會回復(fù)一條配對請求，包含配對碼。

4.3 批準(zhǔn)配對

# 查看待配對請求
docker exec -it openclaw-gateway openclaw pairing list

# 批準(zhǔn)配對（替換為實際的配對碼）
docker exec -it openclaw-gateway openclaw pairing approve <配對碼>

4.4 驗證

配對成功后，在飛書中再次向機(jī)器人發(fā)送消息，應(yīng)該能收到 AI 的正?；貜?fù)。

五、Docker 環(huán)境常用命令

六、群聊配置（可選）

如果需要機(jī)器人在群聊中響應(yīng)：

docker exec -it openclaw-gateway sh
openclaw config set channels.feishu.groupPolicy open
openclaw config set channels.feishu.requireMention true
exit
cd /opt/openclaw && docker compose restart

群聊中機(jī)器人會在被 @ 時回復(fù)。

七、常見問題排查（Docker 特定）

八、安全建議

完成以上配置后，你就可以在飛書中直接與 OpenClaw AI 對話了！ 

到此這篇關(guān)于OpenClaw接入飛書機(jī)器人的完整教程(Docker部署版)的文章就介紹到這了,更多相關(guān)OpenClaw接入飛書機(jī)器人內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論