«

OpenClaw 小白部署全攻略：附带接入QQ/飞书机器人教程

myluzh 发布于 阅读：11834 NOTES

0x01 前言

OpenClaw 曾用名（Clawdbot、Moltbot）。都是同一个东西，只是作者一直在改这个项目的名称，但是他的图标一直没变，所以我们习惯把他叫做“小龙虾”。

这两天 OpenClaw 突然在技术圈刷屏了。作者 Peter 把它定义为“生活助理”，本质上就是把 聊天软件、Claude Code 强大的编程能力，以及你自己的本地运行环境打通了。

它之所以能引爆社区，不光是因为“代码 100% 由 AI 生成”的噱头，更在于它展现了一种理想的 “人机协作” 范式：OpenClaw 直接运行在你掌控的环境（本地服务器/电脑）中，拥有完整的操作权限和超长记忆。这意味着它是一个真正私有、数据不外流的 Personal Agent，交互却像跟同事聊微信一样简单。

权限太高是一把双刃剑。 目前社区的一致共识是：千万别在主力生产力电脑上 “裸奔”。为了数据安全，强烈建议把它部署在强隔离的环境下，比如闲置的 Mac 或者 Linux 云服务器。

0x02 安装 OpenClaw

Linux/macOS 一键安装

1、 一键安装

# 适用于 Linux，支持大多数发行版。🦞 支持 Ubuntu、Debian、Fedora、Arch 等。
curl -sSL https://openclaw.ai/install.sh | bash

2、运行引导程序，进行初始化配置
官方手册：https://docs.openclaw.ai/start/getting-started

安装之前需要有大模型供应商，我这边选的是智谱GLM，你也可以点此注册智谱开放平台账号，点此链接注册的新用户赠送 2000 万 Token 额度。注册完成后，获取 API Key：在个人中心页面，点击 API Keys，创建一个新的 API Key，然后在后续安装的时候填入这个key就行了。

#  初始化与配置 运行引导程序，它会帮助你配置 API Key 和所需的适配器（Adapter）这是最快的上手方式，适合在个人快速上手体验。
myluzh@myluzhMacBookPro ~ % openclaw onboard --install-daemon
# 此处省略...按照提示一步步配置下去

# 3启动服务 配置完成后，启动 openclaw：
openclaw gateway start

# # 其他命令
# 查看gateway状态
openclaw gateway status

完成安装后，你就可以打开Web UI http://127.0.0.1:18789/?token=your_login_token 进行测试对话了。

最后我想说的是，你如果觉得GLM大模型好用，配合上你的openclaw拥有了私人助手，那么可以考虑购买GLM订阅，因为实在是太便宜了，优惠就剩最后一周了，我已经购买了 GLM 订阅套餐，我也推荐你购买。性价比实在是太高了。而且套餐内就算最低的用量，基本上也用不完，量大管饱还便宜！GLM 订阅计划 优惠 20%，只剩最后一周！还没买的抓紧了！

Docker方式部署

OpenClaw 的 Docker 安装指南：https://docs.openclaw.ai/install/docker
使用 Docker 安全运行 OpenClaw（MoltBot、ClawdBot）：面向初学者的实用指南：https://medium.com/p/94112a9b57be 

# 运行 openclaw-gateway (后台守护进程)
docker run -d \
    --name openclaw-gateway \
    --init \
    --restart unless-stopped \
    -p 18789:18789 \
    -p 18790:18790 \
    -v ~/.openclaw:/home/node/.openclaw \
    -v ~/.openclaw/workspace:/home/node/.openclaw/workspace \
    -e HOME=/home/node \
    -e TERM=xterm-256color \
    -e OPENCLAW_GATEWAY_TOKEN=your-token \
    ghcr.io/openclaw/openclaw:main \
    node dist/index.js gateway --bind lan --port 18789

