文章
文章用户商城文档圈子网址导航问答供求信息

Clawdbot/Openclaw一键本地部署+对接飞书/钉钉/微信/QQ/企微下指令（实操教程）

内容总结生成中
你看见的，不仅是一个总结

OpenClaw（原Clawdbot）多平台接入指南

注意：因 Clawdbot 更名为 OpenClaw，部分插件 SDK 安装失败时，需将包名替换为 Openclaw。

一、本地部署

官网与仓库

安装基础环境

1. 安装 Node.js

  • 官方下载地址：https://nodejs.org/zh-cn/
    ✅ 推荐下载 LTS 长期支持版（如 20.x 系列），稳定性强，适配开发/生产环境；
    ✅ 安装包自带 npm（包管理器），无需单独下载；
    ✅ 系统会自动识别 Windows/Mac/Linux，直接点击对应版本下载。
  • 备用链接：https://pan.quark.cn/s/9bac944201b9

2. 安装 Git

3. 安装后验证（必做）

打开命令行工具（Windows：CMD/PowerShell；Mac/Linux：终端），执行以下命令，显示版本号即安装成功：

# 验证 Node.js 和 npm
node -v
npm -v

# 验证 Git
git --version

安装 OpenClaw

npm i -g openclaw

配置 OpenClaw

初始化配置（执行后按提示操作）：

openclaw onboard

二、接入飞书

核心流程：先安装插件 → 配置 App ID/Secret → 重启 Gateway → 飞书开放平台配置长连接。

飞书开发平台地址

https://open.feishu.cn/app?lang=zh-CN

方法1：安装飞书插件

插件仓库

https://github.com/m1heng/clawdbot-feishu?tab=readme-ov-file

1. 安装插件

openclaw plugins install @m1heng-clawd/feishu

2. 升级插件

openclaw plugins update feishu

3. 配置飞书 API

openclaw config

4. 配置项说明（JSON 格式）

{
  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxxxx",
      "appSecret": "secret",
      "domain": "feishu", // 国内：feishu | 国际：lark
      "connectionMode": "websocket", // 推荐：websocket | 备选：webhook
      "dmPolicy": "pairing", // pairing | open | allowlist
      "groupPolicy": "allowlist", // open | allowlist | disabled
      "requireMention": true, // 群聊是否需要@机器人
      "mediaMaxMb": 30, // 媒体文件最大大小（MB）
      "renderMode": "auto" // auto | raw | card
    }
  }
}

5. 启动服务

openclaw gateway

6. 插件安装失败的备用方案（手动安装）

# 1. 下载插件包
curl -O https://registry.npmjs.org/@m1heng-clawd/feishu/-/feishu-0.1.3.tgz

# 2. 从本地安装
openclaw plugins install ./feishu-0.1.3.tgz

# 或指定本地包名安装
openclaw plugins install ./clawdbot-feishu-0.1.6.tar.gz

7. 重启服务

openclaw gateway restart

方法2：一键安装 / One-Click Install

OpenClaw 一键安装

复制以下内容发给你的 OpenClaw 机器人：

帮我安装飞书插件: https://github.com/AlexAnys/openclaw-feishu 
我的飞书应用配置信息如下 
App ID：xxx 
App Secret：xxx

Clawdbot 一键安装

复制以下内容发给你的 Clawdbot 机器人：

帮我安装飞书插件: https://github.com/AlexAnys/openclaw-feishu 
我的飞书应用配置信息如下 
App ID：xxx 
App Secret：xxx

手动配置

OpenClaw 手动配置

openclaw plugins install feishu-openclaw
openclaw config set channels.feishu.enabled true --json
openclaw config set channels.feishu.appId "cli_你的AppID"
openclaw config set channels.feishu.appSecret "你的AppSecret"
openclaw gateway restart

Clawdbot 手动配置

clawdbot plugins install feishu-openclaw
clawdbot config set channels.feishu.enabled true --json
clawdbot config set channels.feishu.appId "cli_你的AppID"
clawdbot config set channels.feishu.appSecret "你的AppSecret"
clawdbot gateway restart

三、接入钉钉

钉钉开发者后台

https://open-dev.dingtalk.com/

钉钉插件仓库

https://github.com/soimy/openclaw-channel-dingtalk

