前言
最近开始使用 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+: 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
来源:程序园用户自行投稿发布,如果侵权,请联系站长删除 免责声明:如果侵犯了您的权益,请联系站长,我们会及时删除侵权内容,谢谢合作! |