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

巨到发表于 2026-3-4 00:20:03

<h2>前言</h2>
<p>最近开始使用 OpenClaw，一个开源的 AI 助手框架，可以让我们在自己的服务器或本地运行 AI 助手，并接入多种消息平台。本文记录了我在安装配置 OpenClaw 并接入 Telegram 和飞书的过程，希望对有同样需求的朋友有所帮助。</p>
<h2>一、什么是 OpenClaw？</h2>
<p>OpenClaw 是一个开源的 AI 助手框架，支持：</p>
<ul>
<li>多模型支持：可以接入 Claude、GPT、GLM 等多种大语言模型</li>
<li>多平台接入：支持 Telegram、飞书、Discord、WhatsApp 等多种消息平台</li>
<li>本地运行：可以在本地或服务器上运行，数据更安全</li>
<li>插件系统：丰富的技能插件，可扩展功能</li>
<li>浏览器自动化：支持 Chrome 扩展，可以控制浏览器</li>
</ul>
<h2>二、安装 OpenClaw</h2>
<h3>1. 安装 Node.js</h3>
<p>OpenClaw 基于 Node.js 运行，首先确保你的系统已安装 Node.js 18+：</p>
node -v# 检查版本
<h3>2. 安装 OpenClaw</h3>
npm install -g openclaw@latest
<h3>3. 初始化配置</h3>
<p>OpenClaw 提供了交互式的配置向导，推荐使用 <code>openclaw onboard</code> 命令进行初始化：</p>
# 运行配置向导（推荐）
openclaw onboard
<p>配置向导会引导你完成以下步骤：</p>
<ul>
<li><strong>模型选择</strong> - 选择 AI 模型提供商（支持 Claude、GPT、GLM 等）</li>
<li><strong>工作空间</strong> - 设置工作目录（默认 <code>~/.openclaw/workspace</code>）</li>
<li><strong>网关配置</strong> - 设置端口（默认 18789）、绑定地址、认证模式</li>
<li><strong>消息渠道</strong> - 配置 WhatsApp、Telegram、Discord、飞书等</li>
<li><strong>守护进程</strong> - 安装系统服务（macOS 用 LaunchAgent，Linux 用 systemd）</li>
<li><strong>健康检查</strong> - 启动网关并验证运行状态</li>
<li><strong>技能安装</strong> - 安装推荐的技能插件</li>
</ul>
<p>如果你想安装系统服务并自动启动：</p>
# 安装守护进程服务
openclaw onboard --install-daemon
<h4>配置消息渠道</h4>
<p>使用以下命令登录各个消息平台：</p>
# 登录各消息渠道（交互式）
openclaw channels login
<h4>启动网关</h4>
# 启动网关服务
openclaw gateway --port 18789
<h4>高级配置</h4>
<p>如果需要重新配置或修改设置：</p>
# 重新配置
openclaw configure

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

# 查看配置路径
openclaw config path

# 查看状态
openclaw status
<p>启动后会生成配置文件 <code>~/.openclaw/openclaw.json</code>。</p>
<h2>三、配置模型</h2>
<p>OpenClaw 支持多种模型提供商。我配置了 GLM-5 作为主力模型：</p>
<h3>配置 GLM-5</h3>
<p>编辑 <code>~/.openclaw/openclaw.json</code>，添加模型配置：</p>
{
"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"
   }
}
}
}
<h2>四、配置 Telegram Bot</h2>
<h3>1. 创建 Bot</h3>
<ol>
<li>在 Telegram 中搜索 <code>@BotFather</code></li>
<li>发送 <code>/newbot</code> 创建新 Bot</li>
<li>按提示设置 Bot 名称</li>
<li>获取 Bot Token</li>
</ol>
<h3>2. 配置 OpenClaw</h3>
<p>在配置文件中添加 Telegram 配置：</p>
{
"channels": {
"telegram": {
   "enabled": true,
   "botToken": "your-bot-token"
}
}
}
<h3>3. 获取 Chat ID</h3>
<p>给你的 Bot 发送消息后，访问以下 URL 获取 Chat ID：</p>
https://api.telegram.org/bot{BOT_TOKEN}/getUpdates
<h3>4. 安装浏览器扩展（可选）</h3>
<p>如果需要浏览器自动化功能：</p>
<ol>
<li>在 Chrome 网上应用店搜索 "OpenClaw Browser Relay"</li>
<li>安装扩展</li>
<li>在扩展设置中输入连接码：<code>openclaw gateway token</code></li>
<li>在要控制的页面点击扩展图标激活</li>
</ol>
<h2>五、配置飞书</h2>
<h3>1. 创建飞书应用</h3>
<ol>
<li>访问飞书开放平台：<code>https://open.feishu.cn</code></li>
<li>创建企业自建应用</li>
<li>获取 App ID 和 App Secret</li>
</ol>
<h3>2. 配置权限</h3>
<p>在飞书应用后台添加以下权限：</p>
<ul>
<li><code>im:message</code> - 获取和发送消息</li>
<li><code>im:message:send_as_bot</code> - 以应用身份发消息</li>
</ul>
<h3>3. 配置 OpenClaw</h3>
{
"channels": {
"feishu": {
   "enabled": true,
   "appId": "your-app-id",
   "appSecret": "your-app-secret"
}
}
}
<h3>4. 配置事件订阅</h3>
<p>在飞书应用后台配置事件订阅，URL 为：</p>
http://your-server:18789/webhook/feishu
<h2>六、实战：自动新闻推送</h2>
<p>配置完成后，我实现了一个自动新闻推送功能，每 10 分钟抓取美伊冲突新闻并推送到飞书。</p>
<h3>核心代码示例</h3>
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);
}
<h3>设置定时任务</h3>
# Windows 任务计划程序
schtasks /Create /TN "新闻推送" /TR "node push-news.js" /SC MINUTE /MO 10
<h2>七、常用命令</h2>
# 启动网关
openclaw gateway --port 18789

# 查看状态
openclaw status

# 查看配置路径
openclaw config path

# 获取连接码（用于浏览器扩展）
openclaw gateway token

# 安装技能
openclaw skills install skill-name
<h2>八、总结</h2>
<p>OpenClaw 是一个功能强大的 AI 助手框架，通过简单的配置就能接入多种消息平台。本文介绍了：</p>
<ul>
<li>OpenClaw 的安装和基本配置</li>
<li>GLM-5 模型的接入</li>
<li>Telegram Bot 的创建和配置</li>
<li>飞书应用的配置</li>
<li>浏览器扩展的安装和使用</li>
<li>实际的新闻推送功能实现</li>
</ul>
<p>希望这篇博客能帮助你快速上手 OpenClaw。如果有问题，欢迎在评论区留言交流！</p>
<h2>参考链接</h2>
<ul>
<li>OpenClaw 官网：<code>https://openclaw.ai</code></li>
<li>OpenClaw GitHub：<code>https://github.com/openclaw/openclaw</code></li>
<li>技能市场：<code>https://clawhub.com</code></li>
</ul><br>来源：程序园用户自行投稿发布，如果侵权，请联系站长删除<br>免责声明：如果侵犯了您的权益，请联系站长，我们会及时删除侵权内容，谢谢合作！

孜稞发表于 2026-3-8 17:39:58

yyds。多谢分享

秤陷曲 发表于 2026-3-11 07:33:44

谢谢分享，试用一下

页: [1]

程序园's Archiver

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