1. 前言

本指南基于 Ubuntu 24.04 虛擬機(jī)（2GB 內(nèi)存）環(huán)境，記錄了從零安裝 OpenClaw、配置 GLM-4.7-Flash 免費(fèi)大模型 API，并最終集成釘釘機(jī)器人的全過程。由于硬件資源有限，全程采用云端 API 而非本地模型推理。

2. 環(huán)境要求

• 操作系統(tǒng)：Ubuntu 24.04（或其他 Linux 發(fā)行版）
• 內(nèi)存：建議 2GB 以上（OpenClaw 本身占用約 400MB）
• Node.js：v18 或更高（OpenClaw 基于 Node.js）

3. 安裝 OpenClaw

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

4. 配置GLM-4.7-Flash官方免費(fèi)API

第一步：獲取API密鑰

• 訪問智譜AI的開放平臺(tái) BigModel.cn。
• 注冊(cè)/登錄后，在控制臺(tái)中找到“API密鑰”或類似選項(xiàng)，創(chuàng)建一個(gè)新的API密鑰（通常以 sk- 開頭）并保存好。

第二步：修改OpenClaw配置文件

需要編輯OpenClaw的配置文件（通常位于 ~/.openclaw/openclaw.json），添加 glm-4.7-flash 作為模型提供商?？梢栽谂渲梦募?nbsp;models.providers 部分添加一個(gè)名為 "glm" 的節(jié)點(diǎn)。配置結(jié)構(gòu)如下：

"models": {
    "providers": {
      "glm": {
        "baseUrl": "https://open.bigmodel.cn/api/paas/v4",
        "apiKey": "你的apiKey",
        "api": "openai-completions",
        "models": [
          {
            "id": "glm-4.7-flash",
            "name": "GLM-4.7 Flash",
            "contextWindow": 128000,
            "maxTokens": 4096,
            "reasoning": false,
            "input": [
              "text"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            }
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "glm/glm-4.7-flash"
      },
      "maxConcurrent": 4,
      "subagents": {
        "maxConcurrent": 8
      }
    }
  },

第三步：重啟OpenClaw

保存配置文件后，重啟OpenClaw服務(wù)，OpenClaw就應(yīng)該連接到智譜的免費(fèi)GLM-4.7-Flash模型了。

# 重啟openclaw
openclaw gateway restart

第四步：驗(yàn)證模型可用性

使用 TUI（終端界面）進(jìn)行對(duì)話，這是最直接、最適合測(cè)試模型是否配置成功的交互方式。

openclaw tui

這個(gè)命令會(huì)啟動(dòng)一個(gè)終端用戶界面 (TUI)，你可以在這個(gè)界面里直接和你的 AI 代理（即你配置好的 GLM-4.7-Flash 模型）進(jìn)行對(duì)話 。

如何操作：

• 輸入你的問題，按回車發(fā)送。
• 查看模型的回復(fù)，確認(rèn)是否正常工作。

5. 配置釘釘機(jī)器人

5.1 創(chuàng)建釘釘企業(yè)內(nèi)部應(yīng)用

登錄 釘釘開發(fā)者后臺(tái)。

點(diǎn)擊“創(chuàng)建應(yīng)用”，選擇“企業(yè)內(nèi)部應(yīng)用”，填寫應(yīng)用名稱（如“我的OpenClaw助手”）。

在應(yīng)用詳情頁，添加“機(jī)器人”能力。

關(guān)鍵步驟：在機(jī)器人配置中，消息接收模式務(wù)必選擇 Stream 模式（無需公網(wǎng) IP）。

記錄以下信息：

• Client ID（即 AppKey）
• Client Secret（即 AppSecret）

在“權(quán)限管理”中，搜索并添加權(quán)限：

• Card.Instance.Write（卡片實(shí)例寫權(quán)限）
• Card.Streaming.Write（卡片流式寫權(quán)限）
• im:message（消息相關(guān)權(quán)限，根據(jù)需要）

在“版本管理與發(fā)布”中創(chuàng)建新版本并發(fā)布。

5.2 安裝釘釘頻道插件

OpenClaw 默認(rèn)沒有內(nèi)置釘釘插件，需要手動(dòng)安裝社區(qū)版本：

openclaw plugins install https://github.com/soimy/clawdbot-channel-dingtalk.git
# 或者
openclaw plugins install clawdbot-dingtalk

安裝過程中可能出現(xiàn)安全警告（環(huán)境變量訪問+網(wǎng)絡(luò)發(fā)送），請(qǐng)自行評(píng)估風(fēng)險(xiǎn)。

安裝后重啟網(wǎng)關(guān)：

openclaw gateway restart

驗(yàn)證插件是否加載：

openclaw plugins list | grep dingtalk
# 應(yīng)顯示 loaded 狀態(tài)

5.3 配置釘釘頻道

編輯配置文件 ~/.openclaw/openclaw.json，在 channels 下添加釘釘配置（最簡(jiǎn)配置）：

"channels": {
  "dingtalk": {
    "enabled": true,
    "clientId": "你的釘釘Client ID",
    "clientSecret": "你的釘釘Client Secret",
    "robotCode": "你的釘釘Client ID"   // 通常與 clientId 相同
  }
}
# 如果上面使用的是 clawdbot-dingtalk，配置如下：
"channels": {
    "clawdbot-dingtalk": {
      "enabled": true,
      "clientId": "your-dingtalk-client-id",
      "clientSecret": "your-dingtalk-client-secret"
    }
  }

如果后續(xù)需要更多策略，可補(bǔ)充：

• corpId：企業(yè)ID（可選）
• agentId：應(yīng)用ID（可選）
• dmPolicy：?jiǎn)瘟牟呗?，?nbsp;"open"（可選）
• groupPolicy：群聊策略，如 "open"（可選）

保存后重啟網(wǎng)關(guān)：

openclaw gateway restart

5.4 在釘釘中與機(jī)器人聊天

由于釘釘機(jī)器人不是“好友”，無法通過搜索直接添加為聯(lián)系人。有以下兩種方式與機(jī)器人對(duì)話：

方式一：在群聊中使用

將機(jī)器人添加到任意一個(gè)群：

• 進(jìn)入群聊 → 點(diǎn)擊右上角“...” → “機(jī)器人” → “添加機(jī)器人” → 選擇你的機(jī)器人。

在群里 @機(jī)器人 并發(fā)送消息，機(jī)器人會(huì)回復(fù)。

方式二：?jiǎn)瘟模ㄋ搅模?/h4>

