[OpenClaw]-3-多渠道接入详解

引言

这片文章包含OpenClaw常用平台通道配置与管理教程（Telegram+飞书+Discord+Matrix）确保OpenClaw已完成基础安装并能正常运行，提前备好服务器终端/命令行工具；Telegram需可正常访问API，飞书需企业/个人版开放平台权限，Discord需开发者平台权限，Matrix需提前安装对应插件，默认私聊采用配对码安全模式。

文章目录

0×1.Telegram通道配置
0×2.feishu飞书通道配置

0×1.Telegram通道配置

步骤1：TG官方创建机器人，获取Token

1. 打开Telegram，搜索官方机器人@BotFather，务必核对用户名完全一致，避开假冒机器人，保障账号安全；
2. 发送命令/newbot，按照弹窗提示逐步操作：
- 设置机器人显示名称：可随意设置，后续支持修改，示例：OpenClaw智能助手
- 设置机器人用户名：硬性要求必须以bot结尾，且全网唯一，设置完成后无法修改，提前想好合规用户名
3. 创建成功后，@BotFather会自动返回一串以[数字:字母]组合的 API Token 完整复制并加密保存，这是通道连接核心凭证，严禁泄露给他人，泄露后需立即重置；
4. 可选优化：发送/setcommands给@BotFather，可自定义机器人快捷命令，新手可暂时跳过，后续使用流畅度提升后再配置；

附加：TG机器人更换API Token方法

1. 向 @BotFather 发送 /revoke；
2. 选择目标机器人；
3. 确认后，自动生成新 Token，旧 Token 立即作废；

步骤2：OpenClaw命令行配置TG通道

打开OpenClaw部署服务器的终端，逐行执行以下命令，将“你的TG机器人Token”替换为步骤1获取的完整凭证，全程保留默认安全配置，杜绝陌生人骚扰：

					
					# 启用Telegram通道
					 987@hk987.xyz:~$ openclaw config set channels.telegram.enabled true

					# 填入机器人专属Token，务必完整粘贴，无多余空格
					 987@hk987.xyz:~$ openclaw config set channels.telegram.botToken "你的TG机器人Token"

					# 默认私聊配对安全模式（防陌生人滥用，官方推荐）
					 987@hk987.xyz:~$ openclaw config set channels.telegram.dmPolicy "pairing"

					# 群聊内必须@机器人才响应，避免无关消息误触发
					 987@hk987.xyz:~$ openclaw config set channels.telegram.groups.*.requireMention true

步骤3：重启网关并验证连通

					
					# 执行重启命令，加载新配置，这是配置生效的必要步骤
					 987@hk987.xyz:~$ openclaw gateway restart

					# 查看Channel状态，Enabled下面显示ON，State显示OK，Detail下显示了Token Config，就算成了
					 987@hk987.xyz:~$ openclaw status
					│ Channel  │ Enabled │ State  │ Detail
					│ Telegram │ ON      │ OK     │ token config (7976…KVro · len 46) · accounts 1/1

故障排除：若通道状态显示Enabled: ON、State: SETUP，且Detail提示no token，说明仅开启了通道开关，未正确配置或保存Token，属于未完成配置状态，补全Token并重启即可。

步骤4：私聊配对审批（首次使用必做）

首次在Tg中和自己创建的机器人对话，随便发一条消息，就会收到一个配对码，类似下面的格式：

					
					# 配对码格式
					OpenClaw: access not configured.
					Your Telegram user id: 7239880009
					Pairing code: CEX9XVXX  <--- 这个就是你的配对码

					# 回到终端，执行下面的命令，进行配对
					 987@hk987.xyz:~$ openclaw pairing approve telegram "替换成你的配对码"

配对成功后，即可正常和TG机器人对话，同一用户后续无需重复配对，会话长期有效。

停用Tg Channel步骤：

					
					# 1.删除通道根节点
					 987@hk987.xyz:~$ openclaw config unset channels.telegram
					# 2. 停用通道
					 987@hk987.xyz:~$ openclaw config set channels.telegram.enabled false
					# 3. 重启服务
					 987@hk987.xyz:~$ openclaw gateway restart
					# 4.上面的操作还是会在openclaw status里面残留Tg的双OFF记录
					# 如果想彻底从status列表删除，可以手动打开.openclaw/openclaw.json主配置文件
					# 找到plugins下的telegram字段，删除整个字段保存即可
					...
					"plugins": {
					    "entries": {
					      "telegram": {  #删除
					        "enabled": true #删除
					      } #删除
					    }
					  }

0×2.feishu飞书通道配置

步骤1：飞书开放平台创建自建应用

