OpenClaw（原名 CloudBot）是一款極其強(qiáng)大的開源本地 AI 助理。由于它需要頻繁執(zhí)行截屏、讀取本地文件、控制瀏覽器等重度依賴系統(tǒng)環(huán)境的操作，這里強(qiáng)烈建議大家直接在 Mac Mini 或 Linux 宿主機(jī)上進(jìn)行“裸機(jī)部署”，而不是套上 Docker 的枷鎖，這樣能最大程度釋放它的系統(tǒng)控制潛能。

本教程不講廢話，直接帶你啃下三大核心進(jìn)階模塊：無縫接入自定義聚合 API、使用 PM2 實(shí)現(xiàn) 7x24 小時(shí)后臺常駐，以及接入飛書打造全天候隨身助理。跟著步驟走，你的桌面將進(jìn)化為一個(gè)極其聰明的自動化工作站。

一、 核心配置：無縫接入自定義聚合 API 節(jié)點(diǎn)

默認(rèn)向?qū)ǔB接官方的 OpenAI 接口。但在實(shí)際開發(fā)中，為了兼顧網(wǎng)絡(luò)穩(wěn)定性和成本，我們往往需要將流量安全、無縫地代理到自己的 API 聚合平臺上。推薦使用 .env 文件配合啟動腳本的方式，不僅優(yōu)雅，而且日后維護(hù)或切換備用節(jié)點(diǎn)極其方便。

1. 編寫.env配置文件

在你的 OpenClaw 運(yùn)行目錄（例如 ~/openclaw-bot）下，新建一個(gè) .env 文件：

# 填入你聚合平臺的 API Key
OPENAI_API_KEY=sk-你的聚合平臺密鑰
# 填入反向代理節(jié)點(diǎn)地址，請確保以 /v1 結(jié)尾。
# 若主節(jié)點(diǎn)波動，可隨時(shí)切換為備用節(jié)點(diǎn)（例如 https://sg.uiuiapi.com/v1）
OPENAI_BASE_URL=https://api1.uiuiapi.com/v1
# 指定默認(rèn)調(diào)用的主力模型
OPENAI_MODEL=gpt-4o

2. 編寫服務(wù)啟動腳本

為了讓配置在啟動時(shí)自動生效，我們在同級目錄下新建一個(gè)啟動腳本 start_cloudbot.sh：

#!/bin/bash
echo "正在加載環(huán)境變量..."
if [ -f .env ]; then
  # 讀取 .env 文件并導(dǎo)出為環(huán)境變量
  export $(grep -v '^#' .env | xargs)
  echo "配置加載成功，當(dāng)前請求節(jié)點(diǎn)為: $OPENAI_BASE_URL"
else
  echo "警告：未找到 .env 文件，請檢查路徑！"
fi
echo "正在啟動 OpenClaw..."
cloudbot gateway

別忘了賦予腳本可執(zhí)行權(quán)限：

chmod +x start_cloudbot.sh

3. 進(jìn)階避坑：Nginx 反向代理“防斷流”極致優(yōu)化

這里分享一個(gè)極易踩坑的細(xì)節(jié)：在調(diào)用大模型（如 Claude-3-Opus 或 GPT-4o）進(jìn)行長文本生成或?qū)懘a時(shí)，通常需要耗費(fèi)幾十秒甚至幾分鐘。

如果你的聚合 API 是通過 Nginx 反向代理出去的，使用默認(rèn)的 Nginx 配置會極易因?yàn)槌瑫r(shí)（Timeout）或緩沖（Buffering）問題斷開長連接。結(jié)果就是：OpenClaw 端接收到不完整的回復(fù)，或者直接原地報(bào)錯(cuò) 504 Gateway Timeout。

為了完美支持流式輸出（SSE / Streaming）并徹底解決斷流問題，請將以下優(yōu)化配置整合到你的 Nginx server 塊中：

server {
    listen 443 ssl http2;
    server_name api1.uiuiapi.com sg.uiuiapi.com; # 你的聚合 API 域名
    # ... 這里是你的 SSL 證書配置 ...
    location / {
        proxy_pass http://127.0.0.1:3000; # 假設(shè)你的后端服務(wù)跑在本地 3000 端口
        # ==========================================
        # 核心一：關(guān)閉代理緩沖，確保流式輸出 (SSE) 呈現(xiàn)順滑的打字機(jī)效果
        # ==========================================
        proxy_buffering off;
        proxy_cache off;
        # ==========================================
        # 核心二：大幅延長超時(shí)時(shí)間，防止長文本生成時(shí) 504 超時(shí)
        # ==========================================
        proxy_connect_timeout 300s; 
        proxy_send_timeout 300s;    
        proxy_read_timeout 300s;    # 最關(guān)鍵項(xiàng)：給足 AI 思考和生成的時(shí)間
        # ==========================================
        # 核心三：HTTP/1.1 與長連接支持 (WebSocket / SSE 必備)
        # ==========================================
        proxy_http_version 1.1;
        proxy_set_header Connection "keep-alive";
        proxy_set_header Keep-Alive "timeout=300"; # 保持連接不被網(wǎng)關(guān)主動掐斷
        # ==========================================
        # 核心四：透傳真實(shí)請求頭，防止 Invalid URL Prefix 等路由錯(cuò)誤
        # ==========================================
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
        proxy_set_header X-Forwarded-Proto $scheme;
    }
}

原理解析：

