一、最终效果
通过 AstrBot 框架，让一个ClawBot成为由 DeepSeek 驱动的 AI 助手。
用户私聊ClawBot即可获得智能回复（回复内容带 [AI] 前缀）。
二、运行环境
- 云服务器：阿里云轻量应用服务器（Alibaba Cloud Linux 3，2核2GB）
- 公网 IP：********
- Docker 版本：26.1.3
- Docker Compose 版本：v5.1.4
三、部署步骤
1. 拉取并运行 AstrBot 容器
bash
docker run -itd \ --name astrbot \ --restart unless-stopped \ -p 6185:6185 \ -v /root/astrbot/data:/AstrBot/data \ -v /etc/localtime:/etc/localtime:ro \ m.daocloud.io/docker.io/soulter/astrbot:latest
2. 开放防火墙端口
在阿里云控制台 → 轻量应用服务器 → 防火墙 → 添加规则：
- 端口：
6185 - 协议：TCP
- 授权对象：
0.0.0.0/0
3. 访问 WebUI 并初始化
浏览器打开 http://********，按提示创建管理员账号。
4. 配置 DeepSeek 模型
- 左侧菜单「服务提供商」→「+ 新增」→ 选择
OpenAI（因为 DeepSeek 兼容 OpenAI 接口） - 填写参数：
- API Key：在 DeepSeek 开放平台 申请
- API Base URL：
https://api.deepseek.com/v1
- 点击「获取模型列表」，启用
deepseek-chat或deepseek-v4-flash - 保存配置
5. 设置 DeepSeek 为默认模型
- 左侧菜单「配置文件」→「默认对话模型」→ 选择刚添加的 DeepSeek 模型 → 保存
6. 添加微信个人号机器人
- 左侧菜单「机器人」→「+ 创建机器人」→ 选择
个人微信 (weixin_oc) - 填写机器人名称（如
kgale） - 确保“启用”开关打开（非常重要！）
- 页面会出现二维码 → 用微信小号扫码 → 手机上确认 ClawBot 插件启动
- 点击「保存」
7. 重启容器并测试
bash
docker restart astrbot
测试：用主号给微信小号发送任意消息，应收到 [AI] ... 格式的回复。
四、遇到的常见问题及解决
| 问题 | 原因 | 解决方案 |
|---|---|---|
| 扫码后二维码一直刷新 | 未点击“启用”开关 | 编辑机器人实例，打开“启用”开关 |
| LLM 响应错误 / Connection error | API Key 无效或网络不通 | 检查 API Key 是否有效；服务器执行 curl 测试 DeepSeek 接口 |
| 手机上收到回复但显示 ClawBot | 微信官方设计 | 在主号中修改该联系人的备注名为小号名称 |
| 容器启动后 WebUI 无法访问 | 防火墙未放行 6185 端口 | 在阿里云控制台添加防火墙规则 |
五、常用维护命令
bash
# 查看实时日志 docker logs -f astrbot # 重启容器 docker restart astrbot # 停止并删除容器 docker stop astrbot && docker rm astrbot
六、总结
通过 AstrBot + DeepSeek API，可以快速为微信接入 AI 能力。虽然受限于微信官方机制，回复来源显示为 ClawBot，但通过修改备注名即可获得近乎原生的体验。该方案稳定、配置简单，适合个人使用。