1. 打开飞书开放平台官网：https://open.feishu.cn/ ；
（国际版Lark跳转：https://open.larksuite.com/）；
登录企业飞书账号，个人版部分权限受限，优先推荐企业账号；
2. 点击创建企业自建应用，完善基础信息：
- 应用名称：示例OpenClaw智能助手；
- 应用描述：OpenClaw跨平台消息交互机器人；
- 应用图标：可选上传，建议尺寸240*240px，提升辨识度；
3. 创建完成后，进入左侧"凭证与基础信息"页面，复制"App ID"和"App Secret"，妥善保存，后续配置必填，切勿泄露；

步骤2：飞书应用权限与机器人配置

1. 开启机器人基础能力：左侧菜单找到"应用能力 - 机器人"，点击 "启用（添加）机器人"，按照页面提示设置机器人，完成机器人基础创建，这是后续开通消息权限的前提，未开启机器人能力会导致部分权限无法搜索；
2. 申请核心必备权限：左侧进入 "权限管理"，优先复制下方英文权限标识精准搜索，逐个添加并提交申请：
- im:message.p2p_msg:readonly：读取私聊消息，用于接收用户一对一私聊消息，是私聊交互核心权限；
- im:message.group_at_msg:readonly：读取群聊中@机器人的消息，适配群聊场景交互，避免机器人误读群内无关消息；
- im:message：系统级消息调用权限，专门解决 99991672 核心权限拒绝报错，属于接口调用必备底层权限；
- im:message.reactions:write_only：消息互动补充权限，适配消息互动操作，配合系统级消息权限使用；
- im:message:send_as_bot：机器人以官方身份发送普通文本消息，实现回复用户必备权限，无此权限无法主动发消息；
- contact:user.base:readonly：获取用户基础信息，用于识别对话对象身份，保障会话匹配准确性；
- contact:contact.base:readonly：联系人基础只读权限，修复 “stale permission scope” 联系人权限不足报错；
- im:chat:readonly：读取会话基础信息，用于区分群聊和私聊场景，适配不同会话交互逻辑；
3. 配置事件订阅：左侧进入事件订阅模块，选择 WebSocket长连接模式（无需公网IP、HTTPS证书和回调地址，新手首选），添加事件im.message.receive_v1，完成后保存并启用事件订阅，确保机器人能正常接收消息推送；
4. 发布应用使权限生效：左侧进入版本管理与发布，创建正式新版本，完善版本描述后提交发布；权限修改后必须重新发布应用，新开通的权限才会正式生效，发布完成后等待1分钟，完成全平台同步，再进行OpenClaw端配置；

步骤3：OpenClaw命令行配置飞书通道

终端逐行执行以下命令，替换你自己的App ID和App Secret，区分国内版与国际版：

					
					# 启用飞书通道
					openclaw config set channels.feishu.enabled true

					# 填入飞书应用官方凭证
					openclaw config set channels.feishu.appId "你的飞书App ID"
					openclaw config set channels.feishu.appSecret "你的飞书App Secret"

					# 国内版飞书填feishu，国际版Lark填lark
					openclaw config set channels.feishu.domain "feishu"

					# WebSocket长连接（无需公网IP、HTTPS证书，新手首选）
					openclaw config set channels.feishu.connectionMode "websocket"

					# 默认私聊配对安全模式，防外部骚扰
					openclaw config set channels.feishu.dmPolicy "pairing"

步骤4：重启网关并验证

					
					# 1. 重启OpenClaw网关，使配置生效：
					openclaw gateway restart

					# 2. 查看运行状态，确认飞书通道加载成功：
					openclaw status

					# 3. 打开飞书，搜索创建的机器人，随便发送一条消息获取配对码
					# 终端执行下面的审批命令即可正常交互
					openclaw pairing approve feishu "收到的配对码""

停用Feishu Channel步骤

					
					# 1. 删除通道根节点
					openclaw config unset channels.feishu

					# 2.停用通道
					openclaw config set channels.feishu.enabled false

					# 3.此时重启openclaw，就已经可以在status中看到被禁用的feishu channel了
					openclaw gateway restart

					# 4.如果想彻底从status中删除，需要打开当前用户家目录下的
					# .openclaw/openclaw.json这个主配置文件，删除plugins下的feishu字段
					....
					  "plugins": {
					    "entries": {
					      "feishu": {  # 删除
					        "enabled": true # 删除
					      } # 删除
					    }
					  }

HK987 - hk987.xyz

S=−k∑pilnpi

[OpenClaw]-3-多渠道接入详解

引言

文章目录

0×1.Telegram通道配置

0×2.feishu飞书通道配置