三、远程召唤龙虾

OpenClawd的基础配置完成后，接下来让它连上你的聊天工具——这样你随时随地发一条消息，它就能在电脑上帮你干活。

选哪个平台？

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

对比维度	QQ（本章第 1 节）	飞书
适合谁	个人用户、学生	企业用户、团队协作
接入难度	⭐ 最简单	⭐⭐ 需创建企业应用
消息功能	文字、图片	文字、图片、文件、富文本
独特优势	国内用户最多，配置最简单	深度集成文档/日历/表格，可作为"数字分身"
网络要求	无特殊要求	无特殊要求
群聊支持	✅ 需 @机器人	✅ 需 @机器人
多平台同时接入	✅	✅

建议：

• 还没接过任何平台？从 QQ 开始，最简单
• 公司用飞书办公？强烈推荐接入飞书，能帮你操作文档、日历、多维表格
• 追求最大灵活性？Telegram 的 API 最开放，无消息审核，适合开发者

OpenClaw 支持同时接入多个平台，你可以在 QQ 和朋友聊天、在飞书处理工作、在 Telegram 做开发——它们共享同一个 AI 大脑。

---

1. QQ 机器人（推荐国内用户）

腾讯 QQ 于 2026 年 3 月 7 日正式开放 OpenClaw 官方原生接入——个人免费、一键创建、无需编写代码。

1.1 注册并创建机器人

打开 QQ 开放平台 OpenClaw 接入页面，使用手机 QQ 扫描二维码完成注册登录：

登录后点击"创建机器人"，设置机器人名称和头像。创建完成后，系统会生成 AppID 和 AppSecret，并显示部署指引：

重要：出于安全考虑，AppSecret 不支持明文保存，二次查看将会强制重置，请立即复制并妥善保存。

1.2 安装配置

按照部署页面的指引，在终端依次执行官方给出的命令就完成了

1.3 开始聊天

回到浏览器的部署页面，点击"扫描聊天"按钮，用手机 QQ 扫码即可找到你的机器人。试着发一条消息：

恭喜！你已经拥有了自己的 QQ AI 助手。

你也可以直接在手机 QQ 中搜索机器人名称来找到它。

常见问题

Q: QQ 机器人没有响应？

A: 检查以下几点：

1. Gateway 是否在运行：openclaw status
2. QQ 渠道是否配置成功：openclaw channels status
3. Token 格式是否正确（AppID:AppSecret）
4. 尝试重启：openclaw gateway restart

---

2. 飞书接入

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

• 已完成OpenClaw的安装、基础配置，OpenClaw 正在运行（openclaw status 显示正常）
• 拥有飞书账号

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

第一步：登录飞书开放平台

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

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

1. 点击"创建企业自建应用"
2. 填写应用名称（如"OpenClaw 助理"）、描述、选择图标
3. 点击"创建"进入应用详情页

第三步：获取应用凭证

进入"凭证与基础信息"页面，复制 App ID（格式 cli_xxx）和 App Secret。

重要：App Secret 务必立即复制保存，不要泄露给他人。

第四步：配置权限

进入"权限管理"页面，点击"批量导入"按钮，粘贴以下 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"
    ]
  }
}

批量导入会自动开通消息收发、云文档、多维表格、日历、任务等完整能力。

这些权限分别做什么？

权限类别	代表权限	用途
消息（im:）	im:message、im:message:send_as_bot、im:resource	收发消息、图片、文件
联系人（contact:）	contact:user.base:readonly	获取用户基础信息
云文档（docx:/docs:）	docx:document:create、docx:document:readonly	创建和读取飞书文档
多维表格（base:）	base:record:create、base:table:read	操作多维表格数据
日历（calendar:）	calendar:calendar.event:create、calendar:calendar.event:read	管理日程
任务（task:）	task:task:read、task:task:write	创建和管理飞书任务
知识库（wiki:）	wiki:node:read、wiki:space:read	读写飞书知识库
云空间（drive:/space:）	drive:file:upload、drive:file:download	上传下载文件

如果你只需要基础聊天功能，最少只需 im:message、im:message.p2p_msg:readonly、im:message.group_at_msg:readonly、im:message:send_as_bot、im:resource 这几个消息相关权限即可。但建议导入完整权限以获得最佳体验。

导入权限后，点击"提交审核"。如果你是企业管理员可直接通过；否则需联系管理员审核。

第五步：启用机器人能力

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

1. 开启机器人能力
2. 设置机器人显示名称（如"OpenClaw 助理"）

第六步：配置事件订阅

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

1. 选择"使用长连接接收事件"（WebSocket 模式）
2. 添加事件：im.message.receive_v1（接收消息事件）

什么是"长连接"？为什么推荐？

传统的 webhook 方式需要你有一个公网可访问的地址，飞书把消息推送过来。而长连接（WebSocket）是反过来的——OpenClaw 主动连接飞书服务器并保持连接，消息实时送达。

