如何将OpenClaw部署到本地并配置企业微信？

将 OpenClaw 部署在本地并接入企业微信，核心思路是：在本地运行 OpenClaw，并通过内网穿透工具将服务暴露给公网，使企业微信服务器能访问到它。以下是基于 OpenClaw 2026 版本，在 Windows / macOS / Linux 上的通用部署方案。

泉城IT圈子 · 2026-03-07 10:00:23 发布

将 OpenClaw 部署在本地并接入企业微信，核心思路是：在本地运行 OpenClaw，并通过内网穿透工具将服务暴露给公网，使企业微信服务器能访问到它。

以下是基于 OpenClaw 2026 版本，在 Windows / macOS / Linux 上的通用部署方案。

环境要求
- 操作系统：Windows 10+ (推荐 WSL2)、macOS 13+、Linux (Ubuntu 22.04+)。
- Node.js：版本 ≥ 20 (部分安装脚本会自动安装)。
- 内网穿透工具：如 cloudflared、ngrok或 frp。
账号与凭证
- 企业微信：一个已认证的企业，并拥有管理员权限。
- 大模型 API Key：用于提供 AI 能力，如阿里云百炼、移动云一站式模型服务等。

此方法适用于 macOS 和 Linux，Windows 用户推荐在 WSL2 中操作。

执行安装

在终端中运行以下命令，按提示操作即可：

bash

curl -fsSL https://openclaw.ai/install.sh| bash
- 提示风险时，输入 Yes。
- 新手引导模式可选择 QuickStart。
- 模型提供商可先 Skip for now，后续在 Web 控制台配置。
启动服务

安装完成后，启动 OpenClaw 网关：

bash

openclaw gateway start

服务默认监听 http://127.0.0.1:18789。
访问 Web 控制台

执行命令生成管理员 Token 并访问 Web 控制台：

bash

openclaw token generate --admin

然后在浏览器中打开 http://127.0.0.1:18789/?token=你的管理员Token，确认服务正常运行。

克隆仓库

bash

git clone https://github.com/openclaw/openclaw.git

cd openclaw
安装依赖并启动

bash

npm install

npm run start

服务启动后，访问 http://127.0.0.1:18789进行测试。

企业微信的回调地址必须是公网可访问的。这里以 cloudflared为例进行演示。

安装 cloudflared

bash

npm install -g cloudflared
启动隧道

将本地 18789端口映射到公网：

bash

cloudflared tunnel --url http://127.0.0.1:18789

运行后会生成一个类似 https://xxxx.trycloudflare.com的公网 HTTPS 地址，请复制备用。

备选方案：你也可以使用 ngrok或 frp。核心是将本地 18789端口通过 TCP 或 HTTP 方式暴露出去。

创建应用

登录企业微信管理后台 → 应用管理 → 自建应用 → 创建应用。填写名称（如“AI 助手”）、上传头像并设置可见范围。
获取凭证

在应用详情页，记录以下三个关键信息：
- CorpID (企业 ID)
- AgentID (应用 ID)
- Secret (应用密钥)
设置回调

进入应用详情 → 接收消息 → 设置 API 接收。
- URL：https://xxxx.trycloudflare.com/wecom/app
  - 注意：/wecom/app是 OpenClaw 企业微信自建应用通道的默认路径，需与 OpenClaw 配置保持一致。
- 点击“随机获取” Token 和 EncodingAESKey，并保存。先不要点击“保存”按钮。

创建机器人

登录企业微信管理后台 → 安全与管理 → 管理工具 → 智能机器人 → 创建机器人 → API 模式创建。
获取凭证

填写机器人名称、简介和可见范围。点击“随机获取” Token 和 EncodingAESKey，并保存。同样先不要点击“创建”。
设置回调
- URL：https://xxxx.trycloudflare.com/wecom
  - 注意：智能机器人通常使用 /wecom路径。
- 填入 Token 和 EncodingAESKey 后，先保存 OpenClaw 配置，再回到此页面点击“创建”。

安装插件

执行命令安装企业微信通道插件：

bash

openclaw plugins install openclaw-plugin-wecom
配置参数

根据你选择的方案，执行相应命令。
- 自建应用配置
  
  bash
  
  openclaw config set channels.wecom-app.enabled true
  
  openclaw config set channels.wecom-app.webhookPath /wecom/app
  
  openclaw config set channels.wecom-app.token "你的Token"
  
  openclaw config set channels.wecom-app.encodingAESKey "你的EncodingAESKey"
  
  openclaw config set channels.wecom-app.corpId "你的CorpID"
  
  openclaw config set channels.wecom-app.corpSecret "你的Secret"
  
  openclaw config set channels.wecom-app.agentId "你的AgentID"
- 智能机器人配置
  
  bash
  
  openclaw config set channels.wecom.enabled true
  
  openclaw config set channels.wecom.webhookPath /wecom
  
  openclaw config set channels.wecom.token "你的Token"
  
  openclaw config set channels.wecom.encodingAESKey "你的EncodingAESKey"
重启服务

bash

openclaw gateway restart

访问 http://127.0.0.1:18789/admin。
进入 Channels → 企业微信。
根据方案选择，填入对应的 CorpID、AgentID、Secret、Token、EncodingAESKey 以及 Webhook Path (/wecom/app或 /wecom)。
启用通道并保存，然后重启网关服务。

完成配置

返回企业微信后台，点击之前未完成的“保存”或“创建”按钮。如果提示“已成功”，则表示打通成功。
开始对话
- 自建应用：在企业微信客户端「工作台」找到并打开“AI 助手”应用。
- 智能机器人：在「通讯录」中找到机器人并进入聊天窗口。
  
  发送消息如“你好”，测试 AI 是否回复。
常见问题排查
- URL 无法访问：检查 cloudflared隧道是否正常运行，以及企业微信后台填写的 URL 路径是否与 OpenClaw 配置完全一致。
- 回调验证失败：检查 Token 和 EncodingAESKey 是否复制正确，注意前后空格。可尝试先在微信后台将消息加密模式改为“明文模式”进行测试。
- 消息收不到回复：检查 OpenClaw 服务是否正常运行 (curl http://127.0.0.1:18789/health)，并查看 OpenClaw 日志文件以获取详细错误信息。