# onboard（首次配置，交互式运行完成后自动删除容器）
docker run --rm --init -it \
  -e HOME=/home/node \
  -e TERM=xterm-256color \
  -e BROWSER=echo \
  -v ~/.openclaw:/home/node/.openclaw \
  -v ~/.openclaw/workspace:/home/node/.openclaw/workspace \
  ghcr.io/openclaw/openclaw:main \
  node dist/index.js onboard --no-install-daemon

0x03 接入聊天软件（channel）配置

OpenClaw 支持同时接入多个渠道，Telegram、QQ、飞书、钉钉可以全部同时在线。每个渠道都是独立的会话。找一个你喜欢的聊天软件接入就好了，飞书和钉钉更偏办公场景，日常随手跟 AI 聊天，可以用 QQ 配置也简单。

OpenClaw 官方支持的一些聊天软件可以参考官方手册：https://docs.openclaw.ai/channels

接入飞书机器人

新版本的openclaw已经内置了飞书插件，官方教程：https://github.com/openclaw/openclaw/blob/main/docs/zh-CN/channels/feishu.md
下面我就教大家怎么一步步配置，配置会有点繁琐，耐心点按照我写的一步步进行下去。

  flowchart LR
      Start([开始]) --> Feishu1[飞书后台<br/>创建应用/配置/获取密钥]
      Feishu1 --> Server[服务器<br/>安装插件/配置/重启]
      Server --> Feishu2[飞书后台<br/>设置 Callback]
      Feishu2 --> End([完成])

      style Feishu1 fill:#00D6B9
      style Server fill:#6366F1
      style Feishu2 fill:#00D6B9

创建飞书机器人

1、进入飞书应用中心
飞书开放平台：https://open.feishu.cn/app?lang=zh-CN
2、新建企业自建应用
路径： 创建应用 → 企业自建应用；基础信息按提示填写即可（名称、描述等），完成创建后进入应用详情页。
路径： 应用能力 → 添加应用能力；添加机器人，完成后点击上方的 创建版本。

配置飞书机器人应用权限

路径：权限管理 → 批量导入权限；直接把下面的json复制进入，导入权限后点击申请开通。

{
  "scopes": {
    "tenant": [
      "aily:file:read",
      "aily:file:write",
      "application:application.app_message_stats.overview:readonly",
      "application:application:self_manage",
      "application:bot.menu:write",
      "cardkit:card:write",
      "contact:user.employee_id:readonly",
      "corehr:file:download",
      "docs:document.content:read",
      "event:ip_list",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.members:bot_access",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "im:message.p2p_msg:readonly",
      "im:message:readonly",
      "im:message:send_as_bot",
      "im:resource",
      "sheets:spreadsheet",
      "wiki:wiki:readonly"
    ],
    "user": ["aily:file:read", "aily:file:write", "im:chat.access_event.bot_p2p_chat:read"]
  }
}

获取飞书机器人调用密钥

路径：凭证与基础信息 → 应用凭证 ，将机器人的 App ID / App Secret 保存下来等下有用。

安装飞书插件

新版本已经内置飞书插件，无需手动安装，这部分可以跳过

# 查看是否已经安装了飞书插件 如果显示为空就需要安装下
root@openclaw:~# openclaw plugins list |  grep feishu
│ Feishu       │ feishu   │ loaded   │ global:feishu/index.ts                                              │ 2026.3.7 │

# 在 openclaw 运行的服务器中运行命令安装feishu插件
openclaw plugins install @openclaw/feishu

配置飞书插件

使用openclaw config配置

# appId、appSecret 需要在 飞书应用后台获取，填入你自己的
openclaw config set channels.feishu.appId "cli_xxx"
openclaw config set channels.feishu.appSecret "your_secret"
openclaw config set channels.feishu.enabled true
openclaw config set channels.feishu.connectionMode "websocket"
#  配置feishu流式输出
openclaw config set channels.feishu.streaming true
openclaw config set channels.feishu.blockStreaming true

也可以直接修改~/.openclaw/openclaw.json配置文件

  "channels": {
    "feishu": {
      "enabled": true,
      "appId": "cli_xxx",
      "appSecret": "your_secret",
      "domain": "feishu",
      "connectionMode": "websocket",
      "dmPolicy": "open",
      "allowFrom": [
        "*"
      ],
      "groupPolicy": "open",
      "streaming": true,
      "blockStreaming": true
    }
  },

