第三章移动端接入

OpenClaw 的真正威力在于随时随地的移动端控制。无论你在通勤路上、咖啡厅，还是出差途中，都可以通过手机给 OpenClaw 发送指令，让它在你的电脑或服务器上执行任务。

QQ 机器人用户：如果你还没有完成 QQ 机器人的接入，请先阅读第一章——它会带你从零开始完成环境安装和 QQ AI 助手的创建。

本章介绍飞书和 Telegram 的接入方式，以及 QQ 的进阶配置选项。

1. 为什么需要移动端接入

OpenClaw 如果只能在电脑上使用，那就失去了它最大的价值。想象一下：你在外面开会，服务器突然告警；你在通勤路上，需要紧急处理一个任务；你在度假，但还要关注项目进展。这些场景下，如果没有移动端接入，OpenClaw 就只是个摆设。

移动端接入不是"锦上添花"，而是 OpenClaw 的核心能力。只有接入飞书或 Telegram，你才能真正把 OpenClaw 变成 24/7 随时待命的 AI 助理。无论你在哪里，只需要发一条消息，OpenClaw 就会立即在服务器上执行任务并返回结果。这种随时随地的控制能力，才是 OpenClaw 区别于传统 AI 工具的关键。

选哪个平台？

如果你还没决定接入哪个 IM 平台，参考下表快速选择：

对比维度	QQ（第一章已接入）	飞书	Telegram
适合谁	个人用户、学生	企业用户、团队协作	技术用户、需要海外访问
接入难度	⭐ 最简单	⭐⭐ 需创建企业应用	⭐⭐ 需海外网络
消息功能	文字、图片	文字、图片、文件、富文本	文字、图片、文件、语音
独特优势	国内用户最多，第一章已配好	深度集成文档/日历/表格，可作为"数字分身"	无审核限制，API 最开放，支持 Markdown
网络要求	无特殊要求	无特殊要求	需要科学上网
群聊支持	✅ 需 @机器人	✅ 需 @机器人	✅ 需 @机器人
多平台同时接入	✅	✅	✅

建议：
已经在第一章接好了 QQ？可以先用着，有需要再加其他平台
公司用飞书办公？强烈推荐接入飞书，能帮你操作文档、日历、多维表格
追求最大灵活性？Telegram 的 API 最开放，无消息审核，适合开发者
OpenClaw 支持同时接入多个平台，你可以在 QQ 和朋友聊天、在飞书处理工作、在 Telegram 做开发——它们共享同一个 AI 大脑。

2. 飞书接入（推荐企业用户）

飞书是国内企业广泛使用的协作平台，接入 OpenClaw 后可以在工作群里直接调用 AI 助理，非常适合团队协作场景。相比个人使用的 Telegram，飞书的优势在于可以和团队成员共享同一个 OpenClaw 实例，实现协同工作。

2.1 飞书官方插件（强烈推荐）

飞书官方推出了 OpenClaw 专属插件，让你的 AI 助手以"你的身份"在飞书中完成工作，而非仅仅作为第三方机器人。

核心优势：

能力类别	具体功能
消息	读取群聊/单聊历史、消息发送与回复、消息搜索、图片/文件下载
文档	创建云文档、更新云文档、读取文档内容
多维表格	创建/管理多维表格、数据表、字段、记录（增删改查、批量操作、高级筛选）、视图
日历日程	日历管理、日程创建/查询/修改/删除/搜索、参会人管理、忙闲查询
任务	任务创建/查询/更新/完成、清单管理、子任务、评论

为什么强烈推荐？

真正的数字分身：以你的身份完成工作（回消息、写文档、生成多维表格），而非以机器人身份
更懂你的工作：获取飞书内的海量上下文（消息、文档、会议纪要、多维表格、日程、任务等）
更顺畅的沟通：提供消息流式生成等高级功能
中文生态更好：飞书是国内平台，有中文界面、文档和客服，更容易上手
开放能力更强：获取更多工作中必要的上下文，玩法更多

📖 详细说明：参考《OpenClaw飞书官方插件上线》

2.2 前置准备

在开始之前，确保：

已安装 OpenClaw（参考第一章）
拥有飞书账号，且具备创建企业自建应用的权限
网络环境正常即可（飞书使用"长连接"技术——即 OpenClaw 主动与飞书服务器保持连接，消息实时送达，不需要你有固定 IP 或做额外网络配置）

