前置准备工作

在您正式开始为OpenClaw（Clawdbot）配置企业微信前，请依次检查如下事项是否准备完成：

• 是否已经准备好了一个拥有管理员权限的企业微信企业。如尚未拥有满足条件的企业，可以参考 创建&注册企业 来创建一个新企业，以此来体验OpenClaw 的能力。

注意：
如果您的企业微信已经进行了企业认证，那么在后续配置URL时，必须要配置已经完成备案且备案主体和认证企业一致的域名。

如果您的企业微信尚未进行企业认证，那么可以在后续配置URL时，可先使用由Lighthouse公网IP地址组成的链接来进行测试。

• 是否已经在 Lighthouse服务器实例 部署且配置好了OpenClaw，且 为2026.1.30或更高版本 。如果暂时还没有，建议：

  • 如果您希望新购一台 Lighthouse 服务器来安装运行OpenClaw，可以前往腾讯云Lighthouse产品的 购买页 选购，或者前往腾讯云 OpenClaw专属活动 进行优惠下单。

  • 如果已有之前部署的OpenClaw，但不是最新版本的应用模板，可以参考教程进行版本更新： 如何更新服务器OpenClaw应用版本 。

接入企业微信

注意：本文目前针对从零开始配置聊天软件的情景。

新建一个企业微信机器人

前往 企业微信官网 ，使用有企业管理员权限的账号登录。如尚未拥有满足条件的企业，可以参考 创建&注册企业 来创建一个新企业，以此来体验OpenClaw（Clawdbot）的能力。

在企业微信管理后台左侧导航依次找到并进入 安全与管理 > 管理工具 ，并且在页面内点击 创建机器人 。

滑到页面最底端，点击 API模式创建 按钮。

在切换后的页面，依次填写名称、简介、可见范围、 URL ，并且点击 随机获取 按钮生成 Token 和 Encoding-AESKey （这是企业微信与OpenClaw进行加密通信的密钥）。注意此处先不用点击创建按钮。

注意：
如果你的企业微信已经进行了企业认证，那么在后续配置URL时，必须要配置已经完成备案且备案主体和认证企业一致的域名。备案主体查询方式可参考接入 企业微信提示“域名主体校验未通过”怎么办 。

如果你的企业微信尚未进行企业认证，那么可以在后续配置URL时，可先使用由Lighthouse公网IP地址组成的链接来进行测试。

方式一：URL配置为公网IP地址

此处我们以测试场景配置由Lighthouse公网IP地址组成的链接为例。需要关注，URL处提及的“Lighthouse实例IP地址”，可以把如下内容中的“Lighthouse实例公网IP地址”替换为如下图所示位置的内容：

将复制好的公网IP地址（一串类似12.12.12.12的数字），替换到下面内容中：

      
        http://Lighthouse实例公网IP地址:18789/wecom                                  
      
    

示例：
比如你部署的OpenClaw服务器公网IP地址是12.12.12.12，则可以在企业微信机器人的URL处填入： http://12.12.12.12:18789/wecom

方式二：URL配置为已备案的域名

如果你已经拥有一个满足企业微信要求的域名（已经完成备案且备案主体和认证企业一致），假设你的域名已经解析到部署了OpenClaw的实例公网IP，那么可以参考如下方式进行配置：

说明：
这里所说的“域名”，可以是已经备案的主域名（比如：jiayu.com）或这个已备案域名的子域名（比如：www.jiayu.com或abc.jiayu.com）。

在 URL 处填入 http://你的域名:18789/wecom，切记一定要带端口（默认为18789）。

说明：
如果你在填写URL时提示“域名主体校验未通过”，可参考 教程：企业微信提示“域名主体校验未通过”怎么办 进行排查与操作。

注意： URL填写完成，获取Token、Encoding-AESKey后， 先不要点创建 ，而是需要先前往登录Lighthouse服务器控制台后的页面，参考接下来的“模型和Channel”步骤进行操作，完成后再返回企业微信机器人配置页面点击创建。

为OpenClaw配置模型和Channel

