OpenClaw 统一接入飞书钉钉 WhatsApp 打造 AI 指挥中心

3. 配置中的 encrypt_key 可选，如果启用了加密，必须填写，否则 OpenClaw 无法解析推送的消息。

步骤 3：配置事件订阅并上线

1. 在飞书开发者后台的'事件订阅'页面，配置请求地址。
   • http://<你的 OpenClaw 公网 IP 或域名>:18789/feishu/webhook (确保端口开放，路径与配置文件中的 endpoint 一致)。
2. 添加事件：搜索并添加 接收消息（私聊） 和 接收群聊中@机器人消息 事件。
3. 在'权限管理'中，添加机器人所需的权限，至少包括：获取单聊、群组消息 和 获取与发送单聊、群组消息。
4. 最后，在'版本管理与发布'中创建一个版本并申请线上发布。

步骤 4：测试

在飞书中搜索你的机器人并开启对话，发送指令：'帮我查今日待办'。

流程说明：用户发送消息 -> IM 平台推送 Webhook -> OpenClaw 校验 Token 并解析消息 -> Agent 执行'查待办'任务 -> 调用 API 发送回复内容 -> 展示回复结果。

注意事项（飞书篇）

• API 限额：飞书对应用调用 API 有频率限制。如果你的 AI 需要处理大量群消息，务必在 OpenClaw 中配置 消息队列 或 限流器，避免触发限流导致服务被短时封禁。
• 消息加密：强烈建议在'事件订阅'中配置 Encrypt Key。这能确保消息在传输过程中的安全性，OpenClaw 会自动对其进行解密处理。
• 权限范围：权限申请遵循'最小够用'原则。如果只是做私人助手，没必要申请'通讯录全量读取'这类高敏感权限。

4. WhatsApp 集成实战（基于 Twilio）：连接全球

对于海外用户或需要与国外设备通信的场景，WhatsApp 是最佳选择。由于 WhatsApp 官方对个人 API 的限制，我们通常使用 Twilio 作为桥梁。

步骤 1：Twilio 账号申请与环境准备

1. 访问 Twilio 官网 注册账号，并完成电话验证。
2. 在 Twilio Console 中，找到 Account Info，记下 ACCOUNT SID 和 AUTH TOKEN，这是 OpenClaw 调用 Twilio API 的凭证。

步骤 2：激活 WhatsApp Sandbox

1. 在 Twilio Console 中，导航至 Messaging -> Try it Out -> Send a WhatsApp Message。
2. 同意条款，进入 Sandbox 配置页。你会看到一个 Sandbox 号码和一个加入代码（例如 join angle-wrist）。
3. 用你的 WhatsApp 手机发送这个加入代码到 Sandbox 号码，这样你的手机号就加入了 Sandbox，可以互相通信了。

步骤 3：OpenClaw 配置 Twilio Channel

OpenClaw 原生支持 Twilio 通道。你需要配置环境变量或直接在配置文件中指定：

# 在启动 OpenClaw 的环境变量中添加
export TWILIO_ACCOUNT_SID=你的_ACCOUNT_SID
export TWILIO_AUTH_TOKEN=你的_AUTH_TOKEN
export TWILIO_WHATSAPP_NUMBER=whatsapp:+14155238886 # Twilio 提供的 Sandbox 号码

或者，通过 OpenClaw 的交互式命令进行配置：

openclaw channels login # 根据提示选择 WhatsApp (Twilio) 并输入凭证

步骤 4：配置 Webhook 地址（重要！）

为了让 Twilio 把收到的消息转发给 OpenClaw，你需要在 Twilio Console 的 Sandbox 配置中，设置 When a message comes in 的 Webhook 地址为： http://<你的 OpenClaw 公网 IP>:18789/api/twilio/whatsapp （具体路径可能因 OpenClaw 版本而异，请参考官方文档）

步骤 5：测试

配置完成后，用你的手机 WhatsApp 向 Sandbox 号码发送任意消息，OpenClaw 应该能回复你。