2.3 创建飞书应用

第一步：进入飞书开放平台

访问飞书开放平台，使用飞书账号登录。

国际版 Lark 用户：请访问 Lark Open Platform，并在配置中设置 domain: "lark"。

第二步：创建企业自建应用

点击"创建企业自建应用"

个人用户也能用：即使你不是企业管理员，也可以创建飞书应用。飞书允许个人用户创建"企业自建应用"用于个人测试和使用，不需要企业认证。

填写应用信息：
- 应用名称：如"OpenClaw 助理"（可自定义）
- 应用描述：个人 AI 助手
- 应用图标：可以用龙虾 emoji 🦞 或上传自定义图标
点击"创建"进入应用详情页

第三步：启用机器人能力

进入"添加应用能力" → "机器人"页面：

开启机器人能力
配置机器人相关设置（显示名称、描述等）

第四步：获取应用凭证

进入"凭证与基础信息"页面，记下 App ID 和 App Secret。这两个密钥非常重要，务必妥善保管，不要泄露给他人。

2.4 配置应用权限

第一步：批量导入权限（推荐）

进入"权限管理"页面，点击"批量导入"按钮，粘贴以下 JSON 配置一键导入所需权限：

json

{
  "scopes": {
    "tenant": [
      "contact:contact.base:readonly",
      "docx:document:readonly",
      "im:chat:read",
      "im:chat:update",
      "im:message.group_at_msg:readonly",
      "im:message.p2p_msg:readonly",
      "im:message.pins:read",
      "im:message.pins:write_only",
      "im:message.reactions:read",
      "im:message.reactions:write_only",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "application:application:self_manage",
      "cardkit:card:write",
      "cardkit:card:read"
    ],
    "user": [
      "contact:user.employee_id:readonly",
      "offline_access","base:app:copy",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:record:create",
      "base:record:delete",
      "base:record:retrieve",
      "base:record:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "base:app:create",
      "base:app:update",
      "base:app:read",
      "board:whiteboard:node:create",
      "board:whiteboard:node:read",
      "calendar:calendar:read",
      "calendar:calendar.event:create",
      "calendar:calendar.event:delete",
      "calendar:calendar.event:read",
      "calendar:calendar.event:reply",
      "calendar:calendar.event:update",
      "calendar:calendar.free_busy:read",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user:search",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.media:download",
      "docs:document:copy",
      "docx:document:create",
      "docx:document:readonly",
      "docx:document:write_only",
      "drive:drive.metadata:readonly",
      "drive:file:download",
      "drive:file:upload",
      "im:chat.members:read",
      "im:chat:read",
      "im:message",
      "im:message.group_msg:get_as_user",
      "im:message.p2p_msg:get_as_user",
      "im:message:readonly",
      "search:docs:read",
      "search:message",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "task:comment:read",
      "task:comment:write",
      "task:task:read",
      "task:task:write",
      "task:task:writeonly",
      "task:tasklist:read",
      "task:tasklist:write",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only"
    ]
  }
}

💡 提示：批量导入会自动开通所有必要的权限，包括消息收发、云文档操作、多维表格、日历等完整能力。

基础权限说明（必开）：

权限范围	权限类型	功能描述
`contact:user.base:readonly`	User info	获取基础用户信息
`im:message`	Messaging	收发消息
`im:message.p2p_msg:readonly`	DM	读取机器人的私信消息
`im:message.group_at_msg:readonly`	Group	接收群内@机器人的消息
`im:message:send_as_bot`	Send	以机器人身份发送消息
`im:resource`	Media	上传/下载图片/文件

可选全功能权限：

权限范围	权限类型	功能描述
`im:message.group_msg`	Group	读取群内所有消息（敏感）
`im:message:readonly`	Read	获取消息历史记录
`im:message:update`	Edit	编辑/更新已发送的消息
`im:message:recall`	Recall	撤回已发送的消息
`im:message.reactions:read`	Reactions	查看消息的互动反馈

开通权限后，点击"提交审核"。如果你是企业管理员，可以直接通过；如果不是，需要联系管理员审核。

2.5 配置事件订阅

