OpenClaw 是什么?
OpenClaw 是一款面向个人和团队的 AI 工作流平台,核心功能是将 AI 大模型(ChatGPT、Claude、DeepSeek 等)无缝接入你日常使用的通讯工具——包括 Telegram 和飞书(Lark)。你不需要打开网页或 App,直接在聊天界面就能调用 AI,实现真正意义上的 AI 工作流集成。
OpenClaw 的核心优势:
- 多平台接入:同时支持 Telegram Bot、飞书机器人、Slack(开发中)
- 自定义 AI 指令:为不同场景配置专属的 System Prompt 和工作流
- 完全自托管:部署在自己的服务器,数据不经过第三方
- 开放 API:支持接入任意兼容 OpenAI 格式的模型
- 中文体验优化:界面和文档均提供中文版本
OpenClaw 适合哪些人使用?
- 希望在飞书工作群里直接使用 AI 的职场人士
- 在 Telegram 上管理频道/群组、需要 AI 辅助的创作者
- 希望搭建团队 AI 助手、统一管理 AI 使用权限的管理者
- 开发者:需要在自己的平台集成 AI 对话能力
- 个人用户:想要一个随时随地可用的私人 AI 助手
OpenClaw 快速开始:Windows 安装教程
第一步:环境准备
OpenClaw 支持 Windows 10/11、macOS 和 Linux。Windows 用户推荐使用 PowerShell 进行安装。
安装前需要准备:
- 一个 AI API Key(OpenAI、Anthropic、DeepSeek 或其他 OpenAI 格式兼容服务均可)
- 网络能够访问所选 AI 服务的 API 端点
- Windows 10 Build 17763 以上,或 macOS 12 以上
第二步:PowerShell 一键安装
以管理员身份打开 PowerShell,运行安装命令:
irm https://get.openclaw.io/install.ps1 | iex
安装程序会自动完成:依赖下载、服务配置、初始化 onboarding 流程。
安装完成后,访问 http://localhost:3000 打开 OpenClaw Dashboard。
第三步:验证服务状态
在 Dashboard 中查看 Gateway Status,确认显示 Connected(绿色)。若显示 Disconnected,检查:
- 防火墙是否放行了 3000 端口
- API Key 是否正确填写
- 服务是否已启动(在 PowerShell 中运行
openclaw status)
详细安装步骤和常见报错解决,请参考 OpenClaw Windows 安装完整教程。
OpenClaw 接入飞书(Lark)教程
飞书是国内最流行的企业通讯工具之一,将 OpenClaw 接入飞书后,你可以在飞书群组或私聊中直接与 AI 对话。
步骤一:创建飞书应用
- 登录 飞书开放平台(open.feishu.cn)
- 点击「创建企业自建应用」
- 填写应用名称(如AI助手)和描述
- 在「凭证与基础信息」页面,记录 App ID 和 App Secret
步骤二:配置权限
在飞书应用后台的「权限管理」中,开启以下权限:
- 消息与群组 → 接收群消息 / 发送消息
- 用户信息 → 获取用户基本信息
权限申请后需要管理员审批(自建应用在同企业内通常可自动通过)。
步骤三:在 OpenClaw 中绑定飞书
- 打开 OpenClaw Dashboard → Integration → 飞书
- 填入 App ID 和 App Secret
- 点击「生成 Pairing Code」
- 在飞书中找到你的机器人,发送 pairing code 完成绑定
- 绑定成功后,在飞书中发送任意消息,机器人应回复 AI 响应
详细图文教程:OpenClaw 飞书集成完整教程
OpenClaw 接入 Telegram 教程
Telegram 是全球最活跃的加密通讯工具,也是技术用户的首选社群平台。将 OpenClaw 接入 Telegram,让 AI 在你的频道和群组中发挥作用。
步骤一:创建 Telegram Bot
- 在 Telegram 中搜索 @BotFather,发送
/newbot - 按提示填写 Bot 名称和用户名(用户名必须以 bot 结尾)
- BotFather 会返回一个 Bot Token,格式如:
123456789:ABCdef... - 记录这个 Token,妥善保管
步骤二:Privacy Mode 配置
⚠️ 重要:默认情况下,Telegram Bot 在群组中只能接收以 / 开头的命令。要让 Bot 能读取普通消息(即 @mention 或所有消息),需要在 BotFather 中配置:
- 发送
/setprivacy→ 选择你的 Bot → 选择 DISABLED(关闭 Privacy Mode) - 或在 OpenClaw 配置中启用
requireMention: true,Bot 只响应 @Bot 的消息
步骤三:在 OpenClaw 绑定 Telegram
- OpenClaw Dashboard → Integration → Telegram
- 填入 Bot Token
- 点击「生成 Pairing Code」
- 向你的 Bot 发送 pairing code
- 绑定成功后测试对话
OpenClaw 群组配置:groupPolicy 详解
在 Telegram 群组或飞书群中使用 OpenClaw 时,需要配置 groupPolicy 来控制 AI 的响应行为。
关键配置项
- requireMention:
true表示只响应 @Bot 的消息;false表示响应所有消息(高流量群慎用) - groupAllowFrom:白名单模式,只允许特定用户 ID 或角色触发 AI
- groups:指定哪些群组 ID 允许使用 AI,不在列表中的群 Bot 不响应
- systemPrompt:为每个群组配置专属的 AI 角色和行为规则
推荐的群组配置示例
{
requireMention: true,
groupAllowFrom: [admin, moderator],
systemPrompt: 你是燕紫苑AI助手,专注回答AI工具使用问题。回答简洁,使用中文。
}
详细配置说明:OpenClaw Telegram 群组设置教程
OpenClaw 常见报错与排查
问题一:Gateway 显示 Disconnected
症状:Dashboard 中 Gateway Status 为红色,AI 无响应。
排查步骤:
- 检查 API Key 是否有效(在 AI 服务商后台验证)
- 检查网络:服务器是否能访问 AI API 端点
- 查看 OpenClaw 日志:
openclaw logs gateway - 重启服务:
openclaw restart
问题二:飞书/Telegram Bot 不回复消息
排查步骤:
- 确认 Pairing 状态为已绑定(Dashboard → Integration → 绑定状态)
- 飞书:确认消息权限已获批
- Telegram:确认 Privacy Mode 配置正确,Bot 已被加入群组且为管理员
- 检查
requireMention配置,尝试 @Bot 触发
问题三:AI 回复质量差或答非所问
解决方案:优化 System Prompt。在 OpenClaw 中为每个接入的平台/群组设置清晰的角色定义:
你是一名专业的AI工具顾问。请:
1. 用简洁的中文回答
2. 优先推荐免费方案
3. 遇到不确定的问题,明确告知用户
更多报错解决:OpenClaw 报错排查完整指南
OpenClaw vs 其他 AI 集成方案对比
| 方案 | 支持平台 | 自托管 | 难度 | 费用 |
|---|---|---|---|---|
| OpenClaw | Telegram + 飞书 | ✅ 是 | 中 | 免费(自备 API) |
| Coze | 多平台 | ❌ 否 | 低 | 免费/付费 |
| n8n + AI | 全平台 | ✅ 可选 | 高 | 免费/付费 |
| Dify | API/Web | ✅ 是 | 中高 | 开源免费 |
| 直接调用 API | 自定义 | ✅ 是 | 高 | 免费(需编程) |
OpenClaw 的核心优势是开箱即用 + 完全自托管,数据不经过任何第三方,适合对数据隐私有要求的用户和团队。
开始使用 OpenClaw
OpenClaw 的完整教程系列:
- Windows 安装教程 — 从零开始搭建
- 飞书集成教程 — 在飞书中使用 AI
- Telegram 接入教程 — 在 Telegram 中部署 AI Bot
- 群组配置详解 — 精细控制群组 AI 行为
- 报错排查指南 — 解决常见问题
遇到问题?欢迎通过 联系我们 反馈,或加入 Telegram 频道 获取最新动态和社区支持。