沙箱限制与生产环境：

• 沙箱限制：Sandbox 仅供测试，3 天不活跃需重新加入；只能给已加入 Sandbox 的号码发消息。
• 生产环境：如需正式使用，需在 Twilio 上申请生产凭证，通过 Meta（Facebook）的审核，并购买专门的 WhatsApp Business 号码。

5. 钉钉集成：核心步骤与差异点

钉钉的集成逻辑与飞书类似，但在安全策略上更为严格。

核心配置步骤

1. 创建应用：在 钉钉开放平台 后台，创建'企业内部开发'应用，并启用机器人能力。
2. 获取凭证：记录下应用的 AppKey 和 AppSecret。
3. 配置 OpenClaw：在 ~/.openclaw/config/dingtalk.json 中配置凭证。
4. 关键差异点 - 加签：钉钉机器人在配置消息接收地址时，通常要求进行加签。OpenClaw 会自动处理加签逻辑，但你需要在开发者后台开启加签选项，并保存好 加密密钥 配置到 OpenClaw。
5. 关键差异点 - 服务器出口 IP：钉钉要求配置'服务器出口 IP'，即你的 OpenClaw 服务器访问公网的 IP。需要将此 IP 填写到开发者后台的'开发管理'中，钉钉只会向这个 IP 范围内的服务器推送消息。
6. 事件订阅：在'事件与回调'中，注册'企业内部机器人消息'事件。

6. 多 IM 统一管理：不再手忙脚乱

当飞书、钉钉、WhatsApp 都接入后，OpenClaw 的强大之处才真正显现：统一路由，分别执行。

消息路由规则

你可以在 OpenClaw 的全局配置文件 ~/.openclaw/openclaw.json 中定义复杂的路由策略：

{"agents":{"work_agent":{"model":"claude-3-opus","skills":["日程管理","邮件"]},"ops_agent":{"model":"gpt-4","skills":["服务器命令","日志分析"]},"chat_agent":{"model":"llama3-70b","skills":["闲聊"]}},"channels":{"feishu":{"routeRules":[{"sender_contains":"@company.com","to_agent":"work_agent"},{"message_contains":["服务器","宕机"],"to_agent":"ops_agent"}]},"whatsapp":{"routeRules":[{"from":"+8613912345678","to_agent":"ops_agent"},{"*":"chat_agent"}]}}}

额度监控与优化

多渠道调用意味着 API 消耗激增。OpenClaw 内置了健康检查与额度监控机制。

• refreshGatewayHealthSnapshot 定时任务：这个后台任务会定期（如每小时）检查各个通道的连接状态以及关联大模型 API 的剩余配额。
• 告警：当检测到某个 IM 通道掉线（如 WhatsApp 长连接断开）或 API Key 即将耗尽时，OpenClaw 可以通过你指定的渠道（如飞书）向你发送告警消息，让你能及时处理。

7. 实战案例：通过 WhatsApp 远程触发'服务器日志分析'

场景：你正在外出途中，产品经理反馈线上服务有异常。你需要立刻分析服务器的最新日志。

操作流程：

1. 掏出手机，打开 WhatsApp，找到你的 OpenClaw 机器人对话框。
2. 发送指令：/ops 分析最新错误日志。
3. 背后发生了什么：
   • Twilio 收到消息，通过 Webhook 推送给 OpenClaw。
   • OpenClaw 根据配置识别发送者是你，并将消息路由给 ops_agent。
   • ops_agent 调用预设的'服务器日志分析'技能。该技能通过 SSH 连接到你的服务器，执行 tail -n 100 /var/log/nginx/error.log | grep -i error 命令。
   • 命令结果返回给 OpenClaw。
   • OpenClaw 将分析结果格式化，通过 Twilio API 回复到你的 WhatsApp。
4. 收到回复：手机上立刻看到最新的错误日志条目，你可以迅速做出判断并指导在线同事处理。

价值：整个过程不到 1 分钟，无需找电脑、连 VPN、敲复杂命令，实现了真正的移动运维。