OpenClaw 重载

openclaw gateway restart

设置飞书机器人Callback

一定要完成上面的步骤，最后完成这一步，要不然会提示“应用未建立长连接”。
路径：事件与回调 → 回调配置 → 定阅方式；使用长连接接受回调，然后点击保存。
路径：事件与回调 → 事件配置 → 定阅方式；使用长连接接受回调，然后点击保存。
路径：事件与回调 → 添加事件；然后选择 消息与群组 里面的 接收消息（im.message.receive_v1），缺了这一步，你给机器人发消息会没有回复。
完成后，点击上面的创建版本，发布。

现在，你就可以跟飞书机器人私聊，或者把他拉到某个群聊@它了。

插件其他参数（非必须）

你目前的配置已经够用了，其他都是可选的默认值。 参数 命令示例
enabled channels.feishu.enabled true ✅ 已配置
appId channels.feishu.appId "cli_xxx" ✅ 已配置
appSecret channels.feishu.appSecret "xxx" ✅ 已配置
domain channels.feishu.domain "feishu" 飞书中国版 (lark 为国际版)
connectionMode channels.feishu.connectionMode "websocket" 连接模式：websocket 或 webhook
dmPolicy channels.feishu.dmPolicy "pairing" 私信策略
groupPolicy channels.feishu.groupPolicy "allowlist" 群组策略
requireMention channels.feishu.requireMention true 群里是否需要 @ 机器人

示例：

# 1. 切换到 Webhook 模式
openclaw config set channels.feishu.connectionMode "webhook"
# 2. 设置群组策略为开放
openclaw config set channels.feishu.groupPolicy "open"
# 改完后记得重启网关
openclaw gateway restart

接入 QQ 机器人

腾讯专门给 OpenClaw 开了 QQ 机器人的入口。不需要自己去折腾 QQ 开放平台的审批流程，扫个码就能创建机器人。

注册 QQ 开放平台

打开腾讯专门给 OpenClaw 做的入口页面：https://q.qq.com/qqbot/openclaw/login.html 腾讯专门给 OpenClaw 用户开的简化流程。打开之后用手机 QQ 扫码登录。如果你之前没注册过 QQ 开放平台，扫码后会让你走一遍实名认证：填姓名、身份证号、手机号，然后人脸识别。整个过程跟注册微信小程序差不多，几分钟搞定。已经注册过 QQ 开放平台的直接扫码就进去了，不用重复认证。

创建 QQ 机器人

登录开放平台之后，页面上直接有个 创建机器人 按钮，点一下就完事了。这样就直接创建好了。
不需要填应用名称，不需要写描述，不需要上传图标，不需要选权限。就是点一下。然后你就有了一个 QQ 机器人。系统会自动给一个默认头像。

接入 OpenClaw

创建完成后，页面会直接给出三条命令，照着跑就行。

# 1. 安装 QQ 机器人插件
openclaw plugins install @sliverp/qqbot@latest
# 2. 配置机器人 Token（AppID:AppSecret 格式）
openclaw channels add --channel qqbot --token "102917561:你的AppSecret"
# 3. 重启 Gateway 让配置生效
openclaw gateway restart

然后就可以打开 QQ，在联系人或搜索里找到你刚创建的机器人。给它发一条消息，如果机器人正常回复了，说明通了。

0x04 workspace 目录介绍

