一.配置过程

1.安装Node

step1 : https://nodejs.org/dist/v22.12.0/

在该网站下载node-v22.12.0-x64.msi

step2 : 安装完成后验证：node -v 看到 v22.12.0

💫注意：node版本必须要≥ 22.12 否则无法支撑openclaw安装

2.openclaw 安装引导

官网链接OpenClaw - OpenClaw

step1 ：打开powershell (建议以管理员身份运行）输入：

iwr -useb <https://openclaw.ai/install.ps1> | iex

step2 ：安装完后验证：openclaw --version （一般安装到"C:\Users\username\.openclaw”）

输入验证指令显示：

3.在QQ开放平台创建机器人

step1 : QQ开放平台｜机器人列表，先进行登录

step2 : 在该页面创建机器人，获得AppID和AppSecret

💫注意：保存AppSecret，只能查看一次

step3 ： 注意下面接入代码，我们后续接入会执行

4.安装Gateway（机器人通信服务）

step1 : 在以管理员身份运行的powershell中输入 openclaw gateway install

step2 : 启动该服务 openclaw gateway

step3 : 检查服务状态 openclaw gateway status

step4 : 打开浏览器http://127.0.0.1:18789，出现内容即成功

5.安装QQ插件

还是在powershell中执行

step1 ： 安装 QQBot 插件

openclaw plugins install @tencent-connect/openclaw-qqbot@latest

step2：添加 QQ 机器人

openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret”

step3 ： 完成后重启 gateway

openclaw gateway restart

6.打开网关

链接：入门指南 - OpenClaw

在powershell中输入 openclaw gateway --port 18789 --verbose

二、配置Ai模型

1.申请API Key

可以先接入一些提供免费额度的API key

Qwen系列: https://dashscope.aliyun.com

Mooshot系列：https://platform.moonshot.cn

新建API , 复制API key

2.设置环境变量

以接入qwen系列为例，对openclaw.json文件进行修改：

{
  "meta": {
    "lastTouchedVersion": "2026.3.8",
    "lastTouchedAt": "2026-03-11T08:29:09.991Z"
  },
  "wizard": {
    "lastRunAt": "2026-03-11T08:24:48.862Z",
    "lastRunVersion": "2026.3.8",
    "lastRunCommand": "configure",
    "lastRunMode": "local"
  },
  "models": {
    "mode": "merge",
    "providers": {
      "bailian": {
        "baseUrl": "<https://xxxxx.com/xxxxx-mode>",
        "apiKey": "你自己的API Key",
        "api": "openai-completions",
        "models": [
          {
            "id": "qwen-xxxx",
            "name": "qwen-xxxx",
            "reasoning": false,
            "input": [
              "text",
              "image"
            ],
            "cost": {
              "input": 0,
              "output": 0,
              "cacheRead": 0,
              "cacheWrite": 0
            },
            "contextWindow": 256000,
            "maxTokens": 8192
          }
        ]
      }
    }
  },
  "agents": {
    "defaults": {
      "model": {
        "primary": "bailian/qwen-xxxx"
      },
      "models": {
        "bailian/qwen-xxxx": {
          "alias": "qwen"
        }
      }
    }
  },
  "tools": {
    "profile": "coding"
  },
  "commands": {
    "native": "auto",
    "nativeSkills": "auto",
    "restart": true,
    "ownerDisplay": "raw"
  },
  "session": {
    "dmScope": "per-channel-peer"
  },
  "channels": {
    "qqbot": {
      "enabled": true,
      "allowFrom": [
        "*"
      ],
      "appId": "xxxxxxx",
      "clientSecret": "xxxxxxx"
    }
  },
  "gateway": {
    "port": 18789,
    "mode": "local",
    "bind": "loopback",
    "auth": {
      "mode": "token",
      "token": "你自己的token号码"
    },
    "tailscale": {
      "mode": "off",
      "resetOnExit": false
    },
    "nodes": {
      "denyCommands": [
        "camera.snap",
        "camera.clip",
        "screen.record",
        "contacts.add",
        "calendar.add",
        "reminders.add",
        "sms.send"
      ]
    }
  },
  "plugins": {
    "entries": {
      "openclaw-qqbot": {
        "enabled": true
      }
    }
  }
}

三、接入飞书

1.给 OpenClaw 安装 飞书机器人插件

openclaw plugins install feishu-openclaw

2.登录飞书开放平台

链接：飞书开放平台

step1 ： 创建一个机器人，获得APP ID和secret

3.给openclaw配置

step1 : 在powershell输入 openclaw config 进行配置选择

step 2：输入刚刚在飞书开放平台创建的飞书机器人ID和secret ,直到显示complete

💫这一步实际上改变了openclaw.json文件

step3：登录飞书开放平台，选择开发配置→权限管理→批量导入/导出权限

输入以下json文件，保存：

{
  "scopes": {
    "tenant": [
      "base:app:copy",
      "base:app:create",
      "base:app:read",
      "base:app:update",
      "base:collaborator:create",
      "base:collaborator:delete",
      "base:collaborator:read",
      "base:dashboard:copy",
      "base:dashboard:read",
      "base:field:create",
      "base:field:delete",
      "base:field:read",
      "base:field:update",
      "base:form:read",
      "base:form:update",
      "base:record:create",
      "base:record:delete",
      "base:record:read",
      "base:record:retrieve",
      "base:record:update",
      "base:role:create",
      "base:role:delete",
      "base:role:read",
      "base:role:update",
      "base:table:create",
      "base:table:delete",
      "base:table:read",
      "base:table:update",
      "base:view:read",
      "base:view:write_only",
      "bitable:app",
      "bitable:app:readonly",
      "board:whiteboard:node:create",
      "board:whiteboard:node:delete",
      "board:whiteboard:node:read",
      "board:whiteboard:node:update",
      "contact:contact.base:readonly",
      "contact:user.base:readonly",
      "contact:user.employee_id:readonly",
      "contact:user.employee_number:read",
      "contact:user.id:readonly",
      "docs:doc",
      "docs:doc:readonly",
      "docs:document.comment:create",
      "docs:document.comment:read",
      "docs:document.comment:update",
      "docs:document.comment:write_only",
      "docs:document.content:read",
      "docs:document.media:download",
      "docs:document.media:upload",
      "docs:document.subscription",
      "docs:document.subscription:read",
      "docs:document:copy",
      "docs:document:export",
      "docs:document:import",
      "docs:event.document_deleted:read",
      "docs:event.document_edited:read",
      "docs:event.document_opened:read",
      "docs:event:subscribe",
      "docs:permission.member",
      "docs:permission.member:auth",
      "docs:permission.member:create",
      "docs:permission.member:delete",
      "docs:permission.member:readonly",
      "docs:permission.member:retrieve",
      "docs:permission.member:transfer",
      "docs:permission.member:update",
      "docs:permission.setting",
      "docs:permission.setting:read",
      "docs:permission.setting:readonly",
      "docs:permission.setting:write_only",
      "docx:document",
      "docx:document.block:convert",
      "docx:document:create",
      "docx:document:readonly",
      "drive:drive",
      "drive:drive.metadata:readonly",
      "drive:drive.search:readonly",
      "drive:drive:readonly",
      "drive:drive:version",
      "drive:drive:version:readonly",
      "drive:export:readonly",
      "drive:file",
      "drive:file.like:readonly",
      "drive:file.meta.sec_label.read_only",
      "drive:file:download",
      "drive:file:readonly",
      "drive:file:upload",
      "drive:file:view_record:readonly",
      "event:ip_list",
      "im:app_feed_card:write",
      "im:biz_entity_tag_relation:read",
      "im:biz_entity_tag_relation:write",
      "im:chat",
      "im:chat.access_event.bot_p2p_chat:read",
      "im:chat.announcement:read",
      "im:chat.announcement:write_only",
      "im:chat.chat_pins:read",
      "im:chat.chat_pins:write_only",
      "im:chat.collab_plugins:read",
      "im:chat.collab_plugins:write_only",
      "im:chat.managers:write_only",
      "im:chat.members:bot_access",
      "im:chat.members:read",
      "im:chat.members:write_only",
      "im:chat.menu_tree:read",
      "im:chat.menu_tree:write_only",
      "im:chat.moderation:read",
      "im:chat.tabs:read",
      "im:chat.tabs:write_only",
      "im:chat.top_notice:write_only",
      "im:chat.widgets:read",
      "im:chat.widgets:write_only",
      "im:chat:create",
      "im:chat:delete",
      "im:chat:moderation:write_only",
      "im:chat:operate_as_owner",
      "im:chat:read",
      "im:chat:readonly",
      "im:chat:update",
      "im:datasync.feed_card.time_sensitive:write",
      "im:message",
      "im:message.group_at_msg:readonly",
      "im:message.group_msg",
      "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.urgent",
      "im:message.urgent.status:write",
      "im:message.urgent:phone",
      "im:message.urgent:sms",
      "im:message:readonly",
      "im:message:recall",
      "im:message:send_as_bot",
      "im:message:send_multi_depts",
      "im:message:send_multi_users",
      "im:message:send_sys_msg",
      "im:message:update",
      "im:resource",
      "im:tag:read",
      "im:tag:write",
      "im:url_preview.update",
      "im:user_agent:read",
      "sheets:spreadsheet",
      "sheets:spreadsheet.meta:read",
      "sheets:spreadsheet.meta:write_only",
      "sheets:spreadsheet:create",
      "sheets:spreadsheet:read",
      "sheets:spreadsheet:readonly",
      "sheets:spreadsheet:write_only",
      "space:document.event:read",
      "space:document:delete",
      "space:document:move",
      "space:document:retrieve",
      "space:document:shortcut",
      "space:folder:create",
      "wiki:member:create",
      "wiki:member:retrieve",
      "wiki:member:update",
      "wiki:node:copy",
      "wiki:node:create",
      "wiki:node:move",
      "wiki:node:read",
      "wiki:node:retrieve",
      "wiki:node:update",
      "wiki:setting:read",
      "wiki:setting:write_only",
      "wiki:space:read",
      "wiki:space:retrieve",
      "wiki:space:write_only",
      "wiki:wiki",
      "wiki:wiki:readonly"
    ],
    "user": []
  }
}

step4 ： 选择开发配置→事件与回调→添加事件

选择消息与群组，把这里所有权限打勾，点击添加

添加后会在已添加事件中看到，然后点击事件配置中的订阅方式（使用长连接）→保存

step5 ： 在powershell中打开openclaw的网关，即可

输入：openclaw gateway --port 18789 --verbose

每次使用前需要在powershell启动openclaw的网关