⚠️ 重要提醒：在配置事件订阅前，请确保已完成以下步骤：
已运行 openclaw channels add 添加了 Feishu 渠道
网关处于启动状态（可通过 openclaw gateway status 检查）

进入"事件与回调" → "事件配置"：

选择"使用长连接接收事件"（即 WebSocket 模式，让飞书和 OpenClaw 保持实时连接，推荐，无需公网 IP）
添加事件：im.message.receive_v1（接收消息）

⚠️ 注意：如果网关未启动或渠道未添加，长连接设置将保存失败。

保存配置。长连接模式的优势是不需要配置回调地址，OpenClaw 会主动连接飞书服务器获取消息。

2.6 安装飞书插件并配置

飞书官方插件已上线，支持完整的飞书生态集成。

方式一：通过安装向导添加（推荐）

如果您刚安装完 OpenClaw，可以直接运行向导：

bash

openclaw onboard

向导会引导您完成：

创建飞书应用并获取凭证
配置应用凭证
启动网关

方式二：通过命令行添加

如果您已经完成了初始安装，可以用以下命令添加飞书渠道：

bash

openclaw channels add

按交互式提示操作：

选择 "Feishu/Lark (飞书)" 渠道
输入 App ID 和 App Secret
配置私聊策略（默认配对模式）
配置群组策略（默认白名单）

方式三：手动配置（高级）

bash

# 安装飞书插件
openclaw plugins install @openclaw/feishu

# 使用命令行设置配置
openclaw config set channels.feishu.appId "<App_ID>"
openclaw config set channels.feishu.appSecret "<App_Secret>"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode websocket
openclaw config set channels.feishu.dmPolicy pairing
openclaw config set channels.feishu.groupPolicy allowlist
openclaw config set channels.feishu.requireMention true

重启网关生效：

bash

openclaw gateway restart

✅ 完成配置后，您可以使用以下命令管理网关：

bash

openclaw gateway status      # 查看网关运行状态
openclaw gateway restart     # 重启网关以应用新配置
openclaw logs --follow       # 查看实时日志

2.7 发布应用

进入飞书应用管理 → "版本管理与发布"
点击"创建版本"
填写版本信息（版本号、更新说明等）
提交审核并发布
等待管理员审批（企业自建应用通常自动通过）

2.8 配对授权

第一步：发送测试消息

在飞书中找到您创建的机器人，发送一条消息（如"你好"）。

第二步：获取配对码

默认情况下，机器人会回复一个配对码。您需要批准此代码才能开始对话。

💡 提示：此时您也可以在 OpenClaw WebUI 中直接与 🦞 对话，让它帮忙完成配对步骤。

第三步：批准配对

在 OpenClaw 终端输入：

bash

openclaw pairing approve feishu <配对码>

或在 WebUI 中点击批准按钮。

第四步：测试功能

配对成功后，向机器人发送测试指令：

帮我查看当前时间

如果机器人能正常回复，说明接入成功！您也可以测试更复杂的指令：

@OpenClaw 帮我查看服务器磁盘使用情况

OpenClaw 会执行 df -h 命令并把结果发回飞书。

2.9 常见问题

权限问题：确保已开通所有必要权限，未开通会导致功能异常。可以在飞书开放平台的"权限管理"页面检查。建议直接使用批量导入功能导入完整权限配置。

连接失败：

检查网络是否正常，WebSocket 连接是否被防火墙拦截
确认网关已启动：openclaw gateway status
查看 OpenClaw 日志获取详细错误信息：openclaw logs --follow

长连接保存失败：

确保已运行 openclaw channels add 添加 Feishu 渠道
确保网关处于启动状态

配置不生效：修改配置后必须重启 OpenClaw 网关才能生效：openclaw gateway restart

版本兼容：建议使用 OpenClaw v2026.3+ 版本以获得最佳飞书支持。

3. Telegram 接入（推荐个人用户）

网络提示：Telegram 在中国大陆无法直接访问，需要网络代理（VPN）。如果你没有代理，建议使用飞书（第 2 节）或 QQ 机器人（第一章）接入。

Telegram 是全球流行的即时通讯应用，接入简单且功能强大。相比飞书，Telegram 更适合个人使用，而且支持端到端加密，隐私性更好。如果你不需要团队协作，只是想要一个随身的 AI 助理，Telegram 是最佳选择。