root@openclaw:~# cd ~/.openclaw/workspace/ 
root@openclaw:~/.openclaw/workspace# tree
├── AGENTS.md        # 多智能体(Multi-Agent)配置，定义协作的其他Agent或子角色
├── feishu-tutorial.md # 飞书(Feishu)接入指南或教程文档，作为AI的外部知识库
├── HEARTBEAT.md     # 心跳机制，定义AI的定时任务、后台自动运行频率或主动唤醒逻辑
├── IDENTITY.md      # 身份设定 (AI的核心角色、基础人设和语气风格)
├── memory           # 记忆存储目录，用于存放具体任务的长期/短期上下文记录
│   └── 2026-03-09-feishu-streaming-config.md # 具体的记忆片段：某次关于飞书流式输出的配置日志/经验
├── MEMORY.md        # 记忆管理总规则，定义AI如何读取、压缩、存储和检索信息
├── SOUL.md          # “灵魂”设定，定义AI的深层价值观、底层思考框架或情感逻辑
├── TOOLS.md         # 工具库设定，列出AI被授权调用的外部插件、API或脚本能力
└── USER.md          # 用户画像，记录与AI交互的用户(你)的偏好、习惯和基础信息

0x05 导入Skills

全局skills路径

全局技能默认路径 ：/usr/lib/node_modules/openclaw/skills/,作为 Node.js 全局安装的默认路径。

自定义skills路径

强烈建议不要直接修改全局路径下的技能。最佳实践是在你的工作区创建一个专属目录（例如 ~/.openclaw/skills ），然后在配置文件~/.openclaw/openclaw.json中指定加载路径。

  "skills": {
    "load": {
      "extraDirs": [
        "~/.openclaw/skills"
      ]
    }
  },

0x06 常见问题

完全删除openclaw

# OpenClaw 官方提供了一键卸载命令，推荐先用这个，它会交互式地问你要不要保留数据、要不要删工作区。
openclaw uninstall
# 如果你确定要全删干净，直接用非交互式版本
openclaw uninstall --all --yes --non-interactive

更改模型/删除模型

# 配置新模型
openclaw configure --section model

# 查看模型列表
openclaw models list

# 切换模型
openclaw config set agents.defaults.model.primary zai/glm-4.7

# 切换后记得重启gateway
openclaw gateway restart

修改受限模式

受限模式：AI 只能使用与代码相关的工具（比如读写文件、运行 Linter）。它不会被允许去调用外部 API、搜索网络或执行系统命令。适合纯纯的“代码助手”。
全能模式：AI 将拥有完整工具访问权。它不仅能写代码，还能联网搜索（如果你配了搜索 key）、查天气、通过飞书发消息、甚至操作你授权的其他第三方插件。

# 查看当前模式
openclaw config get tools.profile
coding 
# 修改为full全能模式
openclaw config set tools.profile full

disconnected (1008): control ui requires HTTPS or localhost (secure context)

不支持直接通过 HTTP 远程访问，可以在前面加个HTTPS的反向代理，如果觉得麻烦直接在配置文件新增"allowInsecureAuth": true,"dangerouslyDisableDeviceAuth": true。

root@openclaw:~# vi ~/.openclaw/openclaw.json
 "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "lan", # loopback (默认，仅本机可访问）；lan（局域网可访问）
    "controlUi": {
      "allowedOrigins": [
        "http://localhost:18789",
        "http://127.0.0.1:18789",
        "http://172.17.10.59:18789"
      ],
      "allowInsecureAuth": true, # 新增
      "dangerouslyDisableDeviceAuth": true #新增
    },

disconnected (1008): unauthorized: gateway token mismatch

访问 Dashboard 时没有带正确的 Token，或 Token 不匹配。获取带 Token 的 URL 然后在浏览器打开。

root@openclaw:~# openclaw dashboard | grep token
Dashboard URL: http://127.0.0.1:18789/#token=586e999a940223f48d532174318d0be1e01ae7d31f0418d7

clawdbot moltbot openclaw 小龙虾 ai agent 飞书机器人 私有化部署 docker部署

正文到此结束
版权声明：若无特殊注明，本文皆为 Myluzh Blog 原创，转载请保留文章出处。
文章内容：https://itho.cn/notes/574.html
文章标题：《OpenClaw 小白部署全攻略：附带接入QQ/飞书机器人教程》
收到2条评论
avatar
下 1 个月前
错误代码 1006 gateway closed 是怎么解决的？
回复
commentator
myluzh 4 天前
@下：检查gateway日志
回复