接下来需要为已经完成部署的OpenClaw配置模型和Channel（如企业微信，即WeCom）。

注意：
如果你目前尚未使用最新版本的应用模板，那么可以参考 云上OpenClaw(原Clawdbot)一键秒级部署指南 中重装Lighthouse实例的部分，先将应用模板更新至最新版。

进入腾讯云 控制台 ，选中对应的OpenClaw服务器，点击实例卡片任意空白位置即可进入“管理实例”页面。

进入“应用管理”页签，可以看到如下所示的界面：

模型配置

为OpenClaw配置模型API Key可以在Lighthouse服务器的应用管理页面进行操作。详情可参考 云上OpenClaw(原Clawdbot)一键秒级部署指南 -配置模型的API Key，此处不再赘述。

Channel配置（配置企业微信机器人Token和EncodingAESKey）

提示：OpenClaw支持同一台服务器配置多个Channel，例如支持同时接入QQ机器人和飞书机器人。因此，如果当前正在配置的服务器之前已经接入了其他Channel，也可以继续添加更加Channel。

在Channel配置中，选择企业微信，然后依次在输入框内输入前文创建企业微信机器人时随机生成的 Token 和 EncodingAESKey ：

填写完成后，点击面板内的 应用 按钮，并在弹出的弹框中单击确定，稍等片刻，出现保存成功的提示后，即完成配置。

“ 提示：点击“应用”按钮完成Channel配置之后，部分老版本的Lighthouse服务器应用管理页面中不会展示已经配置的Channel。

完成企业微信机器人配置

此时我们再回到企业微信机器人创建页，点击 创建 按钮。

创建成功后，在接下来的页面中找到企业微信机器人的二维码，用手机扫码后添加。

添加完成后，无需配对即可在聊天窗中与机器人进行对话。

更多常用操作

远程登录服务器

“ 推荐您使用腾讯云默认的OrcaTerm远程终端来登录服务器，您也可以使用第三方软件（如Xterminal、iTerm等）来登录。

您可以使用腾讯云OrcaTerm远程终端登录服务器，并且在服务器的Linux操作系统中对OpenClaw执行各项更高阶的配置。

首先，前往轻量云 Lighthouse控制台 即可查看刚刚选购或重装完成的OpenClaw实例，点击页面内的 登录 按钮：

点击 登录 后，在腾讯云远程终端（OrcaTerm）的页面内，选择 免密连接 ，点击 登录 即可：

通过远程终端OrcaTerm登录服务器成功之后的界面如下所示：

设置后台运行OpenClaw（可选）

“ 如果您使用的Lighthouse应用模板为2026.1.29及更高版本，服务器创建之后，OpenClaw默认会保持在后台运行，无需执行以下操作。

为了避免关掉服务器远程终端（OrcaTerm）之后就无法与bot对话，可以参考以下教程实现让OpenClaw保持在后台持续运行。

问题的原因是因为前面步骤中运行的命令，都只是“临时运行”，所以这里我们需要在前置的配置完成后，让OpenClaw（Clawdbot）运行在后台，这样的话我们关掉服务器命令行页面（OrcaTerm）后就不会和它失去联系了。

首先在远程终端（OrcaTerm）中，操作键盘按下 Ctrl+C （Linux系统），终止前文运行的命令，回到类似如下图所示的状态：

依次向命令行内粘贴并运行以下命令：

      
        loginctl enable-linger $(whoami) && export XDG_RUNTIME_DIR=/run/user/$(id -u)                                  
      
    

这一步运行完之后不会有任何返回，这是正常的：

继续往下，运行下一步的指令：

      
        clawdbot daemon install                                  
      
    

运行完成之后的效果如下：

接着往下：

      
        clawdbot daemon start                                  
      
    

最后一步：

      
        clawdbot daemon status                                  
      
    

如果运行完这个脚本出现如下效果，则说明配置已经成功：

之后你就可以放心关掉服务器命令行（OrcaTerm）页面，尽情享受和OpenClaw的交流了。

常见报错及解决方法