> ## Content Index
> Fetch the complete content index at: https://tbbbk.com/llms.txt
> Use this file to discover other available public pages before exploring further.

# OpenClaw 接入飞书/钉钉完整教程：国内用户把 AI 助手搬进工作软件
- URL: https://tbbbk.com/openclaw-wechat-dingtalk-feishu-setup/
- Published: 2026-03-03T02:36:50.000Z
- Updated: 2026-03-03T02:36:50.000Z
- Description: OpenClaw 原生支持 Telegram/Discord 等海外平台，但国内用户更习惯飞书和钉钉。这篇文章手把手教你把 OpenClaw 接进飞书和钉钉，配置完之后直接在工作软件里指挥 AI 干活。
- Author: TuBaiBai
- Tags: 折腾日记, OpenClaw, #Import 2026-07-20 07:13

OpenClaw 默认支持 Telegram 和 Discord，这两个平台在国外用得很顺，但在国内就是两个字：被墙。你每次要跟自己的 AI 助手说话，都得先开代理，翻出去，再发消息，光这个仪式感就够烦的了。更不用说在公司内网环境下，代理软件本身就是个敏感话题，不是所有人都方便挂着。

国内的工作场景里，飞书和钉钉才是主角。很多团队全天挂着飞书开会、审批、传文件，钉钉在传统企业里的渗透率更是高得离谱。这两个软件的特点就是一直开着，从不关掉。如果能把 OpenClaw 直接接进去，随手 @ 一下机器人就能让 AI 帮你干活，完全不需要切换上下文，用起来会顺畅很多。

这篇文章就是干这个的。飞书是 OpenClaw 官方支持的渠道，步骤比较规范；钉钉目前是社区第三方插件，能用但需要手动安装，两个都走一遍，把每一步说清楚。

