OpenClaw 安裝配置指南：從零開始在 Telegram 和飛書中使用 AI 助手詳情 - AI consern 博客

前言

最近開始使用 OpenClaw，一個開源的 AI 助手框架，可以讓我們在自己的服務器或本地運行 AI 助手，並接入多種消息平台。本文記錄了我在安裝配置 OpenClaw 並接入 Telegram 和飛書的過程，希望對有同樣需求的朋友有所幫助。

一、什麼是 OpenClaw？

OpenClaw 是一個開源的 AI 助手框架，支持：

多模型支持：可以接入 Claude、GPT、GLM 等多種大語言模型
多平台接入：支持 Telegram、飛書、Discord、WhatsApp 等多種消息平台
本地運行：可以在本地或服務器上運行，數據更安全
插件系統：豐富的技能插件，可擴展功能
瀏覽器自動化：支持 Chrome 擴展，可以控制瀏覽器

二、安裝 OpenClaw

1. 安裝 Node.js

OpenClaw 基於 Node.js 運行，首先確保你的系統已安裝 Node.js 18+：

node -v  # 檢查版本

2. 安裝 OpenClaw

npm install -g openclaw@latest

3. 初始化配置

OpenClaw 提供了交互式的配置嚮導，推薦使用 openclaw onboard 命令進行初始化：

# 運行配置嚮導（推薦）
openclaw onboard

配置嚮導會引導你完成以下步驟：

模型選擇 - 選擇 AI 模型提供商（支持 Claude、GPT、GLM 等）
工作空間 - 設置工作目錄（默認 ~/.openclaw/workspace）
網關配置 - 設置端口（默認 18789）、綁定地址、認證模式
消息渠道 - 配置 WhatsApp、Telegram、Discord、飛書等
守護進程 - 安裝系統服務（macOS 用 LaunchAgent，Linux 用 systemd）
健康檢查 - 啓動網關並驗證運行狀態
技能安裝 - 安裝推薦的技能插件

如果你想安裝系統服務並自動啓動：

# 安裝守護進程服務
openclaw onboard --install-daemon

配置消息渠道

使用以下命令登錄各個消息平台：

# 登錄各消息渠道（交互式）
openclaw channels login

啓動網關

# 啓動網關服務
openclaw gateway --port 18789

高級配置

如果需要重新配置或修改設置：

# 重新配置
openclaw configure

# 添加新的 agent
openclaw agents add my-agent

# 查看配置路徑
openclaw config path

# 查看狀態
openclaw status

啓動後會生成配置文件 ~/.openclaw/openclaw.json。

三、配置模型

OpenClaw 支持多種模型提供商。我配置了 GLM-5 作為主力模型：

配置 GLM-5

編輯 ~/.openclaw/openclaw.json，添加模型配置：

{
  "models": {
    "providers": {
      "unicom": {
        "baseUrl": "https://maas-api.ai-yuanjing.com/openapi/compatible-mode/v1",
        "apiKey": "your-api-key",
        "api": "openai-chat",
        "models": [
          {
            "id": "glm-5",
            "name": "GLM 5",
            "contextWindow": 128000,
            "maxTokens": 4096
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "unicom/glm-5"
      }
    }
  }
}

四、配置 Telegram Bot

1. 創建 Bot

在 Telegram 中搜索 @BotFather
發送 /newbot 創建新 Bot
按提示設置 Bot 名稱
獲取 Bot Token

2. 配置 OpenClaw

在配置文件中添加 Telegram 配置：

{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "your-bot-token"
    }
  }
}

3. 獲取 Chat ID

給你的 Bot 發送消息後，訪問以下 URL 獲取 Chat ID：

https://api.telegram.org/bot{BOT_TOKEN}/getUpdates

4. 安裝瀏覽器擴展（可選）

如果需要瀏覽器自動化功能：

在 Chrome 網上應用店搜索 "OpenClaw Browser Relay"
安裝擴展
在擴展設置中輸入連接碼：openclaw gateway token
在要控制的頁面點擊擴展圖標激活

五、配置飛書

1. 創建飛書應用

訪問飛書開放平台：https://open.feishu.cn
創建企業自建應用
獲取 App ID 和 App Secret

2. 配置權限

在飛書應用後台添加以下權限：

im:message - 獲取和發送消息
im:message:send_as_bot - 以應用身份發消息

3. 配置 OpenClaw

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "your-app-id",
      "appSecret": "your-app-secret"
    }
  }
}

4. 配置事件訂閲

在飛書應用後台配置事件訂閲，URL 為：

http://your-server:18789/webhook/feishu

六、實戰：自動新聞推送

配置完成後，我實現了一個自動新聞推送功能，每 10 分鐘抓取美伊衝突新聞並推送到飛書。

核心代碼示例

const https = require('https');

// 飛書配置
const FEISHU_APP_ID = 'your-app-id';
const FEISHU_APP_SECRET = 'your-app-secret';
const FEISHU_OPEN_ID = 'user-open-id';

// 獲取飛書 Token
async function getTenantAccessToken() {
  // ... 獲取 access_token
}

// 發送消息
async function sendFeishuMessage(message) {
  const token = await getTenantAccessToken();
  // ... 調用飛書 API 發送消息
}

// 抓取新聞並推送
async function main() {
  const news = await fetchNews();
  const summary = await summarizeWithAI(news); // 用 GLM-5 總結
  await sendFeishuMessage(summary);
}

設置定時任務

# Windows 任務計劃程序
schtasks /Create /TN "新聞推送" /TR "node push-news.js" /SC MINUTE /MO 10

七、常用命令

# 啓動網關
openclaw gateway --port 18789

# 查看狀態
openclaw status

# 查看配置路徑
openclaw config path

# 獲取連接碼（用於瀏覽器擴展）
openclaw gateway token

# 安裝技能
openclaw skills install skill-name

八、總結

OpenClaw 是一個功能強大的 AI 助手框架，通過簡單的配置就能接入多種消息平台。本文介紹了：

OpenClaw 的安裝和基本配置
GLM-5 模型的接入
Telegram Bot 的創建和配置
飛書應用的配置
瀏覽器擴展的安裝和使用
實際的新聞推送功能實現

希望這篇博客能幫助你快速上手 OpenClaw。如果有問題，歡迎在評論區留言交流！

參考鏈接

OpenClaw 官網：https://openclaw.ai
OpenClaw GitHub：https://github.com/openclaw/openclaw
技能市場：https://clawhub.com

consern 博客

consern 博客

博客 / 詳情