OpenClaw 安装配置指南：从零开始在 Telegram 和飞书中使用 AI 助手

前言

最近开始使用 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

posted @ 2026-03-03 20:03 consern 阅读(178) 评论(0) 收藏举报

刷新页面返回顶部

consern