OpenClaw 内置了 Telegram 集成支持，配置简单，是最易接入的渠道之一。

3.1 创建 Telegram Bot

打开 Telegram，搜索 @BotFather（蓝色认证标识，这是 Telegram 官方的机器人管理工具）。找到后有两种方式创建机器人：

方式一：手动输入命令

在 BotFather 的聊天栏中直接输入 /newbot，然后按照对话引导完成创建。

方式二：通过菜单操作

点击 BotFather 主页的 Open 按钮进入对话，然后点击 Create a New Bot 选项，同样会进入创建流程。

两种方式效果完全一样，BotFather 都会依次询问：

显示名称（Name）：可以随意取，如"MyOpenClawBot"
用户名（Username）：必须以 bot 结尾，例如 openclaw_assistant_bot

创建成功后，BotFather 会返回一个 Bot Token，格式类似 123456789:ABCdefGHIjklMNOpqrsTUVwxyz。妥善保存这个 Token，不要泄露给他人。

这个 Token 就是你的机器人的唯一凭证。任何人拿到这个 Token 都可以控制你的机器人，所以一定要保密。如果不小心泄露了，可以在 BotFather 中使用 /revoke 命令撤销旧 Token 并生成新的。

可选设置：

发送 /setuserpic 上传机器人头像
发送 /setdescription 添加功能说明

3.2 配置 OpenClaw

方法一：命令行向导（推荐）

bash

# 添加 Telegram 渠道
openclaw channels add

# 按提示操作：
# 1. 选择 "Telegram (Bot API)"
# 2. 粘贴 Bot Token
# 3. 选择私聊策略（默认 pairing，需配对验证）
# 4. 配置群聊策略（默认 @提及才响应）
# 5. 选择消息接收模式（默认长轮询）

# 重启网关
openclaw gateway restart

openclaw channels add 向导界面

方法二：手动配置

bash

# 启用 Telegram 渠道
openclaw config set channels.telegram.enabled true

# 设置 Bot Token
openclaw config set channels.telegram.botToken "你的Token"

# 配置私聊策略（pairing/allowlist/open/disabled）
openclaw config set channels.telegram.dmPolicy "pairing"

# 配置群聊（@提及才响应）
openclaw config set channels.telegram.groups.requireMention true

# 重启网关生效
openclaw gateway restart

3.3 配对验证

配置完成后，你需要和机器人完成一次"配对"，让 OpenClaw 知道谁是机器人的主人。

第一步：找到你的机器人

在 Telegram 中搜索你刚创建的机器人用户名（如 @openclaw_assistant_bot），点击进入对话。

第二步：发起配对

点击对话底部的 Start（开始）按钮，或发送任意消息。机器人会回复一条配对信息：

这条消息包含两个重要信息：
Pairing code（配对码）：如 6KKG7C7K，下一步需要在终端中批准
Your Telegram user id（用户 ID）：如 8561283145，这就是你的 Chat ID——请记下来，第四章定时任务的 --channel 参数需要用到它

第三步：批准配对

复制消息中的配对码，在终端执行：

bash

openclaw pairing approve telegram 6KKG7C7K

把 6KKG7C7K 替换成你实际收到的配对码。

批准成功后，回到 Telegram 再给机器人发一条消息，它就能正常回复了。配对完成后，日常聊天不需要任何额外配置——直接和机器人对话即可。

Chat ID 的用途：配对消息中的 user id（如 8561283145）是你的 Chat ID。日常聊天用不到它，但如果你想让 OpenClaw 定时主动给你发消息（如每日简报），需要在创建定时任务时通过 --channel 参数指定发送目标：
bash
# 示例：每天 7:30 发送简报到你的 Telegram
openclaw cron add --name "每日简报" --cron "30 7 * * *" --message "发送今日简报" --channel "telegram:chat:8561283145"
把 8561283145 替换成你自己的 Chat ID。详见第四章定时任务。

安全加固（可选）

bash

# 仅允许特定用户（填入 Chat ID）
openclaw config set channels.telegram.allowFrom "[8561283145,987654321]"

# 限制群聊访问（群 Chat ID 以 -100 开头）
openclaw config set channels.telegram.allowedChatIds "[-1001234567890]"

