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

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

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

🛠️ 一、准备工作

1. 环境要求

   • 操作系统：Windows 10+ (推荐 WSL2)、macOS 13+、Linux (Ubuntu 22.04+)。

   • Node.js：版本 ≥ 20 (部分安装脚本会自动安装)。

   • 内网穿透工具：如cloudflared、ngrok或frp。

2. 账号与凭证

   • 企业微信：一个已认证的企业，并拥有管理员权限。

   • 大模型 API Key：用于提供 AI 能力，如阿里云百炼、移动云一站式模型服务等。

🚀 二、本地部署 OpenClaw

方式一：使用官方安装脚本 (推荐)

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

1. 执行安装

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

   bash

   curl -fsSL https://openclaw.ai/install.sh| bash

   • 提示风险时，输入Yes。

   • 新手引导模式可选择QuickStart。

   • 模型提供商可先Skip for now，后续在 Web 控制台配置。

2. 启动服务

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

   bash

   openclaw gateway start

   服务默认监听http://127.0.0.1:18789。

3. 访问 Web 控制台

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

   bash

   openclaw token generate --admin

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

方式二：源码安装

1. 克隆仓库

   bash

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

   cd openclaw

2. 安装依赖并启动

   bash

   npm install

   npm run start

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

🔗 三、配置内网穿透

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

1. 安装 cloudflared

   bash

   npm install -g cloudflared

2. 启动隧道

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

   bash

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

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

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

🏢 四、配置企业微信

方案 A：自建应用 (功能更全)

1. 创建应用

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

2. 获取凭证

   在应用详情页，记录以下三个关键信息：

   • CorpID​ (企业 ID)

   • AgentID​ (应用 ID)

   • Secret​ (应用密钥)

3. 设置回调

   进入应用详情 →接收消息​ →设置 API 接收。

   • URL：https://xxxx.trycloudflare.com/wecom/app

     • 注意：/wecom/app是 OpenClaw 企业微信自建应用通道的默认路径，需与 OpenClaw 配置保持一致。

   • 点击“随机获取” Token 和 EncodingAESKey，并保存。先不要点击“保存”按钮。

方案 B：智能机器人 (配置简单)

1. 创建机器人

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

2. 获取凭证

   填写机器人名称、简介和可见范围。点击“随机获取” Token 和 EncodingAESKey，并保存。同样先不要点击“创建”。

3. 设置回调

   • URL：https://xxxx.trycloudflare.com/wecom

     • 注意：智能机器人通常使用/wecom路径。

   • 填入 Token 和 EncodingAESKey 后，先保存 OpenClaw 配置，再回到此页面点击“创建”。

⚙️ 五、打通 OpenClaw 与企业微信

方式一：命令行配置 (推荐)

1. 安装插件

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

   bash

   openclaw plugins install openclaw-plugin-wecom

2. 配置参数

   根据你选择的方案，执行相应命令。

   • 自建应用配置

     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"

3. 重启服务

   bash

   openclaw gateway restart

方式二：Web 控制台配置

1. 访问http://127.0.0.1:18789/admin。

2. 进入Channels → 企业微信。

3. 根据方案选择，填入对应的 CorpID、AgentID、Secret、Token、EncodingAESKey 以及 Webhook Path (/wecom/app或/wecom)。

4. 启用通道并保存，然后重启网关服务。

✅ 六、测试与排错

1. 完成配置

   返回企业微信后台，点击之前未完成的“保存”或“创建”按钮。如果提示“已成功”，则表示打通成功。

2. 开始对话

   • 自建应用：在企业微信客户端「工作台」找到并打开“AI 助手”应用。

   • 智能机器人：在「通讯录」中找到机器人并进入聊天窗口。

     发送消息如“你好”，测试 AI 是否回复。

3. 常见问题排查

   • URL 无法访问：检查cloudflared隧道是否正常运行，以及企业微信后台填写的 URL 路径是否与 OpenClaw 配置完全一致。

   • 回调验证失败：检查 Token 和 EncodingAESKey 是否复制正确，注意前后空格。可尝试先在微信后台将消息加密模式改为“明文模式”进行测试。

   • 消息收不到回复：检查 OpenClaw 服务是否正常运行 (curl http://127.0.0.1:18789/health)，并查看 OpenClaw 日志文件以获取详细错误信息。