• 通過群聊成員列表點(diǎn)擊機(jī)器人頭像，進(jìn)入資料頁，點(diǎn)擊“發(fā)消息”開始私聊。
• 或者從通訊錄 → 我的企業(yè) → 企業(yè)應(yīng)用中找到機(jī)器人，點(diǎn)擊“發(fā)起會(huì)話”。

首次對(duì)話后，該會(huì)話會(huì)出現(xiàn)在聊天列表，后續(xù)可直接進(jìn)入。

6. 常見問題與故障排除

6.1 配置文件語法錯(cuò)誤

若重啟時(shí)報(bào) JSON 解析錯(cuò)誤，可使用以下命令檢查語法：

python3 -m json.tool ~/.openclaw/openclaw.json

注意：OpenClaw 支持 JSON5（允許注釋），但 json.tool 只支持嚴(yán)格 JSON，可忽略注釋相關(guān)報(bào)錯(cuò)。

6.2 插件未找到

• 確保插件安裝成功：openclaw plugins list

• 如果插件狀態(tài)為 disabled，需在配置中啟用對(duì)應(yīng)頻道（enabled: true）。

  cd ~/.openclaw/extensions/dingtalk
  npm install

6.3 釘釘機(jī)器人無響應(yīng)

1. 檢查 OpenClaw 日志：

   journalctl --user -u openclaw-gateway.service -f

2. 確認(rèn)釘釘應(yīng)用已發(fā)布最新版本。

3. 確認(rèn)機(jī)器人消息接收模式為 Stream 模式。

4. 檢查日志中是否有 API 調(diào)用錯(cuò)誤（如 401、403），可能是 API 密鑰無效或權(quán)限不足。

6.4 模型調(diào)用失敗

• 確認(rèn)智譜 API 密鑰有效且有余額（免費(fèi)額度通常足夠）。
• 檢查網(wǎng)絡(luò)能否訪問 https://open.bigmodel.cn。
• 在 TUI 中測(cè)試模型是否正常響應(yīng)。

7. 注意事項(xiàng)

• 安全警告：釘釘插件來自社區(qū)，安裝時(shí)出現(xiàn)“dangerous code patterns”警告，請(qǐng)自行評(píng)估風(fēng)險(xiǎn)。建議定期檢查插件更新或限制其網(wǎng)絡(luò)權(quán)限。
• 配置文件備份：每次修改前備份 openclaw.json，以免誤操作丟失配置。
• 資源占用：OpenClaw 網(wǎng)關(guān)在空閑時(shí)內(nèi)存占用約 300-400MB，CPU 占用極低，適合低配服務(wù)器。
• API 調(diào)用：GLM-4.7-Flash 免費(fèi)有一定的頻率和總量限制，請(qǐng)合理使用。

到此這篇關(guān)于OpenClaw安裝與釘釘機(jī)器人配置總結(jié)的文章就介紹到這了,更多相關(guān)OpenClaw安裝與釘釘配置內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章，希望大家以后多多支持腳本之家！

最新評(píng)論