方法 A：通过远程仓库安装 (推荐)

openclaw plugins install https://github.com/soimy/clawdbot-channel-dingtalk.git

方法 B：通过本地源码安装（适合二次开发）

# 1. 克隆仓库
git clone https://github.com/soimy/openclaw-channel-dingtalk.git
cd openclaw-channel-dingtalk

# 2. 安装依赖 (必需)
npm install

# 3. 以链接模式安装（修改代码后实时生效）
openclaw plugins install -l .

配置步骤

  1. 创建钉钉应用
    1. 访问 钉钉开发者后台；
    2. 创建企业内部应用；
    3. 添加「机器人」能力；
    4. 配置消息接收模式为 Stream 模式；
    5. 发布应用。
  2. 配置权限管理在应用的权限管理页面，开启以下权限：
    • ✅ Card.Instance.Write — 创建和投放卡片实例
    • ✅ Card.Streaming.Write — 对卡片进行流式更新

    操作步骤：

    1. 进入应用 → 权限管理；
    2. 搜索「Card」相关权限；
    3. 勾选上述两个权限；
    4. 保存权限配置。
  3. 建立卡片模板如需使用 AI 互动卡片功能，需在钉钉卡片平台创建模板：
    1. 访问 钉钉卡片平台；
    2. 进入「我的模板」；
    3. 点击「创建模板」；
    4. 卡片模板场景选择 「AI 卡片」；
    5. 无需选择预设模板，直接点击保存；
    6. 复制模板 ID（格式如：xxxxx-xxxxx-xxxxx.schema）；
    7. 将 templateId 配置到 openclaw.json 的 cardTemplateId 字段；
    8. 或在 OpenClaw 控制台的 Channel 标签→Dingtalk 配置面板→Card Template Id 填入。

    模板配置示例：

    {
    "channels": {
      "dingtalk": {
        "messageType": "card",
        "cardTemplateId": "你复制的模板ID"
      }
    }
  }
  4. 获取凭证从开发者后台获取以下信息：
    • Client ID (AppKey)
    • Client Secret (AppSecret)
    • Robot Code (与 Client ID 相同)
    • Corp ID (企业 ID)
    • Agent ID (应用 ID)
  5. 配置 OpenClaw在 ~/.openclaw/openclaw.json 的 channels 下添加： 
    {
    "channels": {
      "dingtalk": {
        "enabled": true,
        "clientId": "dingxxxxxx",
        "clientSecret": "your-app-secret",
        "robotCode": "dingxxxxxx",
        "corpId": "dingxxxxxx",
        "agentId": "123456789",
        "dmPolicy": "open",
        "groupPolicy": "open",
        "messageType": "markdown",
        "debug": false
      }
    }
  }
  6. 重启 Gateway 
    openclaw gateway restart

四、接入企微

插件地址

https://github.com/dingxiang-me/OpenClaw-Wechat

方式一：本地路径加载

  1. 克隆仓库： 
    git clone https://github.com/anthropics/clawdbot-wecom.git
cd clawdbot-wecom
npm install
  2. 在 Clawdbot 配置文件 ~/.clawdbot/clawdbot.json 中添加插件路径： 
    {
    "plugins": {
      "enabled": true,
      "load": {
        "paths": ["/path/to/clawdbot-wecom"]
      },
      "entries": {
        "clawdbot-wecom": {
          "enabled": true
        }
      }
    }
  }

方式二：npm 安装

clawdbot plugins install @mijia-life/clawdbot-wecom

核心功能

  • 支持个人微信对话
  • 接收企业微信消息（文本、图片、语音）
  • 自动调用 AI 代理处理消息
  • 将 AI 回复发送回企业微信用户
  • 消息签名验证和 AES 加密解密
  • Webhook URL 验证（企业微信回调配置）
  • access_token 自动缓存和刷新（支持多账户）

配置步骤

第一步：创建企业微信自建应用

  1. 登录 企业微信管理后台；
  2. 进入 应用管理 → 自建 → 创建应用；
  3. 填写应用名称、Logo、可见范围等信息；
  4. 创建完成后，记录以下信息：
    • AgentId：应用的 AgentId
    • Secret：应用的 Secret