如何获取群组 Chat ID？ 把 @RawDataBot 拉进群，它会自动发送一条包含 "chat": {"id": -100xxxxxxxxxx} 的消息，那个负数就是群组的 Chat ID。拿到后可以把 RawDataBot 踢出群。

3.4 开始使用

在 Telegram 中搜索你创建的 Bot 用户名，点击"Start"开始对话。发送指令测试：

帮我创建一个名为 test.txt 的文件，内容是今天的日期

OpenClaw 会在服务器上执行操作并返回结果。你还可以发送文件给 Bot，让它处理后返回。比如发送一个 CSV 文件，让它生成数据分析报告；发送一张图片，让它提取文字内容。

3.5 Telegram 的独特优势

相比飞书，Telegram 有几个独特的优势。首先是跨平台支持更好，在 iOS、Android、Windows、macOS、Linux 甚至网页版都能无缝使用。其次是消息同步非常快，几乎没有延迟。最重要的是隐私保护，Telegram 的端到端加密确保你和机器人的对话不会被第三方窃听。

另外，Telegram Bot 支持自定义键盘。你可以在配置中设置常用命令按钮：

bash

openclaw config set channels.telegram.customKeyboard '[["/status","/logs"],["/backup","/restart"]]'

这样在聊天界面底部会出现这些按钮，点击即可快速发送命令。

3.6 常见问题

机器人无响应：

检查 Bot Token 正确性
确认已完成配对（openclaw pairing list 查看）
检查网络连接（中国大陆可能需要代理）
重启网关：openclaw gateway restart

群聊中不响应：

确认已 @机器人
检查群聊 ID 是否在白名单中
重新邀请机器人进群

4. 使用技巧

4.1 命令快捷方式

在移动端输入长指令不方便，可以在配置文件中设置快捷命令：

jsonc

// openclaw.json
{
  "shortcuts": {
    "/status": "检查服务器状态，包括 CPU、内存、磁盘使用情况",
    "/logs": "显示最近 50 行应用日志",
    "/backup": "执行数据库备份并上传到云存储",
    "/deploy": "拉取最新代码并重启服务"
  }
}

这样你只需要发送 /status，OpenClaw 就会执行完整的检查流程。这些快捷命令本质上是预定义的 prompt，OpenClaw 会把它们展开成完整的指令再执行。

展开：带参数的快捷命令

你还可以设置带参数的快捷命令：

jsonc

// openclaw.json
{
  "shortcuts": {
    "/search": "在项目中搜索包含 {query} 的文件",
    "/git": "执行 git 命令: {command}"
  }
}

使用时这样调用：/search TODO 或 /git status。

4.2 文件传输

移动端接入的另一个强大功能是文件传输。你可以在手机上拍一张照片发给 OpenClaw，让它识别图片中的文字；或者发送一个 Excel 文件，让它生成数据分析报告。

在 Telegram 中，直接发送文件即可。OpenClaw 会自动下载文件到服务器，然后根据文件类型选择合适的处理方式。比如：

图片文件：自动调用 OCR 识别文字
CSV/Excel：生成数据统计和可视化图表
PDF：提取文本内容并总结
代码文件：进行代码审查和优化建议

处理完成后，OpenClaw 会把结果文件发回给你。整个过程完全自动化，不需要你手动上传下载。

展开：语音输入配置

4.3 语音输入

如果你在开车或不方便打字，可以使用语音输入。Telegram 和飞书都支持语音消息，OpenClaw 会自动将语音转换成文字，然后执行对应的指令。

在配置中启用语音识别：

jsonc

// openclaw.json
{
  "channels": {
    "telegram": {
      "enabled": true,
      "botToken": "xxxxx",
      "voiceRecognition": true,
      "language": "zh-CN"
    }
  }
}

发送语音消息后，OpenClaw 会先回复"正在识别语音..."，然后显示识别出的文字，最后执行指令并返回结果。

展开：安全加固建议

4.4 安全建议

移动端接入意味着 OpenClaw 可以从互联网访问，务必注意安全：

使用白名单：始终配置 allowed_users，限制只有你信任的人才能使用。即使是团队共享的机器人，也要明确列出所有成员的 ID。

敏感操作二次确认：对于删除文件、修改配置、重启服务等危险操作，可以设置二次确认：

