OpenClaw Docs CN

渠道接入 / 栏目总览

渠道接入总览

Channels Overview

装好以后,下一步不是继续折腾安装,而是让它出现在真实聊天入口里。

这页的任务很简单:先帮你选对第一站。你不用一开始就把所有平台都接上,只要先判断自己最适合从飞书、钉钉、QQ / 企业微信,还是 Telegram / Discord 开始,然后顺着那条路跑通第一个渠道就够了。

渠道入口页 先接通 1 个平台 再考虑多渠道并行
What This Solves

这章先帮你解决 4 个问题

在开始配置任何平台之前,先把这几个问题想清楚,后面会省很多力气。

OpenClaw 为什么还不会“说话” 因为安装和 Dashboard 只是让系统跑起来,真正让它出现在聊天场景里的,是渠道接入。
Gateway 到底在做什么 所有外部消息都会先进入 Gateway,再被路由到对应的会话、模型和工作流里。
我第一站该接哪个平台 不同平台的难度、稳定性和适用场景都不一样,先选对第一站比一次接 5 个更重要。
接入前到底要准备什么 不仅仅是一个 Token,还包括 Gateway、模型状态、平台凭证以及是否需要公网可达。
How To Think

先用一句话理解渠道接入

如果你先把这件事想清楚,后面每个平台都会更好理解。

外部平台发消息

  • 飞书群里 @ 机器人
  • Telegram 私聊发消息
  • Discord 频道里提到 Bot

Gateway 统一接住

  • 识别来源平台
  • 找到对应会话和上下文
  • 把消息路由给模型和能力层

结果再回到原平台

  • 回到同一个群或私聊
  • 保留对应渠道上下文
  • 形成真正可用的聊天入口
Pick Your First Platform

第一站怎么选,最省力

你不需要先把所有平台都研究一遍,直接按自己的目标选第一站就行。

Useful Links

如果你准备从飞书开始,这几组入口最常用

中国用户第一站最常见的就是飞书,所以这里先把飞书平台入口、火山引擎模型入口和站内案例一并放好。

Route Types

按当前官方和社区边界看,渠道大概分成 3 类

这一步很重要,因为它决定了你后面应该按哪种思路去查问题。

官方内置渠道

更典型的是 Telegram、Discord 这类 Bot Token 路线。文档通常更清楚,适合第一次体验消息接入。

官方插件路线

飞书更适合这样理解。它不是“全内置到核心里”的一种表述,但接入体验和官方支持都很好。

社区常用路线

钉钉、QQ、企业微信、微信个人号在中国需求很高,但稳定性、合规性和维护方式并不完全一样,更适合分开讲。

Before You Connect

接入前真正要准备的,不止是一个 Token

很多人以为平台接不上,是因为“凭证填错了”,但实际更常见的是前置条件没准备好。

先确认 Gateway 正在运行 比起先记平台回调地址,更重要的是确保 Gateway 本身健康。
准备平台自己的凭证 有的平台是 Bot Token,有的是 App ID / App Secret,有的是回调签名密钥。
确认默认模型已经可用 很多“渠道没接好”的表象,最后其实是模型没法生成回复。
确认是否真的需要公网可达 不是所有渠道都要 HTTPS Webhook,Token 轮询、WebSocket 和插件桥接路线要求并不一样。
Read Order

这一章最推荐的阅读顺序

如果你不想反复跳页面,渠道接入这一章建议按这个顺序往下看。

Success Check

接好一个渠道以后,怎么快速验证

无论你先接哪个平台,最实用的检查方式通常都差不多。

openclaw gateway status
openclaw channels status

然后做一次最小验证:

  1. 在平台里给机器人发一条最简单的消息。
  2. 看 Dashboard 里有没有新会话或新事件。
  3. 看 Gateway 日志里有没有收到消息、路由成功或返回错误。

如果消息已经进入 Gateway,但机器人没有回复,优先检查模型连通性,而不是一上来就怀疑渠道配置。

一句话总结

渠道接入这一章最重要的不是“知道平台越多越好”,而是先选对第一站,把一条消息完整地从平台送进 Gateway,再从 Gateway 回到平台。只要第一个渠道跑通了,后面的扩展就会容易很多。