阿里云服务器 / 云服务器教程

2026年阿里云一键部署OpenClaw(Clawdbot)成功，怎么接入QQ、钉钉、微信、飞书

阿里云服务器

恭喜您成功通过阿里云一键部署了 OpenClaw！现在您的机器人“身体”已经准备好了，接下来需要为它接通“手脚”（即对接各大通讯平台）。

OpenClaw 的核心优势在于多平台适配。接入不同平台的逻辑大同小异：在平台后台配置回调地址 -> 在 OpenClaw 配置文件填入凭证 -> 重启服务。

以下是针对 钉钉、飞书、企业微信、QQ 的详细接入教程（2026 版）：

🛠️ 前置准备：通用步骤

在开始之前，请确保您知道以下信息：

  1. 服务器公网 IP：在阿里云 ECS/轻量服务器控制台查看（例如 47.100.xx.xx）。

  2. 监听端口：默认通常是 8080（如果您在部署时修改过，请以实际为准）。

  3. 配置文件位置：

    • 如果是 Docker 部署：通常在挂载的 .env 文件或 docker-compose.yml 中。

    • 如果是直接运行：通常在 /opt/openclaw/.env 或 config.yaml。

  4. 防火墙设置：确保阿里云安全组已放行您使用的端口（如 8080）。

1. 📌 接入钉钉 (DingTalk) - 最成熟稳定

适用场景：企业内部通知、客服机器人、办公自动化。

第一步：钉钉开放平台配置

  1. 登录 钉钉开放平台。

  2. 点击 “创建应用” -> 选择 “企业内部开发” -> “H5 微应用” 或 “机器人”。

  3. 获取凭证：

    • 在“凭证与基础信息”页，复制 AppKey 和 AppSecret。

  4. 配置事件订阅：

    • 注意：路径 /dingtalk/callback 是 OpenClaw 默认的，如有变动请查阅您的版本文档。

    • 进入 “事件订阅” 菜单。

    • 回调地址：填写 http://<您的公网IP>:8080/dingtalk/callback

    • 加密密钥：随机生成一串字符，复制保存（稍后要填）。

    • 勾选需要的事件（如：收到消息、群机器人消息等）。

    • 点击 “保存”。如果提示验证失败，请确保服务器已启动且防火墙已开。

第二步：OpenClaw 配置

编辑 .env 文件：

# 启用钉钉
ENABLE_DINGTALK=true

# 填入凭证
DINGTALK_APP_KEY=您的AppKey
DINGTALK_APP_SECRET=您的AppSecret
DINGTALK_ENCRYPT_KEY=刚才生成的加密密钥

# 端口保持一致
PORT=8080

第三步：重启并测试

# Docker 方式
docker compose restart

# 或直接运行方式
systemctl restart openclaw

去钉钉群里 @机器人 测试，回复即成功。

2. ✈️ 接入飞书 (Feishu/Lark) - 体验最佳

适用场景：现代化协作、卡片消息、丰富的交互组件。

第一步：飞书开放平台配置

  1. 登录 飞书开放平台。

  2. 点击 “创建应用” -> 选择 “自建应用”。

  3. 获取凭证：

    • 在“凭证与基础信息”页，复制 App ID 和 App Secret。

  4. 配置事件订阅：

    • 进入 “事件订阅” 菜单。

    • 请求地址：填写 http://<您的公网IP>:8080/feishu/callback

    • 点击 “完成” 进行验证。

    • 搜索并添加事件：接收消息 (im.message)。

    • 点击 “发布” 更改（必须发布才生效）。

第二步：OpenClaw 配置

编辑 .env 文件：

# 启用飞书
ENABLE_FEISHU=true

# 填入凭证
FEISHU_APP_ID=您的AppID
FEISHU_APP_SECRET=您的AppSecret

# 飞书通常不需要加密密钥，除非您手动开启了加密

第三步：重启并测试

重启服务后，在飞书群里 @机器人 测试。

3. 💼 接入企业微信 (WeCom) - 微信生态

适用场景：连接微信用户、企业内部沟通。

