在完成飛書渠道的基礎(chǔ)接入之后，很多用戶希望進(jìn)一步在飛書對話中調(diào)用 Codex、Claude Code、Gemini CLI 等外部編程工具。OpenClaw 的 ACP（Agent Client Protocol）正是為此而生。本文將結(jié)合飛書渠道的具體配置，完整講解如何在飛書環(huán)境中啟動并使用 ACP 功能。

一、理解 ACP 與飛書渠道的關(guān)系

很多人第一次接觸 ACP 時會有一個疑問：飛書插件文檔里為什么沒有專門的 ACP 章節(jié)？答案是：ACP 是 OpenClaw 的通用運(yùn)行時功能，與具體渠道插件完全解耦。

飛書渠道（無論是官方插件還是內(nèi)置插件）只負(fù)責(zé)消息的收發(fā)和路由，ACP 功能在頂層 acp 配置塊中獨立啟用。只要飛書渠道正常連接，你就可以在飛書對話中通過 /acp 命令驅(qū)動 Codex、Claude、Gemini 等外部 Harness，就像在 Discord 或 Telegram 中一樣。

這種設(shè)計意味著：你不需要為飛書做任何 ACP 專屬配置，只需確保飛書渠道已正常接入，再啟用全局 ACP 即可。

二、前置條件：確保飛書渠道已正常接入

在啟用 ACP 之前，飛書渠道必須處于正常工作狀態(tài)。以下是快速驗證方法：

# 查看網(wǎng)關(guān)狀態(tài)
openclaw gateway status
# 實時查看日志，確認(rèn)飛書連接正常
openclaw logs --follow

日志中出現(xiàn) feishu ws connected 或 feishu provider ready 即表示飛書渠道連接成功。

如果飛書還未接入，需要先完成以下步驟：

第一步：創(chuàng)建飛書自建應(yīng)用并開啟機(jī)器人能力，在飛書開放平臺創(chuàng)建企業(yè)自建應(yīng)用，進(jìn)入「應(yīng)用能力 > 機(jī)器人」開啟機(jī)器人功能。

第二步：配置權(quán)限，在權(quán)限管理中批量導(dǎo)入以下 JSON（涵蓋消息、文檔、文件等所有必要權(quán)限）：

{
  "scopes": {
    "tenant": [
      "im:chat",
      "im:message",
      "im:message.p2p_msg:readonly",
      "im:message.group_msg",
      "im:message:send_as_bot",
      "im:message:readonly",
      "im:resource",
      "docs:document.content:read",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": [
      "aily:file:read",
      "aily:file:write",
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}

第三步：配置事件訂閱，在「事件與回調(diào) > 事件配置」中選擇「使用長連接接收事件」（國內(nèi)版飛書無需公網(wǎng)服務(wù)器），添加 im.message.receive_v1 事件。

第四步：在 OpenClaw 中添加飛書渠道：

# OpenClaw ≥ 2026.2 已內(nèi)置飛書插件，無需額外安裝
openclaw channels add
# 選擇 Feishu → 粘貼 App ID → 粘貼 App Secret
openclaw gateway restart

三、啟用 ACP 功能

飛書渠道就緒后，在 ~/.openclaw/openclaw.json 中加入 ACP 全局配置：

{
  "acp": {
    "enabled": true,
    "dispatch": { "enabled": true },
    "backend": "acpx",
    "defaultAgent": "codex",
    "allowedAgents": ["pi", "claude", "codex", "opencode", "gemini", "kimi"],
    "maxConcurrentSessions": 8,
    "stream": {
      "coalesceIdleMs": 300,
      "maxChunkChars": 1200
    },
    "runtime": {
      "ttlMinutes": 120
    }
  },
  "channels": {
    "feishu": {
      "enabled": true,
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxx",
          "appSecret": "你的AppSecret"
        }
      }
    }
  }
}

然后安裝 acpx 后端插件并重啟網(wǎng)關(guān)：

# 安裝 acpx 后端插件
openclaw plugins install acpx
openclaw config set plugins.entries.acpx.enabled true
# 重啟網(wǎng)關(guān)使配置生效
openclaw gateway restart
# 驗證后端健康狀態(tài)
/acp doctor

四、權(quán)限配置（重要，不配必踩坑）

ACP 會話運(yùn)行在非交互模式下，沒有 TTY 來響應(yīng)文件寫入或 shell 執(zhí)行的權(quán)限提示。默認(rèn)配置下，任何寫入或執(zhí)行操作都會因無法響應(yīng)權(quán)限提示而直接報錯崩潰（AcpRuntimeError: Permission prompt unavailable in non-interactive mode）。

acpx 插件提供兩個關(guān)鍵配置項來解決這個問題：

permissionMode 控制操作權(quán)限范圍：

nonInteractivePermissions 控制無 TTY 時的處理方式：

推薦根據(jù)實際場景選擇配置：

# 方案一：完全開放權(quán)限（適合受信任的個人開發(fā)環(huán)境）
openclaw config set plugins.entries.acpx.config.permissionMode approve-all
# 方案二：保守策略，寫入被靜默拒絕而不崩潰（適合對權(quán)限有顧慮的場景）
openclaw config set plugins.entries.acpx.config.permissionMode approve-reads
openclaw config set plugins.entries.acpx.config.nonInteractivePermissions deny
# 修改后必須重啟網(wǎng)關(guān)
openclaw gateway restart

