OpenClaw 使用教程

Appearance

Channels（渠道）接入 ​

目标：把 OpenClaw 接到你常用的聊天工具里（Telegram/WhatsApp/Discord/Slack/飞书…）。

常用命令 ​

bash
openclaw channels list
openclaw channels status
openclaw channels logs --channel all

添加/移除账号（示例） ​

bash
openclaw channels add --channel telegram --token <bot-token>
openclaw channels remove --channel telegram --delete

登录/登出（交互式，例如 WhatsApp） ​

bash
openclaw channels login --channel whatsapp
openclaw channels logout --channel whatsapp

飞书（Feishu / Lark）接入（生产可用） ​

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

1) 在飞书开放平台创建应用 ​

  • 打开飞书开放平台：https://open.feishu.cn/app
  • 创建「企业自建应用」
  • 在「凭证与基础信息」中获取：
    • App ID（形如 cli_xxx）
    • App Secret

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

2) 配置权限与事件订阅 ​

在飞书应用里：

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

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助手"
        }
      }
    }
  }
}

4) 启动网关并测试 ​

bash
openclaw gateway status
openclaw logs --follow

在飞书里给机器人发消息。默认会收到「配对码」，你需要在本机批准：

bash
openclaw pairing list feishu
openclaw pairing approve feishu <CODE>

5) 群里不回应？先检查这三项 ​

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

更完整的飞书配置与说明建议参考官方文档：OpenClaw docs → channels/feishu。

钉钉（DingTalk）接入（当前教程站点状态） ​

你提到要接入钉钉：OpenClaw 当前版本默认渠道列表里没有“钉钉”插件（至少在本机安装的扩展列表里未看到 dingtalk 扩展）。

因此钉钉有两条可行路线：

路线 A（推荐）：用 Webhook → OpenClaw Hooks 方式对接 ​

思路：

  • 钉钉机器人/应用把消息通过 HTTP 回调发送到你的服务
  • 你的服务再转发到 OpenClaw 的 hooks 入口（触发 wake 或 agent run）

OpenClaw 侧需要开启 hooks（示例）：

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

然后用：

  • POST /hooks/wake（只注入系统事件）
  • POST /hooks/agent（触发一次隔离 agent 运行，并可投递回复）

这一方案的优点：不依赖官方钉钉插件；缺点：需要你自己写一个小的“钉钉事件 → hooks”转发服务。

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

如果你希望“像 Telegram/飞书一样原生接入”，就需要钉钉 channel 插件（如果未来 OpenClaw 官方/社区提供）。

小建议 ​

  • 新手先用 Control UI 把“网关 + 模型 + 基础对话”跑通，再接渠道
  • 渠道不工作优先看 channels status 和 channels logs
  • 定时任务发不出去通常是 delivery 没绑定 channel/to（尤其是 webchat）