全部产品
Search

搜索本产品

    轻量应用服务器：OpenClaw集成WhatsApp

    文档中心

    轻量应用服务器：OpenClaw集成WhatsApp

    更新时间：Apr 13, 2026

    本文介绍将 OpenClaw服务与WhatsApp集成，实现在WhatsApp中通过自然语言直接与OpenClaw交互。

    环境准备

    配置消息渠道前，需参考以下步骤或部署OpenClaw镜像文档购买并配置OpenClaw应用镜像的轻量应用服务器，若已完成可跳过此步骤。

    购买并配置OpenClaw应用镜像的轻量应用服务器

    步骤一、购买OpenClaw套餐

    重要

    如果已购买轻量应用服务器，可以跳过此步骤，以重置系统的方式部署OpenClaw（重置系统时选择应用镜像下的OpenClaw镜像），但重置系统会清除轻量应用服务器上的系统盘数据，请根据需要做好数据备份。具体操作，请参见重置系统。

    1. 购买预装OpenClaw应用的轻量应用服务器。

    2. 在轻量应用服务器页面，预置了资源配置，如要更改配置项，请参考下面内容。

      • 实例：内存必须2GiB及以上，可以根据自己的需求切换套餐。

      • 地域：默认美国（弗吉尼亚）。

        重要

        中国内地地域的服务器无法配置WhatsApp， Telegram，Discord，Slack等海外IM应用。

      • 购买配置：默认12个月，可以根据自己的需求切换时长。

    步骤二、配置OpenClaw

    1. 在轻量应用服务器-控制台，单击服务器卡片中的实例ID，在服务器概览页面单击应用详情页签。

    2. 在OpenClaw使用步骤区域中，单击端口放通下的执行命令，可开放获取OpenClaw服务运行端口的防火墙。

      重要

    3. 单击配置OpenClaw下的执行命令配置百炼API key。

      目前支持配置两种类型的百炼API Key：

      • Coding Plan 套餐专属 API Key（推荐）：采用固定月费模式，提供月度请求额度，超出时段限额的调用会报错且不计费用，可避免产生超出预期的费用。

        Coding Plan 目前支持 qwen3.5-plus、kimi-k2.5、MiniMax-M2.5、glm-5等模型，详细的模型列表请参考Coding Plan概述。

      • 按Token用量计费的百炼API Key。

      API Key配置方式包括系统推荐及手动输入。系统推荐会列出百炼Coding Plan的API Key（成本可控），及离服务器最近的百炼模型服务的API Key（时延较低）。若需使用其他地域或者其他账号的API Key可选择手动输入。

      • 系统推荐（下拉选择）

        选择完成后单击下一步。

        轻量应用服务器所在地域

        系统推荐的百炼API Key对应地域

        Coding Plan的API key对应地域

        美国及欧洲地域

        美国（弗吉尼亚）

        新加坡

        中国香港及其他亚洲地域

        新加坡

      • 手动输入

        单击按钮切换至手动输入，输入百炼API Key并选择该API Key对应地域，单击下一步。image

        重要

        手动配置需确保选择的API Key对应地域正确，否则会导致模型无法正常调用。

    4. 单击访问Web UI面板下的获取地址，获取OpenClaw WebUI的地址，可以在Web页面与OpenClaw的Agent对话。

      可根据需求参考关闭OpenClaw WebUI的公网访问一键关闭WebUI的公网访问权限。

    5. （可选）查看Token。

      在应用详情 > 基础配置 > 查看Token中单击查看，查看并保存Token。

      警告

      请勿泄露包含 Token 的完整 URL。该链接包含身份验证凭据，任何持有此链接的人都能直接绕过登录验证，获得 OpenClaw 控制台的管理员权限。

    集成WhatsApp

    1. 在OpenClaw向导中配置WhatsApp

    1. 访问轻量应用服务器控制台-服务器。

    2. 在服务器卡片中，单击远程连接。

      image

    3. 在弹出的远程连接对话框中，选择Workbench一键连接，单击立即登录。

      image

    4. 成功登录服务器后，输入如下命令，回车执行命令。

      说明

      接下来需要通过键盘来完成后续配置动作，可以通过键盘方向键控制选项，回车表示选择并确认。

      openclaw onboard

    5. 运行上面的命令后，将会出现一个确认选项：是否知晓风险，选择Yes继续后续步骤。

      image

    6. 配置Onboarding模式，选择QuickStart。

      image

    7. 配置Config handling，选择Use existing values。

      image

    8. 配置Model/auth provider，选择Skip for now -> All providers -> Keep current。

      说明

      如果前面步骤中已完成百炼API key配置，可以按照教程跳过此步骤。如果尚未进行模型配置，需要在此步通过命令行配置模型API Key。

      imageimageimage

    9. 接下来进入Select channel步骤，选择WhatsApp (QR link) -> Yes。

      imageimage

    10. 用手机 WhatsApp 扫描二维码。

      重要

      二维码可能会变形，如果无法扫描，建议调高屏幕亮度，调整页面尺寸再尝试。

      image

    11. 选择手机号码设置

      使用自己的WhatsApp账号

      1. 选择This is my personal phone number。

        image

      2. 输入手机号

        image

      为OpenClaw准备了独立账号

      1. 选择Separate phone just for OpenClaw。

        image

      2. WhatsApp DM policy设置，默认选择第一个Pairing (recommended)即可。

        image

      3. WhatsApp allowFrom设置，默认选择第一个Unset allowFrom (default)即可。

        image

    12. 配置Skills，此处建议选择No，对于初次部署，限制权限可以提升稳定性和安全性。

      image

    13. 启用 Hooks（若未出现此步骤，请忽略），推荐选择session-memory。

      image

    14. 选择Restart重启使配置生效。

      image

    15. 安装命令补全功能（若未出现此步骤，请忽略），推荐选择No。

      重要

      此处如果选择Yes，后续OpenClaw运行的时候容易导致服务器CPU负载高，使得OpenClaw运行出现问题。

    16. 完成以上步骤之后，系统将自动完成部署，待配置向导自动退出，返回命令行界面即为部署成功。

    2. 测试机器人

    使用自己的WhatsApp账号

    1. 在WhatsApp中选择“给自己发消息”。

      image

    2. 首次对话，WhatsApp会发送一个配对码，需要在服务器中执行下方的命令完成配对。

    3. 远程连接轻量应用服务器后，输入并执行以下命令。

      重要

      需要将命令中的<code>替换为您在WhatsApp中收到的Pairing code，输入时不加<>符号。

      openclaw pairing approve whatsapp <code>

    4. 成功完成OpenClaw接入WhatsApp。

      image

    为OpenClaw准备了独立账号

    1. 在WhatsApp中添加这个账号为好友，并发送消息。

    2. 首次对话，WhatsApp会发送一个配对码，需要在服务器中执行下方的命令完成配对。

    3. 远程连接轻量应用服务器后，输入并执行以下命令。

      重要

      需要将命令中的<code>替换为您在WhatsApp中收到的Pairing code，输入时不加<>符号。

      openclaw pairing approve whatsapp <code>

    4. 成功完成OpenClaw接入WhatsApp。

      image

    常见问题

    选择WhatsApp (QR link)后不出现二维码。

    如果选择WhatsApp (QR link)后，安装向导直接退出回到命令行界面，是由于dingtalk插件和Whatsapp有冲突导致的。

    解决方法：

    1. 执行命令卸载dingtalk插件。

      openclaw plugins uninstall dingtalk

    2. 重启服务器。

    3. 重新运行openclaw onboard。