五、在飛書中啟動 ACP 會話

配置完成后，打開飛書，找到你的機(jī)器人，直接發(fā)送 /acp 命令即可開始使用。

5.1 基礎(chǔ)啟動流程

# 啟動一個持久化 Codex 會話，綁定到當(dāng)前對話
/acp spawn codex --mode persistent --thread auto
# 查看當(dāng)前會話狀態(tài)
/acp status
# 按需調(diào)整運(yùn)行時參數(shù)
/acp model anthropic/claude-opus-4-5
/acp permissions approve-all
/acp timeout 300
# 向運(yùn)行中的會話發(fā)送引導(dǎo)指令（不替換上下文）
/acp steer 重點關(guān)注性能優(yōu)化，繼續(xù)
# 停止當(dāng)前輪次（保留會話）
/acp cancel
# 關(guān)閉會話并解除綁定
/acp close

你也可以直接用自然語言，OpenClaw 會自動解析意圖并路由到 ACP 運(yùn)行時：

• “用 Codex 幫我看一下這個倉庫里的失敗測試”
• “用 Claude Code 做一次性代碼審查并總結(jié)結(jié)果”
• “用 Gemini CLI 處理這個任務(wù)”

5.2 一次性任務(wù) vs 持久化會話

--mode 參數(shù)決定會話的生命周期：

• oneshot（一次性）：執(zhí)行完任務(wù)后自動結(jié)束，適合單次代碼生成、文件分析等場景。
• persistent（持久化）：會話保持活躍，后續(xù)消息繼續(xù)路由到同一會話，適合需要多輪交互的編碼任務(wù)。

--thread 參數(shù)決定線程綁定方式：

5.3 恢復(fù)歷史會話

如果之前的 ACP 會話因網(wǎng)關(guān)重啟或超時中斷，可以通過 resumeSessionId 續(xù)接，完整保留上下文：

# 先查看近期會話列表
/acp sessions
# 續(xù)接指定會話
# 在飛書中告訴機(jī)器人：
# "用 sessions_spawn 工具續(xù)接我之前的 Codex 會話，resumeSessionId 是 <session-id>"

六、完整命令速查

七、沙箱兼容性注意事項

ACP 會話目前運(yùn)行在宿主機(jī)運(yùn)行時，不在 OpenClaw 沙箱內(nèi)部。這帶來一個重要約束：

如果你的飛書渠道對應(yīng)的 Agent 配置了沙箱模式（sandbox.mode: "all"），則該 Agent 會話將無法啟動 ACP，報錯信息為：

Sandboxed sessions cannot spawn ACP sessions because runtime="acp" runs on the host.
Use runtime="subagent" from sandboxed sessions.

解決方案：為需要使用 ACP 的 Agent 關(guān)閉沙箱，或從非沙箱會話中發(fā)起 ACP。如果需要沙箱隔離執(zhí)行，請改用 runtime: "subagent"。

八、Lark（國際版）用戶的特殊說明

Lark 國際版不支持 WebSocket 長連接，需要改用 Webhook 模式，配置上有所不同：

{
  "channels": {
    "feishu": {
      "domain": "lark",
      "connectionMode": "webhook",
      "webhookPort": 3000,
      "webhookPath": "/feishu/events",
      "accounts": {
        "main": {
          "appId": "cli_xxxxxxxxx",
          "appSecret": "你的AppSecret"
        }
      }
    }
  }
}

Webhook 模式需要將本地端口暴露到公網(wǎng)，推薦使用 Cloudflare Tunnel（免費(fèi)且與 Clash、V2Ray 等代理工具完全兼容）：

# 安裝 cloudflared（macOS）
brew install cloudflared
# 暴露本地 3000 端口
cloudflared tunnel --url http://localhost:3000

將生成的公網(wǎng) URL（如 https://xxx-yyy.trycloudflare.com/feishu/events）填入 Lark 開發(fā)者后臺的 Request URL 即可。ACP 功能的配置與使用方式與飛書國內(nèi)版完全相同，無需額外適配。

九、常見問題排查

十、總結(jié)

OpenClaw 在飛書渠道中啟用 ACP 功能的核心邏輯很簡單：飛書渠道負(fù)責(zé)消息路由，ACP 負(fù)責(zé)外部 Harness 調(diào)度，兩者獨立配置、協(xié)同工作。只需確保飛書渠道正常接入，在頂層啟用 ACP 并安裝 acpx 插件，就可以在飛書對話中用自然語言或 /acp 命令驅(qū)動 Codex、Claude Code、Gemini CLI 等專業(yè)編程工具，實現(xiàn)真正的聊天驅(qū)動代碼工作流。

對于國內(nèi)用戶來說，飛書的 WebSocket 長連接模式無需公網(wǎng)服務(wù)器，配置門檻極低，是將 ACP 能力落地到日常工作流中最便捷的渠道之一。

到此這篇關(guān)于OpenClaw飛書渠道ACP功能啟動的實現(xiàn)步驟的文章就介紹到這了,更多相關(guān)OpenClaw飛書ACP啟動內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論