企业微信机器人安装指南
======================

作者: 系统管理员
更新时间: 2026-03-24 03:02:11

----------------------------------------

企业微信机器人 - 快速安装指南安装步骤1. 创建数据库表执行SQL文件创建必要的数据库表：# 方法1：使用MySQL命令行
mysql -u用户名 -p密码 数据库名 < app/Database/wework_bot.sql方法2：使用phpMyAdmin
1. 登录phpMyAdmin
2. 选择数据库
3. 点击"导入"
4. 选择 app/Database/wework_bot.sql 文件
5. 点击"执行"方法3：直接执行SQL
打开 app/Database/wework_bot.sql 文件
复制所有SQL语句
在数据库管理工具中执行
SQL文件会创建以下表：
wework_bot - 机器人配置表
wework_conversation - 对话记录表

2. 验证安装访问后台管理系统，检查左侧菜单是否出现「企业微信机器人」选项：系统配置
  ├─ 模板管理
  ├─ API管理
  ├─ 企业微信机器人  ← 新增菜单
  ├─ AI配置
  ├─ RAG管理
  └─ 系统设置
3. 配置企业微信参考《企业微信机器人使用说明.md》完成企业微信应用的创建和配置。文件清单安装完成后，系统包含以下文件：后端控制器
app/Controllers/Admin/Wework.php - 后台管理控制器
app/Controllers/Wework.php - 企业微信回调处理控制器

视图文件
app/Views/admin/wework/index.php - 机器人列表页
app/Views/admin/wework/edit.php - 机器人编辑页
app/Views/admin/wework/logs.php - 对话日志页
app/Views/admin/wework/stats.php - 统计分析页

数据库
app/Database/wework_bot.sql - 数据库表结构

路由配置
已在 app/Config/Routes.php 中添加以下路由：// 后台管理路由
admin/wework              - 机器人列表
admin/wework/add          - 添加机器人
admin/wework/edit/:id     - 编辑机器人
admin/wework/save         - 保存机器人
admin/wework/delete       - 删除机器人
admin/wework/toggle       - 启用/禁用
admin/wework/test         - 测试连接
admin/wework/logs         - 对话日志
admin/wework/stats        - 统计分析// 企业微信回调路由
wework/callback/:token    - 接收企业微信消息
功能特性✅ 多机器人管理 - 支持创建多个机器人，对接不同应用  
✅ 智能路由 - 根据置信度自动决定是否转人工  
✅ 工作模式 - 智能路由/全自动/混合三种模式  
✅ 对话日志 - 完整记录所有对话历史  
✅ 数据统计 - 对话量、置信度、高频问题等分析  
✅ 可视化配置 - 后台界面化配置，无需修改代码  系统要求PHP 7.4+
MySQL 5.7+ / MariaDB 10.2+
CodeIgniter 4
已配置AI模型（用于智能问答）
已创建知识空间和文档
HTTPS域名（企业微信要求）

快速测试1. 创建测试机器人机器人名称：测试机器人
机器人标识：test-bot
CorpId：你的企业ID
AgentId：你的应用ID
Secret：你的应用密钥
Token：随机生成的Token
EncodingAESKey：随机生成的密钥
知识空间：选择一个已有空间
AI模型：选择已配置的模型
工作模式：全自动
2. 配置企业微信回调URL：https://你的域名/wework/callback/test-bot
Token：与机器人配置中的Token一致
EncodingAESKey：与机器人配置中的密钥一致
3. 发送测试消息在企业微信应用中发送"你好"，机器人应该会自动回复。故障排查问题1：菜单不显示
清除浏览器缓存
检查路由配置是否正确
确认已更新 app/Views/admin/layout/header.php

问题2：数据库表不存在
确认已执行 app/Database/wework_bot.sql
检查数据库连接配置
查看数据库是否有权限创建表

问题3：回调验证失败
确认URL可以从外网访问
检查Token和EncodingAESKey是否一致
查看服务器错误日志

问题4：机器人不回复
检查机器人是否已启用
确认AI配置正常
查看对话日志是否有记录
检查知识空间是否有内容

下一步安装完成后，请阅读《企业微信机器人使用说明.md》了解详细的配置和使用方法。技术支持如遇到问题，请检查：
系统日志：writable/logs/
对话日志：后台 → 企业微信机器人 → 对话日志
数据库表：wework_bot 和 wework_conversation版本：v1.0.0  
更新时间：2024-01-20