如果你的 OpenClaw 还没装好，先去看这篇[安装教程](https://tbbbk.com/openclaw-install-host-vs-docker-debian-ubuntu/)，装好了再回来。

## 飞书接入教程

飞书（Lark）是 OpenClaw 官方支持的渠道，从 2026.2.2 版本开始内置，官方插件包名是 \`@openclaw/feishu\`。底层用的是飞书的 WebSocket 长连接模式接收消息，不需要你有公网 IP 或者配内网穿透，直接在本地跑就行。

### 前置条件

两件事先确认：

第一，OpenClaw 已经安装并且在正常运行。终端里跑一下 \`openclaw gateway status\`，显示 running 就行。还没装的先看[这篇安装指南](https://tbbbk.com/openclaw-install-host-vs-docker-debian-ubuntu/)。

第二，你需要一个飞书账号，而且有开发者权限。个人版飞书直接登录飞书开放平台就够用，权限默认开放；公司版飞书需要联系管理员，让他在飞书开放平台给你分配开发者角色，不然创建应用的入口你可能看不到。

### 第一步：安装飞书插件

先在终端里安装官方飞书插件：

```bash
openclaw plugins install @openclaw/feishu
```

装好之后，用这条命令启动渠道配置向导：

```bash
openclaw channels add
```

在交互菜单里选 Feishu，会提示你输入 App ID 和 App Secret，这两个值在第二步里获取。

### 第二步：到飞书开放平台创建应用

打开 <https://open.feishu.cn/app>，用飞书账号登录。注意：如果你用的是国际版飞书（Lark），要去 <https://open.larksuite.com/app> 这个地址，不是同一个。

进去之后点「创建企业自建应用」，填写应用名称和描述。名称随便起，比如「我的 AI 助手」或者「OpenClaw Bot」都行，描述随便写几个字占位，图标可以先跳过。

保存之后，进入刚创建的应用详情，在「凭证与基础信息」这个 tab 里能看到 App ID（格式是 \`cli\_xxx\`）和 App Secret。把这两个值复制出来，回去填进 \`openclaw channels add\` 的提示里。

### 第三步：配置权限

飞书应用需要开通一批权限才能正常收发消息，手动一个个勾选很麻烦，但飞书支持批量导入 JSON，直接把下面这段粘贴进去就行。

进入应用 → 权限管理 → 批量导入，粘贴以下内容：

```json
{
  "scopes": {
    "tenant": [
      "im:message",
      "im:message:send_as_bot",
      "im:message:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.group_at_msg:readonly",
      "im:chat.members:bot_access",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:resource",
      "contact:user.employee_id:readonly",
      "application:application:self_manage",
      "application:bot.menu:write"
    ],
    "user": [
      "im:chat.access_event.bot_p2p_chat:read"
    ]
  }
}
```

导入完成后权限列表会自动填好，不需要逐个手动勾选。

企业版飞书的权限需要管理员审批，提交之后让管理员在后台通过就行；个人版飞书一般直接自动通过，几分钟之内就好。

### 第四步：添加机器人能力并发布应用

权限配好之后，还要把机器人功能显式开启。在应用详情的左侧菜单里找「应用功能」→「机器人」，把开关打开。这一步如果跳过，你的应用就不具备机器人能力，OpenClaw 的消息收发会失败。

然后走发布流程：左侧菜单找「版本管理与发布」→ 点「创建新版本」→ 填写版本号和版本说明 → 提交发布。

企业版飞书会走一个内部审批流程，管理员需要在飞书客户端里点通过；个人版飞书自动通过，通常等个几分钟刷新一下就显示已发布了。

### 第五步：测试连通性

应用发布之后，重启一下 OpenClaw 的 gateway 让配置生效：

```bash
openclaw gateway restart
```

打开飞书客户端，在顶部搜索框里搜你的机器人名称，找到之后点进去发一条消息，比如「你好」。如果机器人正常回应了，说明整个链路都通了，飞书接入完成。

如果没有响应，先跑 \`openclaw gateway status\` 确认服务在跑，再用 \`openclaw logs --follow\` 看实时日志，通常能直接看到连接飞书时报了什么错。大多数情况是 App Secret 复制的时候带了空格，或者权限还没审批通过。

## 钉钉接入教程

钉钉目前没有 OpenClaw 官方插件，官方文档里也没有钉钉的页面。用的是 GitHub 上的社区插件 \`@soimy/dingtalk\`，功能比较完整：支持私聊和群聊，底层用 Stream 模式的 WebSocket 长连接，同样不需要公网地址。

社区插件意味着官方不背书，后续 OpenClaw 大版本升级如果有破坏性变更，可能需要等插件作者跟进。这点要有预期。

### 前置条件

钉钉应用必须在某个组织下创建，纯个人账号如果没有加入任何组织，需要先在钉钉里「创建团队」，自己建一个就行，不需要拉其他人进来。如果是在公司钉钉里操作，需要管理员提前给你开发者权限。

### 第一步：安装钉钉插件

```bash
openclaw plugins install @soimy/dingtalk
```

安装完之后有一个重要步骤：把这个插件加入 OpenClaw 配置文件的 allow 列表，否则 gateway 启动时不会加载它。

打开 \`\~/.openclaw/config.json\`（Windows 上是 \`%APPDATA%\\openclaw\\config.json\`），找到或添加以下内容：

```json
{
  "plugins": {
    "enabled": true,
    "allow": ["dingtalk"]
  }
}
```

如果你已经有其他插件在 allow 列表里，把 \`"dingtalk"\` 追加进去就行，不要把整个列表覆盖掉。关于配置文件结构的更多说明，可以参考[进阶配置教程](https://tbbbk.com/openclaw-advanced-config-guide/)。

### 第二步：钉钉开放平台创建应用

浏览器打开 <https://open-dev.dingtalk.com>，扫码登录。

进入「应用开发」→「钉钉应用」→ 右上角「创建应用」，填写应用名称和描述，图标可以先跳过，保存。

进入刚创建的应用，在左侧菜单找「凭证与基础信息」，把 Client ID 和 Client Secret 复制出来，后面要填进 OpenClaw 的配置里。

### 第三步：添加机器人能力

在应用详情的左侧菜单里找「应用能力」→「机器人」→「添加」。

机器人配置里有一个关键选项：「消息接收模式」，这里一定要选 \*\*Stream 模式\*\*。Stream 模式是钉钉主动通过 WebSocket 推消息给你的服务，不需要你暴露公网回调地址；另一种 HTTP 模式需要你配置一个公网可以访问的 Webhook URL，在家或者公司内网环境下非常麻烦，不推荐。

选好 Stream 模式，保存配置，然后走发布流程把应用发布出去。个人组织基本上直接通过，公司组织需要管理员审批。

### 第四步：配置渠道

```bash
openclaw channels add
```

在交互菜单里选钉钉，依次输入 Client ID 和 Client Secret，保存。

然后重启 gateway：

```bash
openclaw gateway restart
```

重启之后 OpenClaw 会用 Stream 模式主动连上钉钉的消息推送服务，等待消息进来。

### 第五步：在钉钉里添加机器人并测试

群聊方式：进入任意一个你有管理权限的群，打开群设置，找「机器人」→「添加机器人」，在搜索框里搜你的应用名称，安装进群。然后在群里 @ 你的机器人发一条消息，看看有没有回应。

私聊方式：在钉钉底部导航找「工作台」，在里面搜索你的应用名称，找到应用之后进入应用里的对话入口。注意机器人不在通讯录里，在联系人页面搜不到，必须去工作台找。

部分版本的钉钉，机器人设置页里有一个「单聊」开关，如果这个开关没开，私聊功能就不可用，只能在群里 @ 触发。

## 常见问题

\*\*飞书发消息机器人没有反应\*\*

先确认服务状态：\`openclaw gateway status\`。然后用 \`openclaw logs --follow\` 看实时日志，日志里能直接看到连接飞书时报了什么错。常见原因有：App Secret 里有多余空格、权限还没审批通过、应用还没发布。

\*\*飞书提示「应用未发布」或者找不到机器人\*\*

应用创建完权限开通完，忘走发布流程了。回到「版本管理与发布」创建一个版本提交，企业版让管理员在飞书客户端里审批，个人版自动通过，通常几分钟就行。

\*\*钉钉插件安装后 gateway 启动看不到钉钉渠道\*\*

检查 \`\~/.openclaw/config.json\` 里的 \`plugins.allow\` 数组，确认 \`"dingtalk"\` 在里面。如果 allow 是空数组，OpenClaw 会打一条安全警告但不会自动加载非内置插件，必须手动加入。

\*\*Windows 下安装插件报错 spawn npm ENOENT\*\*

这是 Windows 环境下的已知问题。OpenClaw 在调用 npm 子进程时，在 Windows 上需要 \`shell: true\` 才能正确找到可执行文件，否则报 ENOENT。临时解法是找到 OpenClaw 安装目录下的 \`dist/process/exec.js\`，在 spawn 调用处加 \`shell: true\`：

```javascript
const child = spawn(cmd, args, { ...options, shell: true });
```

改完重新安装插件就能正常跑了。官方 issue 里已有记录，后续版本会修。

\*\*钉钉私聊机器人找不到入口\*\*

机器人不在通讯录里，在「工作台」里搜应用名称才能找到。另外，确认机器人设置页的「单聊」开关是开着的，否则私聊不可用。

## 进阶玩法

渠道接好之后，飞书和钉钉就成了 OpenClaw 的一个消息入口，所有 OpenClaw 支持的功能都可以通过这两个平台触发：查资料、写内容、运行脚本、定时提醒，直接发消息就行。

如果你在国内网络环境下用 OpenAI 或 Anthropic 等海外模型，还需要处理代理配置，[国内网络配置指南](https://tbbbk.com/openclaw-china-mainland-setup-guide/)里有完整的操作方式。

OpenClaw 还支持定时任务（cron）和心跳（heartbeat），可以让机器人主动给你推送消息，比如每天早上发一条日报、天气或者待办提醒。这些进阶配置在[进阶配置教程](https://tbbbk.com/openclaw-advanced-config-guide/)里都有，渠道接好之后可以慢慢折腾。

## 总结

飞书是官方渠道，插件稳定、配置规范、文档完整，推荐优先接。钉钉是社区插件，功能能用，但官方不维护，升级时要多留意兼容性。

两个平台的共同优点是国内直连，不需要翻墙，在工作软件里随手发一条消息就能触发 AI 干活，省的时间绝对比配置花的时间多。

遇到问题可以查 [OpenClaw 命令行使用指南](https://tbbbk.com/openclaw-cli-commands-guide/)，里面有完整的命令参考，大部分问题能从那里找到排查思路。