第二步：获取企业信息

  1. 在管理后台首页，点击 我的企业；
  2. 记录 企业ID (CorpId)。

第三步：配置接收消息

  1. 进入你创建的应用 → 接收消息 → 设置API接收；
  2. 填写以下信息（先不要保存，需先启动服务）：
    • URL：https://你的域名/wecom/callback
    • Token：自定义一个 Token（随机字符串）
    • EncodingAESKey：点击随机生成

第四步：配置环境变量

在 ~/.clawdbot/clawdbot.json 中添加：

{
  "env": {
    "vars": {
      "WECOM_CORP_ID": "你的企业ID",
      "WECOM_CORP_SECRET": "你的应用Secret",
      "WECOM_AGENT_ID": "你的应用AgentId",
      "WECOM_CALLBACK_TOKEN": "你设置的Token",
      "WECOM_CALLBACK_AES_KEY": "你生成的EncodingAESKey",
      "WECOM_WEBHOOK_PATH": "/wecom/callback"
    }
  }
}

多账户配置示例

{
  "env": {
    "vars": {
      "WECOM_CORP_ID": "默认账户企业ID",
      "WECOM_CORP_SECRET": "默认账户Secret",
      "WECOM_AGENT_ID": "默认账户AgentId",
      "WECOM_CALLBACK_TOKEN": "默认账户Token",
      "WECOM_CALLBACK_AES_KEY": "默认账户AESKey",
      "WECOM_SALES_CORP_ID": "销售账户企业ID",
      "WECOM_SALES_CORP_SECRET": "销售账户Secret",
      "WECOM_SALES_AGENT_ID": "销售账户AgentId",
      "WECOM_SALES_CALLBACK_TOKEN": "销售账户Token",
      "WECOM_SALES_CALLBACK_AES_KEY": "销售账户AESKey"
    }
  }
}

第五步：配置公网访问（Cloudflare Tunnel 示例）

# 安装 cloudflared
brew install cloudflared

# 创建隧道
cloudflared tunnel create clawdbot

# 配置隧道路由
cloudflared tunnel route dns clawdbot 你的域名

# 启动隧道
cloudflared tunnel run clawdbot

第六步：启动并验证

  1. 重启 Clawdbot Gateway： 
    openclaw gateway restart
  2. 检查插件是否加载： 
    openclaw plugins list
  3. 手动安装插件（备用方案）： 
    openclaw plugins install ./OpenClaw-Wechat-0.3.2.tar.gz

热门话题

本地部署后如何保障API安全？
飞书机器人如何实现长连接？
OpenClaw多平台接入难在哪？
声明：本站所有文章，如无特殊说明或标注，均为本站原创发布或转载收集发布，发布内容都是作者本人发布，与本站无关。任何个人或组织，在未征得本站同意时，禁止复制、盗用、采集、发布本站内容到任何网站、书籍等各类媒体平台。如若本站内容侵犯了原著者的合法权益，可联系我们进行处理。

给TA打赏
共{{data.count}}人
人已打赏
AIOpenClaw
13 条回复 A文章作者 M管理员
  2. 象小稳

    这配置步骤也太细了，照着做居然一次跑起来了👍

  3. 浅唱流年

    飞书那个插件装了好几次都报错，有人遇到过吗？

  4. 绮梦

    之前搞过类似机器人对接，企微的签名验证真的坑😭

  5. GalacticWanderer

    手动装插件那步能不能给个具体路径例子？

  6. 绣帘垂

    感觉钉钉的stream模式文档写得不清不楚🤔

  7. 梅雪仙

    企微那个回调配置有点绕，得仔细看。

  8. 贪睡的爆米花

    国内用feishu还是lark啊？配错了连不上

  9. 金牛牧野

    我按教程装完openclaw gateway直接崩了…啥情况

  10. 竹蜻蜓飞手

    吃瓜看大佬折腾多平台接入，我就问问能接Telegram不？

  11. TwilightVoyager

    mediaMaxMb设30是不是太大了？公司网络扛不住吧

❯

解锁会员权限

开通会员

解锁海量优质VIP资源

立刻开通
个人中心
购物车
优惠劵
今日签到
有新私信 私信列表
搜索
客服

  • 扫码打开当前页

  • 官方群聊

  • 关注公众号

返回顶部