将 OpenClaw 部署在本地并接入企业微信,核心思路是:在本地运行 OpenClaw,并通过内网穿透工具将服务暴露给公网,使企业微信服务器能访问到它。
以下是基于 OpenClaw 2026 版本,在 Windows / macOS / Linux 上的通用部署方案。
🛠️ 一、准备工作
- 环境要求
- 操作系统:Windows 10+ (推荐 WSL2)、macOS 13+、Linux (Ubuntu 22.04+)。
- Node.js:版本 ≥ 20 (部分安装脚本会自动安装)。
- 内网穿透工具:如 、或 。
- 账号与凭证
- 企业微信:一个已认证的企业,并拥有管理员权限。
- 大模型 API Key:用于提供 AI 能力,如阿里云百炼、移动云一站式模型服务等。
🚀 二、本地部署 OpenClaw
方式一:使用官方安装脚本 (推荐)
此方法适用于 macOS 和 Linux,Windows 用户推荐在 WSL2 中操作。
- 执行安装
在终端中运行以下命令,按提示操作即可:
bash
curl -fsSL https://openclaw.ai/install.sh| bash
- 提示风险时,输入 。
- 新手引导模式可选择 。
- 模型提供商可先 ,后续在 Web 控制台配置。
- 启动服务
安装完成后,启动 OpenClaw 网关:
bash
openclaw gateway start
服务默认监听 。
- 访问 Web 控制台
执行命令生成管理员 Token 并访问 Web 控制台:
bash
openclaw token generate –admin
然后在浏览器中打开 ,确认服务正常运行。
方式二:源码安装
- 克隆仓库
bash
git clone https://github.com/openclaw/openclaw.git
cd openclaw
- 安装依赖并启动
bash
npm install
npm run start
服务启动后,访问 进行测试。
🔗 三、配置内网穿透
企业微信的回调地址必须是公网可访问的。这里以 为例进行演示。
- 安装 cloudflared
bash
npm install -g cloudflared
- 启动隧道
将本地 端口映射到公网:
bash
cloudflared tunnel –url http://127.0.0.1:18789
运行后会生成一个类似 的公网 HTTPS 地址,请复制备用。
备选方案:你也可以使用 或 。核心是将本地 端口通过 TCP 或 HTTP 方式暴露出去。
🏢 四、配置企业微信
方案 A:自建应用 (功能更全)
- 创建应用
登录企业微信管理后台 → 应用管理 → 自建应用 → 创建应用。填写名称(如“AI 助手”)、上传头像并设置可见范围。
- 获取凭证
在应用详情页,记录以下三个关键信息:
- CorpID (企业 ID)
- AgentID (应用 ID)
- Secret (应用密钥)
- 设置回调
进入应用详情 → 接收消息 → 设置 API 接收。
- URL:
- 注意:是 OpenClaw 企业微信自建应用通道的默认路径,需与 OpenClaw 配置保持一致。
点击“随机获取” Token 和 EncodingAESKey,并保存。先不要点击“保存”按钮。
方案 B:智能机器人 (配置简单)
- 创建机器人
登录企业微信管理后台 → 安全与管理 → 管理工具 → 智能机器人 → 创建机器人 → API 模式创建。
- 获取凭证
填写机器人名称、简介和可见范围。点击“随机获取” Token 和 EncodingAESKey,并保存。同样先不要点击“创建”。
- 设置回调
- URL:
- 注意:智能机器人通常使用 路径。
填入 Token 和 EncodingAESKey 后,先保存 OpenClaw 配置,再回到此页面点击“创建”。
⚙️ 五、打通 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
方式二:Web 控制台配置
- 访问 。
- 进入 Channels → 企业微信。
- 根据方案选择,填入对应的 CorpID、AgentID、Secret、Token、EncodingAESKey 以及 Webhook Path (或 )。
- 启用通道并保存,然后重启网关服务。
✅ 六、测试与排错
- 完成配置
返回企业微信后台,点击之前未完成的“保存”或“创建”按钮。如果提示“已成功”,则表示打通成功。
- 开始对话
- 自建应用:在企业微信客户端「工作台」找到并打开“AI 助手”应用。
- 智能机器人:在「通讯录」中找到机器人并进入聊天窗口。
发送消息如“你好”,测试 AI 是否回复。
- 常见问题排查
- URL 无法访问:检查 隧道是否正常运行,以及企业微信后台填写的 URL 路径是否与 OpenClaw 配置完全一致。
- 回调验证失败:检查 Token 和 EncodingAESKey 是否复制正确,注意前后空格。可尝试先在微信后台将消息加密模式改为“明文模式”进行测试。
- 消息收不到回复:检查 OpenClaw 服务是否正常运行 (),并查看 OpenClaw 日志文件以获取详细错误信息。
版权声明:本文内容由互联网用户自发贡献,该文观点仅代表作者本人。本站仅提供信息存储空间服务,不拥有所有权,不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容,请联系我们,一经查实,本站将立刻删除。
如需转载请保留出处:https://51itzy.com/kjqy/228873.html