3步搞定企业微信机器人：小白也能看懂的Clawdbot部署指南

不用懂代码，只要按顺序点鼠标，10分钟让你的机器人上线

---

一、先搞清楚：为什么不能"先建机器人再开服务"？

很多企业微信新手都会犯这个错：先跑到后台创建应用，再回来启动程序，结果保存时提示"URL请求失败"，一脸懵逼。

真相很简单： 企业微信要当场"打电话"给你的服务器确认身份。如果你服务器没开机，电话打不通，自然验证失败。

❌ 错误顺序：创建机器人 → 启动服务 → 保存失败 → 懵逼调试
✅ 正确顺序：启动服务 → 创建机器人 → 当场验证通过 → 直接使用

记住这张图：

---

二、准备工作：你需要这些

物品	是什么	去哪里搞
云服务器	24小时开机的电脑（推荐阿里云/腾讯云）	阿里云新人99元/年
公网IP	服务器的"门牌号"	买服务器就送
终端工具	远程控制服务器的软件	Windows用FinalShell，Mac用Terminal
企业微信管理员账号	能登录管理后台的权限	找你们公司IT开通

---

三、第1步：启动Clawdbot（最关键！）

3.1 登录你的服务器

打开终端工具，输入：

ssh root@你的服务器IP
# 然后输入密码（输入时不显示，回车即可）

看到类似 root@VM-xxx:~# 的提示，说明登录成功。

3.2 启动Clawdbot程序

# 进入程序文件夹（根据你实际放的位置调整）
cd /root/clawdbot

# 启动！（具体命令看你们的技术给的文档，常见是下面这种）
python3 bot.py
# 或者
./start.sh

成功标志： 看到类似 Running on http://0.0.0.0:8080 的提示，说明服务启动了。

3.3 让它后台运行（防止关闭窗口就断）

问题： 直接启动的话，关闭终端窗口程序就停了。

解决方案： 用 screen 或者 nohup 让它后台挂起。

最简单方法（screen）：

# 安装screen（一般自带，没有就装）
apt install screen -y

# 创建一个新窗口
screen -S bot

# 在这个窗口里启动Clawdbot
python3 bot.py

# 按 Ctrl+A，再按 D，退出窗口（程序继续在后台跑）

验证是否还在跑：

screen -ls
# 看到有个叫bot的进程，就是成功了

---

四、第2步：企业微信后台创建机器人

4.1 确认Clawdbot真的在运行

在浏览器里输入：

http://你的服务器IP:8080

（把IP换成你的真实IP，端口号也可能是8000/3000等，问你们技术）

应该看到错误页面或空白页——这说明服务在线！如果显示"无法访问"，回去检查上一步。

4.2 登录企业微信管理后台

1. 打开 https://work.weixin.qq.com/wework_admin/loginpage_wx
2. 用管理员微信扫码登录
3. 点击顶部菜单 【应用管理】

4.3 创建自建应用

4.4 配置接收消息（关键步骤！）

点击刚创建的应用，找到 【接收消息】 栏目，点击 【设置API】：

要填的项	填什么	示例
URL	你的服务器地址	http://123.45.67.89:8080/webhook
Token	随便编个密码（用于校验）	MyBot123456
EncodingAESKey	点击"随机生成"按钮	自动生成43位乱码

URL格式说明：

• http:// 或 https://（有域名证书就用https）
• 123.45.67.89 换成你的服务器公网IP
• :8080 是端口号（看Clawdbot启动时显示的是多少）
• /webhook 是路径（问你们技术，也可能是 /wx 或 /bot）

4.5 保存！这一刻验证自动发生

点击 【保存】 的瞬间：

1. 企业微信服务器立刻给你的URL打电话
2. Clawdbot接到电话，核对"暗号"（Token）
3. 对上了就返回确认信息
4. 页面显示 “保存成功” 🎉

如果看到红色报错：

报错信息	什么意思	怎么办
“请求URL失败” 或 “超时”	电话打不通	检查Clawdbot是否真的启动了；检查服务器防火墙是否开放端口
“签名验证失败”	暗号对不上	检查Token是否填错，两边必须完全一致
“不支持http”	必须用https	配置SSL证书，或者用Nginx代理

---

五、第3步：测试你的机器人

5.1 在群里@机器人

1. 在企业微信里，把机器人应用邀请到某个群聊
2. 在群里输入 @智能助手 你好
3. 如果Clawdbot配置正确，它应该回复你

5.2 查看日志排错

如果机器人不回复，回服务器看日志：

# 重新连上刚才的screen窗口
screen -r bot

# 你应该能看到收到的消息记录
# 按 Ctrl+C 停止，然后重新启动看最新日志

---

六、常见问题：新手必看

Q1：我没有域名，只能用IP地址吗？

可以！ 企业微信支持IP地址，只是http方式可能会有安全提示。生产环境建议买个域名（几十块一年）配SSL证书。

Q2：保存时提示"URL请求失败"，但服务明明启动了？

99%是防火墙问题。 去云服务器控制台，找到 安全组/防火墙 设置，添加规则：

• 协议：TCP
• 端口：8080（你的实际端口）
• 授权对象：0.0.0.0/0（允许所有IP）

Q3：Token和AESKey是什么？记不住怎么办？

• Token：你自己编的密码，用来验明正身
• EncodingAESKey：加密消息的钥匙，点随机生成后一定要复制保存到Clawdbot的配置文件里

建议： 填完后截图保存，两边配置必须一字不差。

Q4：关闭电脑后机器人还运行吗？

运行！ 因为程序跑在云端服务器上，不是你本地电脑。只要服务器不重启，机器人一直在线。

但服务器重启后需要重新启动Clawdbot，所以建议配置 开机自启（让技术帮你写个systemd服务）。

---

七、一张图记住全流程

---

八、总结：记住这个顺序

1. 先开机（启动Clawdbot）
2. 再填表（企业微信后台配置）
3. 当场验（保存时自动验证）
4. 后台挂（用screen保持运行）

只要顺序对，10分钟搞定；顺序错，调试到崩溃。

祝你的机器人顺利上线！有问题欢迎留言，看到必回。

---

吾问启玄关，艾理顺万绪