jsonc

// openclaw.json
{
  "security": {
    "requireConfirmation": ["delete", "rm", "restart", "shutdown"]
  }
}

当你发送包含这些关键词的指令时，OpenClaw 会先询问"确定要执行吗？回复 yes 确认"，只有收到确认后才会真正执行。

定期检查日志：OpenClaw 会记录所有通过移动端执行的操作。定期查看日志，确保没有异常活动：

bash

openclaw logs --follow

不要在公共网络下暴露端口：如果你的 OpenClaw 运行在公网服务器上，务必配置防火墙，只允许来自飞书或 Telegram 官方服务器的请求。

展开：多渠道协同配置

4.5 多渠道协同

你可以同时启用飞书和 Telegram，在不同场景使用不同渠道。例如工作相关的任务通过飞书，个人事务通过 Telegram。所有对话历史都会同步到 OpenClaw 的记忆系统中，不会因为切换渠道而丢失上下文。

在配置中可以为不同渠道设置不同的权限：

jsonc

// openclaw.json
{
  "channels": {
    "feishu": {
      "enabled": true,
      "allowedOperations": ["read", "write", "execute"]
    },
    "telegram": {
      "enabled": true,
      "allowedOperations": ["read", "execute"]
    }
  }
}

이를 통해 보다 세분화된 권한 제어를 달성할 수 있습니다. 예를 들어 텔레그램에서는 정보만 쿼리할 수 있지만 파일을 수정할 수는 없습니다.

5. 실제 사례

5.1 출퇴근길 응급상황 대처

아침에 지하철을 타고 있는데 갑자기 경고를 받았습니다. 프로덕션 서버 CPU 사용량이 100%입니다. 즉시 Telegram을 열고 다음을 보냅니다.

/status

OpenClaw는 자세한 시스템 상태를 반환하고 특정 프로세스가 많은 CPU를 차지하고 있음을 발견했습니다. 계속해서 다음을 보냅니다.

帮我找出占用 CPU 最高的进程并重启它

OpenClaw는 top 명령을 실행하여 문제 프로세스를 찾아 확인 후 다시 시작합니다. 문제는 몇 분 안에 해결되며 컴퓨터를 켤 필요도 없습니다.

5.2 회의 중 빠르게 보고서 생성

당신은 고객 회의에 참석하고 있는데 고객이 갑자기 최신 데이터 보고서를 보여달라고 요청합니다. 테이블 아래에 있는 Feishu 로봇에게 조용히 메시지를 보냅니다.

@OpenClaw 生成本周销售数据报告，包括总销售额、增长率、TOP 10 产品

OpenClaw는 데이터베이스에 연결하여 데이터를 추출하고 Excel 보고서를 생성하여 Feishu로 보냅니다. 다운로드한 후 고객에게 화면을 전송할 수 있으며 전체 프로세스는 2분도 채 걸리지 않습니다.

5.3 여행 중 서버 관리

해외여행 중이고 시차는 8시간입니다. 중국에서는 데이터베이스 백업을 이른 아침에 해야 하는데, 한밤중에 일어나서 하고 싶지는 않습니다. 예약된 작업을 미리 설정해 놓았는데, 여전히 걱정이 되어 백업이 완료된 후 확인하고 싶습니다.

텔레그램으로 다음을 보냅니다:

备份完成后通知我，并告诉我备份文件大小

OpenClaw는 백업 작업이 완료되면 온라인 상태가 아니더라도 사전에 메시지를 보냅니다. 이 비동기식 알림을 사용하면 중요한 이벤트를 놓칠 염려 없이 편안하게 잠을 잘 수 있습니다.

6. QQ 고급 액세스

QQ 공식 네이티브 접속이 第一章에 완료되었습니다. 이 섹션에서는 보다 유연한 타사 솔루션을 소개합니다.

NapCat 액세스

보다 유연한 구성이 필요하거나 공식 액세스가 귀하의 요구 사항을 충족할 수 없는 경우 NapCat 프레임워크를 사용하여 OpenClaw를 QQ 개인 계정에 연결할 수 있습니다.

6.1 준비

시작하기 전에 다음이 필요합니다.

