寫在前面

如果你是第一次在 Mac 上折騰企業(yè)微信機(jī)器人，一定要看這一段： 核心邏輯：企業(yè)微信服務(wù)器（在公網(wǎng)）需要把消息推送到你的 Mac（在內(nèi)網(wǎng)）。因?yàn)楣W(wǎng)找不到你的 Mac，所以必須搭建一條內(nèi)網(wǎng)穿透隧道（FRP/Ngrok）。 最大痛點(diǎn)：OpenClaw 出于安全考慮，默認(rèn)只允許本機(jī)訪問。這導(dǎo)致你就算搭好了 FRP 隧道，隧道即使通到了 Mac，也連不進(jìn) OpenClaw。 本文目標(biāo)：手把手教你修改 Mac 監(jiān)聽權(quán)限、打通 FRP 隧道、完成企業(yè)微信對(duì)接。

??? 第一階段：環(huán)境與安裝

1. 前置準(zhǔn)備

• 本地環(huán)境：Mac (Intel 或 Apple Silicon 均可)
• 服務(wù)端環(huán)境：一臺(tái)有公網(wǎng) IP 的云服務(wù)器（用于 FRP 中轉(zhuǎn)，如果沒有，只能用 Ngrok 湊合，但生產(chǎn)環(huán)境建議用 FRP）
• 權(quán)限：企業(yè)微信管理員權(quán)限（需要獲取 Token 和 Key）

2. 安裝 OpenClaw

# 安裝核心程序
npm install -g openclaw
# 安裝企業(yè)微信插件（注意！不要用 @mijia-life 開頭那個(gè)舊版，已廢棄）
openclaw plugins install openclaw-plugin-wecom

?? 第二階段：配置 OpenClaw（三個(gè)必死坑點(diǎn)）

在 Mac 上，建議直接編輯配置文件，比用命令行不容易出錯(cuò)。 文件路徑：~/.openclaw/openclaw.json

? 常見的錯(cuò)誤配置

• 直接把企業(yè)微信后臺(tái)的 EncodingAESKey 粘貼進(jìn)去 -> 錯(cuò)！ 配置文件里由于變量名規(guī)范，首字母要小寫，且 AES 要寫成 Aes。
• 只配置了 channels -> 錯(cuò)！ 必須先在 plugins 里啟用插件。

? 正確的配置模板

請(qǐng)直接復(fù)制下方內(nèi)容覆蓋你的配置（替換掉中文部分）：

{
  "plugins": {
    "entries": {
      "wecom": {
        "enabled": true
      }
    }
  },
  "channels": {
    "wecom": {
      "enabled": true,
      "token": "你的Token（直接從企業(yè)微信后臺(tái)復(fù)制）",
      "encodingAesKey": "你的EncodingAESKey（直接從企業(yè)微信后臺(tái)復(fù)制，注意這里的Key名是小駝峰）"
    }
  }
}

?? 第三階段：解開 Mac 本地監(jiān)聽鎖（Mac專屬巨坑）

這是最容易卡住的地方！ 默認(rèn)情況下，OpenClaw 啟動(dòng)后只監(jiān)聽 127.0.0.1。這意味著 FRP 客戶端（即使在同一臺(tái) Mac 上）如果嘗試通過局域網(wǎng) IP 或 Docker 轉(zhuǎn)發(fā)連接它，會(huì)被拒絕。

1. 修改綁定地址

不要嘗試設(shè)置為 0.0.0.0，OpenClaw 會(huì)報(bào)錯(cuò) Invalid input。正確的關(guān)鍵詞是 lan。

# 告訴 OpenClaw 允許局域網(wǎng)連接
openclaw config set gateway.bind "lan"
# 確保端口固定（默認(rèn) 18789）
openclaw config set gateway.port 18789
# 重啟網(wǎng)關(guān)
openclaw gateway restart

2. 驗(yàn)證是否成功

運(yùn)行 openclaw gateway status。

• 失敗標(biāo)志：顯示 Gateway: bind=loopback 或 Local only。
• 成功標(biāo)志：顯示 Gateway: bind=lan 或 Listening: *:18789。

?? 第四階段：配置 FRP 內(nèi)網(wǎng)穿透

因?yàn)槲覀冊(cè)?Mac 本地，必須把本地的 18789 端口暴露給公網(wǎng)。假設(shè)你有一臺(tái)公網(wǎng)服務(wù)器 122.9.xx.xx。

1. 服務(wù)端配置 (frps.toml) - 在云服務(wù)器上

bindPort = 7000        # FRP通訊端口
vhostHTTPPort = 80     # HTTP轉(zhuǎn)發(fā)端口（可選）
auth.method = "token"
auth.token = "設(shè)置一個(gè)強(qiáng)密碼"

2. 客戶端配置 (frpc.toml) - 在你的 Mac 上

避坑提示：如果云服務(wù)器沒配置 Nginx 反代，不要用 type = http，直接用 tcp 模式最穩(wěn)，不容易出現(xiàn)路徑轉(zhuǎn)發(fā)錯(cuò)誤。

serverAddr = "122.9.xx.xx"
serverPort = 7000
auth.method = "token"
auth.token = "上面的強(qiáng)密碼"
[[proxies]]
name = "mac-bot"
type = "tcp"            # 選TCP，穩(wěn)
localIP = "127.0.0.1"
localPort = 18789       # OpenClaw 的本地端口
remotePort = 10981      # 云服務(wù)器暴露給企業(yè)微信訪問的端口

3. 測(cè)試通道

在 Mac 上啟動(dòng) FRP：

./frpc -c frpc.toml

看到 start proxy success 后，在瀏覽器訪問 http://云服務(wù)器IP:10981/wecom。

• 如果返回 Internal Server Error -> 成功！（說明連通了 OpenClaw，只是缺少參數(shù)）。
• 如果返回 502 或 Connection Refused -> 失敗，檢查防火墻或 Mac 監(jiān)聽設(shè)置。

?? 第五階段：企業(yè)微信后臺(tái)對(duì)接

1. 登錄企業(yè)微信后臺(tái) -> 應(yīng)用管理 -> 自建應(yīng)用。
2. API接收消息 設(shè)置：
   • URL: http://你的云服務(wù)器IP:10981/wecom (注意路徑是 /wecom，不要加 /webhooks)
   • Token: 填入配置文件的 Token。
   • EncodingAESKey: 填入配置文件的 Key。
3. 隨機(jī)生成驗(yàn)證：
   • 如果提示校驗(yàn)失敗，**先改用“明文模式”**保存，排除加密算法帶來的干擾。
   • 一旦保存成功，在企業(yè)微信 App 里給機(jī)器人發(fā)個(gè)“你好”，看是否有回復(fù)。

?? 終極排錯(cuò) Checklist

最后的話： 在 Mac 上做內(nèi)網(wǎng)穿透最容易忽視的就是 MacOS 的應(yīng)用監(jiān)聽權(quán)限。很多人死在 FRP 連不上本地服務(wù)這一步，就是因?yàn)?OpenClaw 默認(rèn)處于“自閉”模式（Bind Localhost）。只有解開這個(gè)鎖，內(nèi)網(wǎng)穿透才有意義。

到此這篇關(guān)于Mac本地部署OpenClaw企業(yè)微信機(jī)器人避坑指南的文章就介紹到這了,更多相關(guān)Mac本地部署OpenClaw企業(yè)微信內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論