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 对话。

步骤一:创建飞书应用

  1. 登录 飞书开放平台(open.feishu.cn)
  2. 点击「创建企业自建应用」
  3. 填写应用名称(如AI助手)和描述
  4. 在「凭证与基础信息」页面,记录 App IDApp Secret

步骤二:配置权限

在飞书应用后台的「权限管理」中,开启以下权限:

  • 消息与群组 → 接收群消息 / 发送消息
  • 用户信息 → 获取用户基本信息

权限申请后需要管理员审批(自建应用在同企业内通常可自动通过)。

步骤三:在 OpenClaw 中绑定飞书

  1. 打开 OpenClaw Dashboard → Integration → 飞书
  2. 填入 App ID 和 App Secret
  3. 点击「生成 Pairing Code」
  4. 在飞书中找到你的机器人,发送 pairing code 完成绑定
  5. 绑定成功后,在飞书中发送任意消息,机器人应回复 AI 响应

详细图文教程:OpenClaw 飞书集成完整教程

OpenClaw 接入 Telegram 教程

Telegram 是全球最活跃的加密通讯工具,也是技术用户的首选社群平台。将 OpenClaw 接入 Telegram,让 AI 在你的频道和群组中发挥作用。

步骤一:创建 Telegram Bot

  1. 在 Telegram 中搜索 @BotFather,发送 /newbot
  2. 按提示填写 Bot 名称和用户名(用户名必须以 bot 结尾)
  3. BotFather 会返回一个 Bot Token,格式如:123456789:ABCdef...
  4. 记录这个 Token,妥善保管

步骤二:Privacy Mode 配置

⚠️ 重要:默认情况下,Telegram Bot 在群组中只能接收以 / 开头的命令。要让 Bot 能读取普通消息(即 @mention 或所有消息),需要在 BotFather 中配置:

  • 发送 /setprivacy → 选择你的 Bot → 选择 DISABLED(关闭 Privacy Mode)
  • 或在 OpenClaw 配置中启用 requireMention: true,Bot 只响应 @Bot 的消息

步骤三:在 OpenClaw 绑定 Telegram

  1. OpenClaw Dashboard → Integration → Telegram
  2. 填入 Bot Token
  3. 点击「生成 Pairing Code」
  4. 向你的 Bot 发送 pairing code
  5. 绑定成功后测试对话

完整教程:OpenClaw Telegram 接入完整教程

OpenClaw 群组配置:groupPolicy 详解

在 Telegram 群组或飞书群中使用 OpenClaw 时,需要配置 groupPolicy 来控制 AI 的响应行为。

关键配置项

  • requireMentiontrue 表示只响应 @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 无响应。

排查步骤

  1. 检查 API Key 是否有效(在 AI 服务商后台验证)
  2. 检查网络:服务器是否能访问 AI API 端点
  3. 查看 OpenClaw 日志:openclaw logs gateway
  4. 重启服务:openclaw restart

问题二:飞书/Telegram Bot 不回复消息

排查步骤

  1. 确认 Pairing 状态为已绑定(Dashboard → Integration → 绑定状态)
  2. 飞书:确认消息权限已获批
  3. Telegram:确认 Privacy Mode 配置正确,Bot 已被加入群组且为管理员
  4. 检查 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 的完整教程系列:

遇到问题?欢迎通过 联系我们 反馈,或加入 Telegram 频道 获取最新动态和社区支持。