• proxy_buffering off;：AI 模型的流式輸出是一段一段發(fā)給瀏覽器的。如果 Nginx 開啟了緩沖，它會“自作主張”地等后端攢夠一定大小的字?jǐn)?shù)才發(fā)給 OpenClaw，這不僅破壞了實(shí)時(shí)打字的體驗(yàn)，嚴(yán)重時(shí)還會導(dǎo)致連接卡死。關(guān)閉它，消息就能毫無阻力地透傳。
• **超時(shí)設(shè)為 300s**：將讀取超時(shí)時(shí)間從默認(rèn)的 60 秒延長到 5 分鐘，足以覆蓋絕大多數(shù)生成上千行代碼的極端場景。

生效配置： 修改后先執(zhí)行 nginx -t 測試語法，無誤后再執(zhí)行 nginx -s reload 平滑重載。這套網(wǎng)絡(luò)層組合拳打完，你的 API 響應(yīng)在穩(wěn)定性和速度上就基本無懈可擊了。

二、 進(jìn)階保活：使用 PM2 實(shí)現(xiàn) 7x24 小時(shí)常駐后臺

配置好網(wǎng)絡(luò)后，為了防止意外關(guān)閉終端窗口導(dǎo)致 AI 助理“失聯(lián)”，我們需要引入 Node.js 生態(tài)中最老牌、最穩(wěn)妥的進(jìn)程管理器 PM2。

1. 全局安裝 PM2

打開終端，執(zhí)行以下命令：

npm install -g pm2

2. 啟動并托管服務(wù)

在剛才的腳本目錄下，使用 PM2 拉起服務(wù)，并給它起個(gè)好記的名字：

pm2 start ./start_cloudbot.sh --name "openclaw"

此時(shí)服務(wù)已進(jìn)入后臺靜默運(yùn)行。你可以隨時(shí)敲入 pm2 logs openclaw 查看實(shí)時(shí)運(yùn)行日志。

3. 配置開機(jī)自啟

為了應(yīng)對宿主機(jī)意外斷電或重啟，我們需要將其注入開機(jī)自啟項(xiàng)：

# 生成自啟腳本（執(zhí)行后，需將終端輸出的那段帶有 sudo 的命令復(fù)制并再執(zhí)行一次）
pm2 startup
# 保存當(dāng)前的 PM2 運(yùn)行列表
pm2 save

三、 多端協(xié)同：接入飛書打造隨身企業(yè)助理

這是整個(gè)工作流中最驚艷的一步。將 OpenClaw 接入飛書后，你就可以在通勤路上用手機(jī)隨時(shí)下發(fā)任務(wù)，讓家里的電腦幫你跑代碼、查資料，并直接把結(jié)果回傳到你的飛書聊天框里。

1. 飛書開放平臺配置

1. 登錄 [飛書開放平臺]https://open.feishu.cn，點(diǎn)擊 創(chuàng)建企業(yè)應(yīng)用。
2. 在左側(cè)菜單 添加應(yīng)用能力 中，按需添加 機(jī)器人。
3. 進(jìn)入 憑證與基礎(chǔ)信息，妥善保存你的 App ID 和 App Secret。
4. 進(jìn)入 權(quán)限管理，申請開通必需的權(quán)限（如“接收消息”、“發(fā)送消息”、“獲取群組信息”等）。
5. 進(jìn)入 版本管理與發(fā)布，創(chuàng)建并發(fā)布一個(gè)初始版本。

2. OpenClaw 本地對接配置

回到你的終端（PM2 進(jìn)程在后臺跑著不用管），依次執(zhí)行：

# 1. 安裝飛書官方插件
cloudbot plugin install @openclaw/feishu
# 2. 填入你的憑證信息
cloudbot config set feishu.appId "你的飛書App_ID"
cloudbot config set feishu.appSecret "你的飛書App_Secret"
# 3. 開啟 WebSocket 模式（國內(nèi)免內(nèi)網(wǎng)穿透的神級方案）
cloudbot config set feishu.connectionType "websocket"

3. 飛書事件訂閱 (長連接配置)

1. 再次回到飛書開放平臺，進(jìn)入左側(cè)的 事件與回調(diào)。
2. 將 事件訂閱方式 切換為 長連接（WebSocket）。
3. 點(diǎn)擊 添加事件，搜索并勾選 接收消息 (im.message.receive_v1)。
4. 關(guān)鍵一步：再次前往“版本管理與發(fā)布”發(fā)布一個(gè)新版本，否則剛才的訂閱配置不會生效。

4. 重啟與終極聯(lián)調(diào)

在終端執(zhí)行 pm2 restart openclaw 重啟服務(wù)。
打開手機(jī)上的飛書 APP，搜索你剛剛創(chuàng)建的機(jī)器人，對它發(fā)一句“你好”或者“幫我截個(gè)屏”。

(注：首次發(fā)送重度指令如“截屏”時(shí)，MacOS 可能會攔截，你需要回到 Mac 終端輸入 cloudbot tui 并在交互界面中手動授予屏幕錄制權(quán)限。)

只要機(jī)器人給予了正確回復(fù)，恭喜你，一整套從底層 API、網(wǎng)絡(luò)反代、進(jìn)程?；畹蕉喽藚f(xié)同的私人 AI 助理全鏈路，已經(jīng)徹底打通！

到此這篇關(guān)于OpenClaw 國內(nèi)完美運(yùn)行指南:自定義API 代理與飛書協(xié)同部署(CloudBot)的文章就介紹到這了,更多相關(guān)OpenClaw自定義API 代理與飛書部署內(nèi)容請搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評論