第 1 步：安装依赖

pip install pycryptodome qrcode requests
​

第 2 步：启动微信前端

cd /path/to/GenericAgent/frontends   # 替换为你本地的 frontends 目录
python wechatapp.py
​

第 3 步：扫码登录

启动后会自动弹出二维码，用微信扫码即可连接。

open ~/.wxbot/wx_qr.png
​

第 4 步：确认连接成功

扫码后，终端显示连接成功，你就可以在微信中和 GA 对话了。

安装依赖

pip install lark-oapi python-socks
​

创建飞书应用

1. 打开 飞书开放平台，登录账号

2. 点击「创建企业自建应用」，填写应用信息：
   • 应用名称：我的Agent助手（可自定义）
   • 应用描述：个人AI助手
   • 应用图标：可选

3. 进入应用详情页，左侧菜单选择「添加应用能力」→ 找到「机器人」→ 点击「添加」

4. 左侧菜单「权限管理」→「开通权限」，搜索并开通以下权限：

   • im:message — 获取与发送单聊、群组消息
   • im:message:send_as_bot — 以应用身份发送消息
   • contact:user.id:readonly — 获取用户 ID
   • im:message.p2p_msg:readonly

获取密钥并配置

5. 左侧菜单「凭证与基础信息」，记录 App ID 和 App Secret

6. 在 mykey.py 中填入：

fs_app_id = 'cli_xxxx'           # 替换为你的 App ID
fs_app_secret = 'xxxxxxx'        # 替换为你的 App Secret
fs_allowed_users = [""]           # 空列表表示允许所有用户
​

启动服务

7. 启动飞书前端，看到「等待消息…」表示服务已就绪：

cd /path/to/GenericAgent/frontends
python fsapp.py
​

配置事件订阅

8. 回到飞书开放平台的应用配置页面：
   • 点击「回调配置」→ 订阅方式选择「使用长连接接收事件」
   • 点击「事件配置」→ 同样选择「长连接」→ 点击「添加事件」→ 搜索添加 im.message.receive_v1

发布应用

9. 填写版本信息 → 保存 → 确认发布

开始对话

10. 下载 飞书客户端，登录后搜索你的 Agent 名称，即可开始对话

搜索框搜索你建立的个人助手名字

在对话框中输入问题，手机版飞书也能继续对话

安装依赖

pip install dingtalk-stream
​

创建钉钉应用

1. 登录 钉钉开发者后台（需企业管理员账号）
2. 进入 应用开发 → 企业内部应用 → 钉钉应用 → 创建应用，填写应用名称、描述、图标

获取密钥并配置

3. 左侧菜单「基础信息 → 凭证与基础信息」，找到：

   • Client ID = AppKey（公开标识）
   • Client Secret = AppSecret（私密密钥）

4. 在 mykey.py 中填入上述 ID 和 Secret

添加机器人能力

5. 应用详情 → 应用能力 → 添加应用能力 → 机器人

6. 配置机器人信息，底部消息接收模式选择 Stream 模式（流式接收）

发布并启动

7. 应用发布 → 版本管理与发布 → 创建新版本 → 发布，等待审批通过

8. 启动钉钉前端：

cd /path/to/GenericAgent/frontends
python dingtalkapp.py
​

9. 在钉钉客户端搜索 Agent 名称，即可开始对话

安装依赖

pip install qq-botpy
​

创建 QQ 机器人

1. 打开 QQ 开放平台，扫码登录 → 选择「机器人」选项

2. 创建机器人

获取密钥并配置

3. 获取 AppID 和 AppSecret（见 step1），QQ 扫码进入机器人对话窗口（见 step2）

4. 在 mykey.py 中填入上述 ID 和 Secret

启动并对话

5. 启动 QQ 前端：

cd /path/to/GenericAgent/frontends
python qqapp.py
​

6. 开始对话

安装依赖

pip install python-telegram-bot
​

创建 Telegram Bot

1. 在 Telegram 中搜索 @BotFather，发送 /newbot
2. 按提示设置 Bot 名称，获取 Bot Token

配置并启动

3. 在 mykey.py 中填入：

tg_bot_token = "1234567890:ABCxxxxxxxxxxxxxxxxxxxxxxxx"
tg_allowed_users = [123456789]    # 你的 Telegram 用户 ID
​

4. 启动 Telegram 前端：

cd /path/to/GenericAgent/frontends
python tgapp.py
​

5. 在 Telegram 中搜索你的 Bot 名称，开始对话

安装依赖

pip install wecom_aibot_sdk
​

注册与下载

1. 打开 企业微信官网，注册账户（或登录已有账户），下载桌面端

创建智能机器人

2. 登录企业微信客户端，创建智能机器人

3. 设置机器人：

   • 选择手动创建

   

   • 滑到底部，选择 API 模式创建

   

   • 选择长连接，获取 Bot ID 和 Secret

   

配置并启动

4. 在 mykey.py 中填入上述 Bot ID 和 Secret

5. 启动企业微信前端：

cd /path/to/GenericAgent/frontends
python wecomapp.py
​

6. 在企业微信中找到你的机器人，开始对话

不影响。 用户启动的是对应平台的 app.py（如 wechatapp.py），它是独立进程，关闭 GenericAgent 窗口不会中断连接。

在运行 app.py 的终端中按 Ctrl + C 即可中断连接。中断期间发出的消息不会丢失——重新运行 python wechatapp.py 后，会按顺序回复中断期间收到的消息。

可以。 每个平台是独立进程，互不影响。例如同时运行微信和飞书：

python frontends/wechatapp.py &
python frontends/fsapp.py &
​