OpenClaw 설치 (버전 >= 2026.2.1)
QQ 계정은 로봇에 로그인하는 데 사용됩니다.
NapCat 프레임워크 설치

6.2 NapCat 설치

NapCat은 OpenClaw가 QQ 계정을 통해 메시지를 보내고 받을 수 있도록 하는 타사 QQ 봇 프레임워크입니다.

**도커란 무엇인가요? ** Docker는 환경 구성 문제를 방지하는 데 필요한 모든 종속성을 갖춘 소프트웨어를 패키징하고 실행할 수 있는 "컨테이너" 기술입니다. Docker를 설치하지 않은 경우 Docker 官方安装指南을 참조하거나 이 방법을 건너뛰고 위의 공식 기본 액세스를 사용할 수 있습니다.

Docker를 사용한 설치(권장):

bash

docker run -d \
  --name napcat \
  -p 3001:3001 \
  -v $(pwd)/napcat/config:/app/napcat/config \
  mlikiowa/napcat-docker:latest

시작 후 http://localhost:3001을 방문하여 WebUI에 진입하고 QQ 계정을 사용하여 QR 코드를 스캔하여 로그인하세요.

WebSocket 서비스 구성:

NapCat 구성(일반적으로 config/onebot11_<QQ号>.json)에서 WebSocket을 활성화합니다.

json

{
  "ws": {
    "enable": true,
    "host": "0.0.0.0",
    "port": 3001
  }
}

6.3 OpenClaw QQ 플러그인 설치

bash

openclaw plugins install @izhimu/qq

6.4 OpenClaw 구성

방법 1: 대화형 구성

bash

openclaw onboard

메시지가 나타나면 NapCat의 WebSocket 주소를 입력하세요.

방법 2: 수동 구성

bash

openclaw config set channels.qq.wsUrl "ws://127.0.0.1:3001"
openclaw config set channels.qq.enabled true

6.5 서비스 시작

bash

openclaw gateway restart

6.6 연결 테스트

QQ의 로봇 계정에 "안녕하세요"라는 메시지를 보냅니다. 답변을 받으시면 접속이 성공한 것입니다.

6.7 지원되는 기능

✅ 비공개 메시지 보내기 및 받기
✅ 그룹 채팅 메시지(@bot 필요)
✅ 사진, 파일, 음성
✅ 메시지 답장
✅ 자동 재연결

6.8 FAQ

연결 실패: NapCat이 정상적으로 실행되고 있는지 확인하고 WebSocket 주소가 올바른지 확인하세요.

메시지에 대한 응답이 없습니다: QQ 로그인이 완료되었는지 확인하고 openclaw config get channels.qq 구성을 확인하세요.

공식 액세스와 NapCat 비교

특징	官方原生接入	NapCat 액세스
구성 난이도	⭐ 단순함(1장 참조)	⭐⭐⭐ 단지
안정성	⭐⭐⭐ 공식 지원	⭐⭐ 제3자에 의존
기능 풍부	⭐⭐ 기본 기능	⭐⭐⭐ 완전한 기능
음성 메시지	❌	✅
계정 한도	5개의 로봇/계정	무제한

권장사항: 대부분의 사용자는 第一章의 공식 기본 액세스를 사용할 수 있습니다. NapCat은 음성 메시지가 필요하거나 계정 제한이 없는 고급 사용자에게 적합합니다.

7. QClaw: Tencent의 공식 원클릭 시작 솔루션

수동 액세스 방식 외에도 Tencent는 OpenClaw용 원클릭 시작 패키지인 QClaw도 출시하여 기본 지식이 없는 사용자도 Crayfish를 쉽게 배포하고 사용할 수 있도록 했습니다.

7.1 QClaw 핵심 기능

원클릭 로컬 배포: 복잡한 구성이 필요하지 않으며 OpenClaw를 로컬 컴퓨터에 쉽게 배포할 수 있습니다.
WeChat 다이렉트 연결: Feishu, DingTalk, QQ 외에도 개인 위챗 다이렉트 대화가 지원됩니다.
하이브리드 라우팅 모델: 다수의 국내 인기 모델을 통합하여 최적의 모델을 지능적으로 선택
사전 제작된 실무 기술:
- 컴퓨터와 휴대폰을 원격으로 제어하여 원격으로 작업할 수 있습니다.
- 팔로어 증가를 위한 소셜 미디어 자동 운영
- GitHub 프로젝트 자동 개발

