OpenClaw 使用教程

Appearance

Channels（渠道）接入（SOP） ​

目标：把 OpenClaw 接到你常用的聊天工具里（Telegram / WhatsApp / Discord / Slack / 飞书…），并能稳定收发消息。

0) 接渠道前的前置条件（别跳过） ​

  • [ ] Gateway 正常运行（建议先用 Control UI 聊通）
  • [ ] 模型可用（至少 openclaw models status 不报错）
  • [ ] 你知道“要接哪个渠道、用哪个账号/机器人身份”

1) 通用接入流程（所有渠道都适用） ​

Step 1：列出当前渠道 ​

bash
openclaw channels list
openclaw channels status

Step 2：添加账号 / 登录 ​

  • 直接交互式（推荐新手）：
bash
openclaw channels add
  • 或者按渠道指定参数（示例 Telegram）：
bash
openclaw channels add --channel telegram --token <bot-token>
  • 交互式登录（示例 WhatsApp）：
bash
openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp

Step 3：看日志验证收发 ​

bash
openclaw channels logs --channel all
openclaw logs --follow

2) 验收清单（接入成功的标准） ​

  • [ ] openclaw channels status 显示该渠道可用
  • [ ] 在渠道里给机器人发消息，能收到回复
  • [ ] 日志里没有持续报错（401/403/429/5xx）

3) 常见问题（通用） ​

现象 A：能发不能收 / 能收不能发 ​

  • 优先看：channels logs + openclaw logs --follow
  • 常见原因：权限缺失、事件订阅没开、webhook/长连接没跑起来

现象 B：群里不回应 ​

  • 常见原因：需要 @ 才回复、群策略禁用、机器人没入群

现象 C：定时任务没发到渠道 ​

  • 常见原因：cron delivery 未绑定 channel/to

4) 飞书（Feishu / Lark）接入（生产可用｜推荐） ​

OpenClaw 内置 Feishu 插件，支持私聊与群组，默认用 WebSocket 长连接收消息（无需公网回调 URL）。

Step 1：创建应用并拿到凭证 ​

Lark（国际版）使用 https://open.larksuite.com/app，并在配置里把 domain 设为 lark。

Step 2：权限与事件订阅 ​

  • 权限管理：给必要 IM 权限（至少收/发消息）
  • 事件订阅：选择 长连接，订阅 im.message.receive_v1

Step 3：在 OpenClaw 添加渠道 ​

bash
openclaw channels add

按提示选择 Feishu 并填写 App ID / App Secret。

（可选）配置示例：

json5
{
  channels: {
    feishu: {
      enabled: true,
      dmPolicy: "pairing",
      accounts: {
        main: {
          appId: "cli_xxx",
          appSecret: "xxx",
          botName: "我的AI助手"
        }
      }
    }
  }
}

Step 4：配对与验证 ​

  • 给机器人发消息，拿到配对码
  • 本机批准配对：
bash
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

Step 5：群里不回的三连检查 ​

  • 机器人是否已加入群
  • 是否需要 @ 才回复（常见默认 requireMention: true）
  • 群策略是否禁用（例如 groupPolicy: "disabled"）

5) 钉钉（DingTalk）接入（当前站点结论） ​

说明：在本机可见的扩展列表中，未看到官方/默认的 DingTalk channel 插件。

因此钉钉接入的两条可行路线：

路线 A（推荐）：钉钉 Webhook → OpenClaw Hooks 转发 ​

思路：

  • 钉钉机器人/应用把消息回调到你的服务
  • 你的服务再转发到 OpenClaw 的 hooks（wake 或 agent）

OpenClaw 侧 hooks 配置示例：

json5
{
  hooks: {
    enabled: true,
    token: "shared-secret",
    path: "/hooks"
  }
}

优点：不依赖钉钉插件；缺点：需要一个小转发服务。

路线 B：开发/安装 DingTalk 渠道插件 ​

如果你希望“像 Telegram/飞书一样原生接入”，需要对应的 channel 插件（官方或社区）。

6) 最小建议（新手不走弯路） ​

  1. 先 Control UI 把“网关 + 模型 + 基础对话”跑通
  2. 再接一个渠道（先 Feishu/Telegram 这种路径清晰的）
  3. 渠道不工作：先 channels status / channels logs，再看 openclaw logs --follow