找回密码
 立即注册
首页 业界区 科技 OpenClaw 安装配置指南:从零开始在 Telegram 和飞书中 ...

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

巨到 2 小时前

前言

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

  1. node -v # 检查版本
复制代码

2. 安装 OpenClaw

  1. npm install -g openclaw@latest
复制代码

3. 初始化配置

OpenClaw 提供了交互式的配置向导,推荐使用 openclaw onboard 命令进行初始化:

  1. # 运行配置向导(推荐)
  2. openclaw onboard
复制代码

配置向导会引导你完成以下步骤:

  • 模型选择 - 选择 AI 模型提供商(支持 Claude、GPT、GLM 等)
  • 工作空间 - 设置工作目录(默认 ~/.openclaw/workspace
  • 网关配置 - 设置端口(默认 18789)、绑定地址、认证模式
  • 消息渠道 - 配置 WhatsApp、Telegram、Discord、飞书等
  • 守护进程 - 安装系统服务(macOS 用 LaunchAgent,Linux 用 systemd)
  • 健康检查 - 启动网关并验证运行状态
  • 技能安装 - 安装推荐的技能插件

如果你想安装系统服务并自动启动:

  1. # 安装守护进程服务
  2. openclaw onboard --install-daemon
复制代码

配置消息渠道

使用以下命令登录各个消息平台:

  1. # 登录各消息渠道(交互式)
  2. openclaw channels login
复制代码

启动网关

  1. # 启动网关服务
  2. openclaw gateway --port 18789
复制代码

高级配置

如果需要重新配置或修改设置:

  1. # 重新配置
  2. openclaw configure
  3. # 添加新的 agent
  4. openclaw agents add my-agent
  5. # 查看配置路径
  6. openclaw config path
  7. # 查看状态
  8. openclaw status
复制代码

启动后会生成配置文件 ~/.openclaw/openclaw.json

三、配置模型

OpenClaw 支持多种模型提供商。我配置了 GLM-5 作为主力模型:

配置 GLM-5

编辑 ~/.openclaw/openclaw.json,添加模型配置:

  1. {
  2. "models": {
  3. "providers": {
  4. "unicom": {
  5. "baseUrl": "https://maas-api.ai-yuanjing.com/openapi/compatible-mode/v1",
  6. "apiKey": "your-api-key",
  7. "api": "openai-chat",
  8. "models": [
  9. {
  10. "id": "glm-5",
  11. "name": "GLM 5",
  12. "contextWindow": 128000,
  13. "maxTokens": 4096
  14. }
  15. ]
  16. }
  17. }
  18. },
  19. "agents": {
  20. "defaults": {
  21. "model": {
  22. "primary": "unicom/glm-5"
  23. }
  24. }
  25. }
  26. }
复制代码

四、配置 Telegram Bot

1. 创建 Bot

  1. 在 Telegram 中搜索 @BotFather
  2. 发送 /newbot 创建新 Bot
  3. 按提示设置 Bot 名称
  4. 获取 Bot Token

2. 配置 OpenClaw

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

  1. {
  2. "channels": {
  3. "telegram": {
  4. "enabled": true,
  5. "botToken": "your-bot-token"
  6. }
  7. }
  8. }
复制代码

3. 获取 Chat ID

给你的 Bot 发送消息后,访问以下 URL 获取 Chat ID:

  1. https://api.telegram.org/bot{BOT_TOKEN}/getUpdates
复制代码

4. 安装浏览器扩展(可选)

如果需要浏览器自动化功能:

  1. 在 Chrome 网上应用店搜索 "OpenClaw Browser Relay"
  2. 安装扩展
  3. 在扩展设置中输入连接码:openclaw gateway token
  4. 在要控制的页面点击扩展图标激活

五、配置飞书

1. 创建飞书应用

  1. 访问飞书开放平台:https://open.feishu.cn
  2. 创建企业自建应用
  3. 获取 App ID 和 App Secret

2. 配置权限

在飞书应用后台添加以下权限:

  • im:message - 获取和发送消息
  • im:message:send_as_bot - 以应用身份发消息

3. 配置 OpenClaw

  1. {
  2. "channels": {
  3. "feishu": {
  4. "enabled": true,
  5. "appId": "your-app-id",
  6. "appSecret": "your-app-secret"
  7. }
  8. }
  9. }
复制代码

4. 配置事件订阅

在飞书应用后台配置事件订阅,URL 为:

  1. http://your-server:18789/webhook/feishu
复制代码

六、实战:自动新闻推送

配置完成后,我实现了一个自动新闻推送功能,每 10 分钟抓取美伊冲突新闻并推送到飞书。

核心代码示例

  1. const https = require('https');
  2. // 飞书配置
  3. const FEISHU_APP_ID = 'your-app-id';
  4. const FEISHU_APP_SECRET = 'your-app-secret';
  5. const FEISHU_OPEN_ID = 'user-open-id';
  6. // 获取飞书 Token
  7. async function getTenantAccessToken() {
  8. // ... 获取 access_token
  9. }
  10. // 发送消息
  11. async function sendFeishuMessage(message) {
  12. const token = await getTenantAccessToken();
  13. // ... 调用飞书 API 发送消息
  14. }
  15. // 抓取新闻并推送
  16. async function main() {
  17. const news = await fetchNews();
  18. const summary = await summarizeWithAI(news); // 用 GLM-5 总结
  19. await sendFeishuMessage(summary);
  20. }
复制代码

设置定时任务

  1. # Windows 任务计划程序
  2. schtasks /Create /TN "新闻推送" /TR "node push-news.js" /SC MINUTE /MO 10
复制代码

七、常用命令

  1. # 启动网关
  2. openclaw gateway --port 18789
  3. # 查看状态
  4. openclaw status
  5. # 查看配置路径
  6. openclaw config path
  7. # 获取连接码(用于浏览器扩展)
  8. openclaw gateway token
  9. # 安装技能
  10. 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

来源:程序园用户自行投稿发布,如果侵权,请联系站长删除
免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作!

相关推荐

您需要登录后才可以回帖 登录 | 立即注册