当前位置：首页 > news >正文

Clawdbot企业微信入口配置教程：3步完成，AI助手24小时在线

news 2026/3/27 0:52:28

Clawdbot企业微信入口配置教程：3步完成，AI助手24小时在线

1. 为什么选择企业微信入口

企业微信作为国内主流办公通讯工具，与Clawdbot AI助手的结合能带来显著优势：

无缝集成：直接在企业微信工作台中使用AI助手，无需切换应用
安全合规：所有消息通过企业微信官方加密通道传输，符合国内数据安全要求
组织管理：可精细控制哪些部门或成员能使用AI助手功能
稳定可靠：基于企业微信成熟的架构，保证服务高可用性

相比WhatsApp、Telegram等国际通讯工具，企业微信入口更适合国内企业环境，解决了网络访问限制和语言障碍问题。

2. 配置前的准备工作

2.1 环境检查

确保你的Clawdbot服务已正常运行：

# 检查服务状态 ps aux | grep clawdbot-gateway # 如果没有运行，启动服务 bash /root/start-clawdbot.sh

2.2 获取必要信息

准备以下信息用于配置：

企业微信CorpID（企业唯一标识）
自建应用的AgentID和Secret
可用的域名或公网IP地址（必须支持HTTPS）

3. 企业微信入口配置步骤

3.1 第一步：创建企业微信应用

登录企业微信管理后台
进入「应用管理」→「自建应用」→「创建应用」
填写应用信息：
- 应用名称：Clawdbot AI助手
- 可见范围：选择需要使用AI的部门或成员

3.2 第二步：配置服务器设置

在企业微信应用详情页找到「接收消息」设置：

点击「设置API接收」
填写服务器配置：
- URL：https://你的域名或IP:18789/wechatwork/callback
- Token：自定义32位字符串（如clawdbot2024weixin）
- EncodingAESKey：点击「随机生成」获取

重要提示：请妥善保存Token和EncodingAESKey，后续配置需要用到。

3.3 第三步：修改Clawdbot配置

编辑Clawdbot配置文件：

nano /root/.clawdbot/clawdbot.json

在配置文件中添加或修改adapters部分：

{ "adapters": { "wechatwork": { "enabled": true, "port": 18789, "token": "你在企业微信设置的Token", "encoding_aes_key": "企业微信生成的EncodingAESKey", "corp_id": "你的企业CorpID", "agent_id": 你的应用AgentID, "secret": "你的应用Secret" } } }

保存退出后，验证配置是否正确：

cd /root/clawdbot node dist/index.js wechatwork verify

如果所有检查项都通过，就可以重启服务了：

bash /root/restart-gateway.sh

4. 验证与测试

4.1 首次验证

在企业微信后台点击「保存」后，微信服务器会发送验证请求。如果配置正确，Clawdbot会自动处理并返回成功响应。

你可以通过日志查看验证过程：

tail -f /tmp/clawdbot-wechatwork.log

4.2 发送测试消息

在企业微信中找到你创建的应用
发送任意消息（如"你好"）
查看AI助手的回复

如果一切正常，你应该能在几秒内收到AI的回复。同时，服务器日志会显示完整的消息处理过程。

5. 常见问题解决

5.1 收不到消息

可能原因及解决方法：

HTTPS配置问题：
- 确保URL以https://开头
- 检查证书是否有效（可使用curl -I https://你的域名测试）

时间不同步：

# 启用NTP时间同步 sudo timedatectl set-ntp true sudo systemctl restart systemd-timesyncd

配置错误：
- 重新运行node dist/index.js wechatwork verify检查配置
- 确保企业微信后台和Clawdbot配置中的Token、EncodingAESKey完全一致

5.2 消息解密失败

如果日志显示解密错误：

检查EncodingAESKey是否正确，特别注意：
- 没有多余空格或换行
- 完整43个字符

手动测试加解密：

# 生成测试文件 echo "测试加解密" > test.txt # 加密测试 node dist/index.js wechatwork encrypt --file test.txt # 解密测试（使用上一步的输出） node dist/index.js wechatwork decrypt --encrypt "加密内容" --signature "签名" --timestamp 当前时间戳 --nonce 随机数

5.3 响应速度慢

如果AI回复延迟较高：

切换轻量级模型：

node dist/index.js config set agents.defaults.model.primary ollama/qwen2:0.5b bash /root/restart-gateway.sh

检查服务器资源使用情况：
```
top free -h
```

6. 高级配置建议

6.1 使用Nginx反向代理

生产环境建议使用Nginx作为反向代理：

安装Nginx和SSL证书（如Let's Encrypt）
配置Nginx：

server { listen 443 ssl; server_name your-domain.com; ssl_certificate /path/to/cert.pem; ssl_certificate_key /path/to/key.pem; location /wechatwork/callback { proxy_pass http://127.0.0.1:18789; proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; } }

重载Nginx配置：
```
sudo nginx -t && sudo nginx -s reload
```

6.2 设置进程守护

确保Clawdbot服务稳定运行：

sudo tee /etc/systemd/system/clawdbot-gateway.service << 'EOF' [Unit] Description=Clawdbot Gateway Service After=network.target [Service] Type=simple User=root WorkingDirectory=/root/clawdbot ExecStart=/usr/bin/node dist/index.js gateway Restart=always RestartSec=10 [Install] WantedBy=multi-user.target EOF sudo systemctl daemon-reload sudo systemctl enable --now clawdbot-gateway