【超详细】openclaw接入流程（QQ/飞书）

2026-05-05阅读 0热度 0

Python OpenClaw

一.配置过程

1.安装Node

第一步，需要前往Node.js官网下载安装包：https://nodejs.org/dist/v22.12.0/

选择node-v22.12.0-x64.msi这个版本进行下载。

安装完成后，打开命令行验证版本：输入node -v，如果显示v22.12.0就说明安装成功了。

这里有个关键点：node版本必须≥22.12，否则后续的openclaw安装会失败。

2.openclaw 安装引导

接下来进入openclaw的安装环节。官网地址是：OpenClaw - OpenClaw

第一步，建议用管理员身份打开PowerShell，然后输入这条命令：

iwr -useb | iex

安装完成后验证一下：输入openclaw --version。通常它会安装到"C:\Users\username\.openclaw"这个目录。

验证指令执行后，应该能看到版本信息：

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

第三步，需要到QQ开放平台创建机器人。

第一步：登录QQ开放平台的机器人列表页面。

第二步：创建机器人，获得AppID和AppSecret。

这里要特别注意：AppSecret只能查看一次，务必妥善保存。

第三步：留意页面上的接入代码，后续配置时会用到。

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

现在开始安装Gateway服务。

第一步：在以管理员身份运行的PowerShell中输入：openclaw gateway install

第二步：启动服务：openclaw gateway

第三步：检查服务状态：openclaw gateway status

第四步：打开浏览器访问http://127.0.0.1:18789，如果能看到内容就说明成功了。

5.安装QQ插件

继续在PowerShell中执行以下操作：

第一步：安装QQBot插件

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

第二步：添加QQ机器人

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

第三步：完成后重启gateway

openclaw gateway restart

6.打开网关

参考文档：入门指南 - OpenClaw

在PowerShell中输入：openclaw gateway --port 18789 --verbose

二、配置Ai模型

1.申请API Key

建议先接入一些提供免费额度的API服务：

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

Moonshot系列：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": "","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}}}}