7.2 사용 시나리오 예

소셜 미디어 운영: Lobster가 자동으로 Xiaohongshu 메모를 보내고 인기 게시물과 상호 작용하여 트래픽을 유도하도록 합니다.

스마트 팔로우: Lobster가 플랫폼에서 Claw 제품 블로거를 찾은 다음 자동으로 팔로우하고 요약을 제공합니다.

GitHub 자동 개발: 클릭하면 Lobster가 로컬에서 브라우저를 실행하고 GitHub에 자동으로 로그인하여 웨어하우스를 생성하고 코드를 제출합니다.

7.3 획득 방법

📢 내부 베타 단계: QClaw는 현재 내부 베타 단계에 있습니다. 초대코드는 관련 커뮤니티에서 받으실 수 있습니다. 정식 출시 후 최대한 빨리 공지해드리겠습니다.

자세한 내용은 QClaw 官网을 방문하세요.

다음 단계:第四章自动化任务入门

第三章 移动端接入 ​

1. 为什么需要移动端接入 ​

选哪个平台？ ​

2. 飞书接入（推荐企业用户） ​

2.1 飞书官方插件（强烈推荐） ​

2.2 前置准备 ​

2.3 创建飞书应用 ​

2.4 配置应用权限 ​

2.5 配置事件订阅 ​

2.6 安装飞书插件并配置 ​

2.7 发布应用 ​

2.8 配对授权 ​

2.9 常见问题 ​

3. Telegram 接入（推荐个人用户） ​

3.1 创建 Telegram Bot ​

3.2 配置 OpenClaw ​

3.3 配对验证 ​

3.4 开始使用 ​

3.5 Telegram 的独特优势 ​

3.6 常见问题 ​

4. 使用技巧 ​

4.1 命令快捷方式 ​

4.2 文件传输 ​

4.3 语音输入 ​

4.4 安全建议 ​

4.5 多渠道协同 ​

5. 실제 사례 ​

5.1 출퇴근길 응급상황 대처 ​

5.2 회의 중 빠르게 보고서 생성 ​

5.3 여행 중 서버 관리 ​

6. QQ 고급 액세스 ​

NapCat 액세스 ​

6.1 준비 ​

6.2 NapCat 설치 ​

6.3 OpenClaw QQ 플러그인 설치 ​

6.4 OpenClaw 구성 ​

6.5 서비스 시작 ​

6.6 연결 테스트 ​

6.7 지원되는 기능 ​

6.8 FAQ ​

공식 액세스와 NapCat 비교 ​

7. QClaw: Tencent의 공식 원클릭 시작 솔루션 ​

7.1 QClaw 핵심 기능 ​

7.2 사용 시나리오 예 ​

7.3 획득 방법 ​

第三章移动端接入

1. 为什么需要移动端接入

选哪个平台？

2. 飞书接入（推荐企业用户）

2.1 飞书官方插件（强烈推荐）

2.2 前置准备

2.3 创建飞书应用

2.4 配置应用权限

2.5 配置事件订阅

2.6 安装飞书插件并配置

2.7 发布应用

2.8 配对授权

2.9 常见问题

3. Telegram 接入（推荐个人用户）

3.1 创建 Telegram Bot

3.2 配置 OpenClaw

3.3 配对验证

3.4 开始使用

3.5 Telegram 的独特优势

3.6 常见问题

4. 使用技巧

4.1 命令快捷方式

4.2 文件传输

4.3 语音输入

4.4 安全建议

4.5 多渠道协同

5. 실제 사례

5.1 출퇴근길 응급상황 대처

5.2 회의 중 빠르게 보고서 생성

5.3 여행 중 서버 관리

6. QQ 고급 액세스

NapCat 액세스

6.1 준비

6.2 NapCat 설치

6.3 OpenClaw QQ 플러그인 설치

6.4 OpenClaw 구성

6.5 서비스 시작

6.6 연결 테스트

6.7 지원되는 기능

6.8 FAQ

공식 액세스와 NapCat 비교

7. QClaw: Tencent의 공식 원클릭 시작 솔루션

7.1 QClaw 핵심 기능

7.2 사용 시나리오 예

7.3 획득 방법