第一步：企业微信后台配置

  1. 登录 企业微信管理后台。

  2. 进入 “应用管理” -> “创建应用”。

  3. 获取凭证：

    • 复制 AgentId (应用ID), Secret, 以及页面顶部的 CorpId (企业 ID)。

  4. 配置接收消息服务器：

    • 在应用详情页找到 “接收消息” 设置。

    • URL: http://<您的公网IP>:8080/wecom/callback

    • Token: 自定义一个字符串（如 openclaw_token）。

    • EncodingAESKey: 点击随机生成，复制保存。

    • 点击 “保存” 验证。

第二步：OpenClaw 配置

编辑 .env 文件：

# 启用企业微信
ENABLE_WECOM=true

# 填入凭证
WECOM_CORP_ID=您的CorpId
WECOM_AGENT_ID=您的AgentId
WECOM_SECRET=您的Secret
WECOM_TOKEN=您自定义的Token
WECOM_AES_KEY=生成的EncodingAESKey

第三步：重启并测试

重启服务，在企业微信应用中发送消息测试。

4. 🐧 接入 QQ (个人/群) - 最具挑战

注意：腾讯官方对个人号/群机器人的支持非常严格，通常没有公开的 HTTP 回调接口。OpenClaw 接入 QQ 通常有以下两种方案：

方案 A：使用 OneBot 协议 (推荐，需额外部署)

这是目前最主流的 QQ 机器人方案。您需要额外运行一个 OneBot 适配器 (如 Lagrange.Core, Nakuru, 或 Go-CQHTTP 的继任者)。

  1. 部署 OneBot 适配器：

    • 在服务器上再运行一个 Docker 容器（例如 Lagrange.OneBot）。

    • 登录您的 QQ 号（扫码）。

    • 配置适配器的 WebSocket 服务端 地址（例如 ws://0.0.0.0:8081）。

  2. OpenClaw 配置：

    • OpenClaw 需要开启 OneBot 适配器 支持。

    • 在 .env 中配置：

      ENABLE_ONEBOT=true
ONEBOT_WS_URL=ws://127.0.0.1:8081/ws
# 或者作为服务端等待适配器连接
ONEBOT_SERVER_PORT=8082

  3. 连接：确保 OneBot 适配器能连接到 OpenClaw，或者 OpenClaw 能连上适配器。

方案 B：官方 QQ 机器人 (仅限企业/组织)

如果您有企业认证，可以申请腾讯官方的 QQ 机器人接口，流程类似钉钉（申请 AppID, 配置回调），但门槛极高，个人开发者很难通过。

*建议个人用户优先选择 方案 A (OneBot)，虽然配置稍复杂，但功能最强大。*

🔍 常见问题排查 (Troubleshooting)

问题可能原因解决方案
回调验证失败网络不通或路径错误1. 检查阿里云安全组是否放行端口。
2. 检查 URL 路径是否与 OpenClaw 代码一致（如 /dingtalk vs /callback）。
3. 确保服务器能公网访问（不要用内网 IP）。
收不到消息事件未勾选或未发布1. 钉钉/飞书后台确认已勾选“接收消息”事件。
2. 飞书应用必须点击 “发布” 版本才生效。
回复乱码/报错加密密钥不匹配检查 .env 中的 EncryptKey 或 AESKey 是否与平台后台完全一致（注意不要多空格）。
QQ 连不上协议失效或被封QQ 个人协议风险较高，建议使用小号测试；或改用企业微信。
多平台冲突端口占用确保所有平台共用一个 Web 服务端口（如 8080），通过不同 URL 路径区分（OpenClaw 会自动处理路由）。

🚀 进阶技巧：同时开启多个平台

OpenClaw 支持多端同开。您只需要在 .env 文件中将多个 ENABLE_XXX 设为 true，并填入对应的凭证即可。

ENABLE_DINGTALK=true
ENABLE_FEISHU=true
ENABLE_WECOM=true
# 它们会监听同一个端口，自动根据请求路径分发任务

配置完成后，重启服务，您的机器人就成为了一个全平台通用的 AI 助手！