好处：不需要公网 IP、不需要域名、不需要端口映射，家用网络就能用。这也是 OpenClaw 的默认推荐方式。

第七步：发布应用

1. 进入"版本管理与发布"
2. 点击"创建版本"，填写版本号和更新说明
3. 提交审核并发布
4. 等待管理员审批（企业自建应用通常自动通过）

第八步：在 OpenClaw 中添加飞书渠道

飞书应用创建完成后，回到终端，将飞书渠道添加到 OpenClaw。

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

openclaw channels add

按交互式提示操作：

1. 选择 "Feishu/Lark (飞书)"
2. 输入 App ID 和 App Secret
3. 其他选项保持默认即可

方式二：通过配置向导添加

如果你刚安装完 OpenClaw、还没完成过初始配置，可以运行：

openclaw onboard

向导会引导你完成模型配置和渠道添加。

添加完成后，重启网关使配置生效：

openclaw gateway restart

验证网关状态：

openclaw gateway status

手动编辑配置文件（高级）

编辑 ~/.openclaw/openclaw.json（Windows：C:\Users\你的用户名\.openclaw\openclaw.json）：

{
  "channels": {
    "feishu": {
      "enabled": true,
      "connectionMode": "websocket",
      "dmPolicy": "pairing",
      "accounts": {
        "main": {
          "appId": "cli_xxx",
          "appSecret": "你的App Secret"
        }
      }
    }
  }
}

修改后运行 openclaw gateway restart 生效。

注意顺序：先完成此步骤（添加渠道 + 启动网关），再回到飞书开放平台配置事件订阅（第六步）。网关未运行时，长连接设置会保存失败。

第九步. 配对与首次对话

1. 发送测试消息

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

2. 获取配对码

机器人会回复一个配对码（8 位大写字母数字），表示有新用户请求对话。

什么是"配对"（Pairing）？

配对是 OpenClaw 的安全机制——不是任何人给你的机器人发消息都能得到回复。默认情况下，新用户发消息时会收到一个配对码，只有你在终端批准后，该用户才能正常对话。

这防止了陌生人滥用你的 AI 助手（毕竟每次对话都消耗你的模型 API 额度）。

配对码特点：

• 8 位字符，大写字母和数字，不含易混淆字符（如 0/O、1/I）
• 1 小时后过期
• 每个渠道最多 3 个待批准请求

3.批准配对

在终端执行：

openclaw pairing approve feishu <配对码>

把 <配对码> 替换成你实际收到的码，例如 openclaw pairing approve feishu 6KKG7C7K。

你也可以在 OpenClaw Web 控制面板（openclaw dashboard）中点击批准按钮。

3. 开始对话

配对成功后，回到飞书再给机器人发一条消息，它就能正常回复了！试试：

你好，请介绍一下你自己

恭喜！你的飞书 AI 助手已经上线。日常使用直接在飞书中和机器人对话即可，无需额外操作。

群聊中使用

除了私聊，你还可以把机器人拉进飞书群聊，让团队成员共同使用。

基本规则：在群聊中需要 @机器人 才会触发回复，避免在群里刷屏。

群聊访问控制

OpenClaw 通过 groupPolicy 控制群聊行为：

策略	行为
"open"	允许所有群聊，仍需 @提及才回复
"allowlist"	仅允许白名单中的群（默认）
"disabled"	禁用所有群聊消息

配置示例：

# 允许所有群聊
openclaw config set channels.feishu.groupPolicy "open"

# 设置某个群不需要@就回复
openclaw config set channels.feishu.groups.<群ID>.requireMention false

群聊中每个群拥有独立的会话——群里的对话不会影响你和机器人的私聊记录。

私聊访问策略（dmPolicy）

dmPolicy 控制谁能通过私聊使用你的机器人：

策略	行为
"pairing"	默认。新用户需配对码批准
"allowlist"	仅允许 allowFrom 列表中的用户
"open"	允许所有人（需在 allowFrom 中设置 "*"）
"disabled"	禁用私聊

常见问题

Q: 事件订阅保存失败？

A: 请确保已先运行 openclaw channels add 添加飞书渠道，且网关处于运行状态（openclaw gateway status 显示正常）。长连接模式要求网关在线才能注册。

Q: 机器人没有回复？

A: 逐步排查：

1. 网关是否运行：openclaw status
2. 飞书渠道是否已添加：检查openclaw.json 中的channels.feishu 配置
3. 是否已完成配对：openclaw pairing list feishu
4. 查看实时日志定位错误：openclaw logs --follow
5. 重启网关重试：openclaw gateway restart

Q: 权限审核不通过？

A: 联系飞书企业管理员审批。个人用户创建的应用通常会自动通过，无需额外审批。

Q: 配置修改后不生效？

A: 修改配置后必须重启网关：openclaw gateway restart。

Q: 群聊中 @了机器人但没反应？

A: 检查 groupPolicy 是否为 "disabled"；如果是 "allowlist"，确认该群的 ID 已加入白名单。