打通手机与电脑:OpenClaw 配置 Telegram / 飞书机器人全攻略

本文旨在帮助读者将 OpenClaw 接入 Telegram 或飞书,实现手机远程控制电脑,让 AI 助手随时待命。

一、 核心原理:为什么选择 IM 机器人?

OpenClaw 本身是一个运行在电脑上的服务端程序。IM 机器人(Bot)​ 在这里扮演了 “通信桥梁”​ 的角色:

  • 手机端:你通过聊天软件(Telegram/飞书)发送自然语言指令。
  • Bot 端:机器人接收指令,通过 API 转发给电脑上的 OpenClaw 服务。
  • 电脑端:OpenClaw 执行指令(如整理文件、运行代码),并将结果通过 Bot 发回手机。

核心优势

  • 随时随地:只要手机有网,就能控制家里的电脑。
  • 无缝集成:无需额外安装 App,直接使用你日常的聊天软件。
  • 安全可控:通过“配对码”机制,只有授权的用户才能控制你的电脑。

二、 方案一:配置 Telegram 机器人

Telegram 拥有全球化的 Bot API,配置流程相对简单,适合有一定动手能力的用户。

1. 创建 Telegram Bot

  1. 打开 Telegram,搜索 @BotFather(官方机器人)。
  2. 发送 /newbot命令,按提示设置机器人名称(如 My Claw Bot)和用户名(必须以 bot结尾,如 my_claw_bot)。
  3. BotFather 会生成一个 API Token(格式如 123456789:ABCdefGHIjklMNOpqrsTUVwxyz),请立即复制保存,这是机器人的“身份证”。

2. 配置 OpenClaw

打开终端,执行以下命令配置 Telegram 通道:

# 1. 设置 Token(替换 YOUR_TOKEN 为实际值)
openclaw config set channels.telegram.accounts.default.botToken "YOUR_TOKEN"

# 2. 启用 Telegram 插件
openclaw config set plugins.entries.telegram.enabled true

# 3. 重启网关使配置生效
openclaw daemon restartCode language: CSS (css)

3. 配对与授权

这是最关键的安全步骤,确保只有你的手机能控制电脑。

  1. 获取配对码:在 Telegram 中搜索你刚创建的 Bot,发送 /start或任意消息。Bot 会回复一个 Pairing Code(配对码)。
  2. 执行配对:在电脑终端执行以下命令,将你的手机与电脑绑定: openclaw pairing approve telegram <你的配对码>
  3. 测试:在 Telegram 中发送指令,如“帮我列出桌面文件”,如果收到回复,说明配置成功。

4. 避坑指南

  • IPv6 连接问题:如果 Bot 连接正常但不回复消息,可能是 IPv6 路由问题。在启动 OpenClaw 前设置环境变量强制使用 IPv4: export NODE_OPTIONS="--dns-result-order=ipv4first" openclaw gateway
  • 群聊设置:默认 Bot 在群里需要被 @ 才会回复。如需修改,可在配置中设置 "requireMention": false

三、 方案二:配置飞书机器人

飞书是国内用户更熟悉的选择,配置流程涉及开放平台,但界面更友好。

1. 创建飞书应用

  1. 访问 飞书开放平台,点击“创建企业自建应用”。
  2. 填写应用名称(如“AI 助手”),点击创建。
  3. 进入应用管理页面,在 “凭证与基础信息”​ 中获取 App ID​ 和 App Secret,保存备用。

2. 配置权限与事件

  1. 在应用管理页面,点击 “权限管理”,开通以下权限:
    • im:message(接收与发送消息)
    • im:message.group_at_msg(接收群聊@消息)
    • im:message.p2p_msg(接收单聊消息)
  2. 点击 “事件与回调”,选择 “长连接接收事件”(WebSocket 模式,无需配置 Webhook URL),并添加 im.message.receive_v1事件。

3. 配置 OpenClaw

在终端执行以下命令,将飞书接入 OpenClaw:

# 1. 设置应用凭证(替换 YOUR_APP_IDYOUR_SECRETopenclaw config set channels.feishu.appId "YOUR_APP_ID"
openclaw config set channels.feishu.appSecret "YOUR_SECRET"

# 2. 启用飞书通道
openclaw config set channels.feishu.enabled true

# 3. 设置连接模式(推荐长连接)
openclaw config set channels.feishu.connectionMode websocket

# 4. 重启服务
openclaw gateway restartCode language: CSS (css)

4. 发布与测试

  1. 发布应用:在飞书开放平台点击“版本管理与发布”,创建版本并发布(企业自建应用通常免审)。
  2. 获取配对码:在飞书客户端搜索你的应用名称,发送消息,机器人会回复配对码。
  3. 执行配对:在终端执行 openclaw pairing approve feishu <配对码>
  4. 测试:发送指令验证功能。

四、 进阶配置:让远程控制更稳定

1. 电脑保持在线

远程控制的前提是电脑必须开机且 OpenClaw 在运行。建议:

  • 设置开机自启:将 OpenClaw 配置为系统服务,确保电脑重启后自动运行。
  • 使用云服务器:如果条件允许,将 OpenClaw 部署在云服务器上,实现 24 小时在线。

2. 网络穿透(内网穿透)

如果你的电脑在家里的局域网(没有公网 IP),出门在外可能无法连接。此时需要配置 内网穿透

  • 工具推荐:使用 frpngrok等工具,将电脑的端口暴露到公网。
  • 配置步骤:在穿透工具中配置本地端口(如 18789)映射到公网域名。

3. 安全加固

  • 定期更换 Token:如果怀疑 Token 泄露,及时在 BotFather 或飞书后台重新生成。
  • 限制权限:在 OpenClaw 配置中设置 dmPolicy: pairing,只允许配对的设备访问,防止陌生人控制你的电脑。

五、 总结

通过以上步骤,你已经成功将 OpenClaw 装进了手机。无论是 Telegram 的全球化生态,还是飞书的办公集成,都能让你在通勤路上、会议间隙,轻松指挥家里的电脑完成复杂任务。

现在,拿起手机,开始你的远程 AI 控制之旅吧!

评论

发表回复

您的邮箱地址不会被公开。 必填项已用 * 标注