PhoneGenie - 手机精灵

基于 Open-AutoGLM，支持 Telegram Bot 和飞书 Bot，通过聊天机器人操作 Android 手机。

快速开始

1. 安装依赖

pip install -r requirements.txt

2. 配置 Bot 复制示例配置：

cp config/bot_config.example.yaml config/bot_config.yaml

编辑 config/bot_config.yaml，参考以下配置：

Telegram Bot 配置：

telegram:
  token: "YOUR_BOT_TOKEN"
  allowed_user_id: YOUR_USER_ID

飞书 Bot 配置：

lark:
  app_id: "cli_xxx"
  app_secret: "xxx"
  verification_token: "xxx"
  allowed_users:
    - "ou_xxx"

模型配置：

model:
  base_url: "http://localhost:8000/v1"
  model_name: "autoglm-phone-9b"

agent:
  max_steps: 100
  device_id: null
  lang: "cn"

3. 连接手机并启动

Telegram Bot：

python bot_main.py

飞书 Bot：

python lark_main.py

飞书使用长连接方式，不需要公网 IP 或 ngrok，启动后自动连接到飞书服务器 两个 Bot 可以同时运行，互不影响

使用

Telegram Bot

在 Telegram 中向你的 Bot 发送任务：

• /start - 查看帮助
• /status - 查看设备状态
• /cancel - 取消当前任务
• 直接发送任务（如"打开微信"）

飞书 Bot

在飞书中直接向机器人发送任务：

• 发送任务描述即可执行（如"打开微信"）
• 支持交互式确认（通过消息卡片按钮）
• 支持进度实时显示

特性

• 💬 多平台支持：Telegram 和飞书双平台
• 📊 实时进度：显示执行步骤和思考过程
• 📸 截图反馈：每步自动发送手机截图
• ✋ 人工接管：支持任务取消和手动操作
• 🎯 交互确认：关键操作前请求用户确认
• 🖥️ CLI 模式：保留命令行模式（python main.py）

飞书应用配置

1. 创建应用

1. 访问 飞书开放平台
2. 创建企业自建应用
3. 获取 App ID 和 App Secret
4. 获取 Verification Token（事件订阅页面）

2. 配置权限

添加以下权限：

• im:message - 接收消息
• im:message:send_as_bot - 发送消息
• im:resource - 上传图片

3. 订阅事件

在"事件订阅"页面，订阅以下事件：

• im.message.receive_v1 - 接收消息
• card.action.trigger - 消息卡片交互

⚠️ 使用长连接方式，无需配置请求网址，只需订阅事件即可

4. 发布应用

1. 点击"创建版本"并发布
2. 添加测试用户或全员可用
3. 在飞书中搜索并添加你的机器人

5. 获取用户 Open ID

有两种方式获取：

1. 给机器人发送消息后，在日志中查看
2. 在飞书开放平台的"事件订阅 > 事件日志"中查看

将获取的 Open ID 添加到 config/bot_config.yaml 的 allowed_users 列表