前言:
最近被朋友圈里各种“养龙虾”的截图刷屏了——这里的“龙虾”指的就是OpenClaw，一个开源的AI智能体框架。简单说，它就是一个能真正帮你干活的AI助手，不只是聊天，还能操作电脑、管理文件、调用各种工具。
官方对Windows原生环境并不算友好，网上教程大多针对Mac或云服务器。
这里我也是成功在本地安装openclaw并接入QQ(且能操作电脑进行一些简单的命令如创建,删除文件),过程有些波折,在这里记录一下。
一.前置环境
网上有教程(这里不再赘述)
Node.js的版本必须大于等于v22.0.0
安装好后打开cmd输入以下命令并运行,查看是否符合要求
node -v
npm -v
输出示例:
二.安装并配置openclaw
win+r输入cmd ,ctrl+shift+enter(以管理员身份打开cmd)输入如下命令
npm install -g openclaw@latest
openclaw –version
由于我已经安装过了(这里不附加示例输出),安装成功后查看版本结果应如上类似
继续输入如下命令
openclaw onboard
(这里失败可能是输入有误或者是openclaw安装失败)
跳出如下选项
选择yes(<-键还有 ->选择,enter)
选择QuickStart
选择Use existing values
这里我选择的是Qwen(选择的话是免费的,但是每天有一定的对话次数,如果需要不限次的话需引入第三方API,这里我用的是dmxapi,api-key统一,而且注册就免费很省事,后面有相关配置),然后会进入登录状态,如果没有需要注册点击确认即可
选择Keep current
后面的两选项全选skip for now
选择No
按空格选择skip for now,enter
我第一次配置时已经安装了,这里选择Restart
这里选择Open the Web UI
打开后会跳出如上网页,可以进行对话
(如果打不开,可能是没有开启管理员模式,或者防火墙设置)
1)利用管理员身份进入cmd并重新进行上述配置
2)防火墙设置(一般不会有问题)
打开“控制面板” > “Windows Defender 防火墙” > “启用或关闭 Windows Defender 防火墙” > 选择“关闭” （测试完后记得重新打开）。 如果关闭后能正常访问，则需要为网关程序添加防火墙允许规则。
3)检查端口
netstat -ano | findstr :18789
如果有对应进程,杀掉再重来
4)重新安装gateway
如果网关启动总是失败，可以尝试卸载并重新安装服务：
bash
openclaw gateway uninstall
然后在管理员 PowerShell 中重新运行 onboard，或者单独安装网关：
bash
openclaw gateway install
安装成功后，再启动并检查状态。
另外这里需要注意这个文件的位置:
后续还需要进行修改
三.创建QQ机器人
1）打开QQ开放平台官网,注册(首次注册需要人脸,扫码,手机号,且扫码的qq号必须绑定的是输入的手机号)并登录
创建一个机器人
随便输入即可(不违规)
创建成功后会有如下机器人信息出现,点击开发中
进入到这个页面,需要先保存APPID还有机器人密钥,第一次查看就需要点击生成(不支持明文展示,忘记了只会重新生成,且原来的密钥失效)
扫码后复制粘贴保存到一个安全的位置
四.安装qqbot插件并接入
管理员身份打开cmd
运行
openclaw plugins install @sliverp/qqbot@latest
安装完成后
继续输入
openclaw channels add –channel qqbot –token "AppID:AppSecret"
AppID对应刚刚要求保存的机器人的ID
AppSecret就是机器人密钥
在QQ开放平台机器人管理界面选择沙箱配置
扫码添加成员
添加使用机器人就可以进行对话了
(注意到此时它还不能操作电脑文件)
其他配置
1)注意到没有直接创建文件的权限,这是因为新版openclaw降低了权限,需要对openclaw配置进行调整
根据之前留意的文件~/.openclaw/openclaw.json文件
"tools": {
"profile": "messaging",
"web": {
"search": {
"enabled": true
},
"fetch": {
"enabled": true
}
}
},
找到tools将messaging改成full
然后再重新启动网关
openclaw gateway restart
即可
2)对话频次多了之后发现出现如下问题(Qwen每天有一定额度)
可以改用第三方API
登录注册DMXAPI
https://www.dmxapi.cn/
复制这个API
然后还是要修改~/.openclaw/openclaw.json文件
有三个地方需要注意
1)如果是按照千问-auth方式的话，把auth注释掉
2）
"qwen-portal": {
"baseUrl": "https://portal.qwen.ai/v1",
"apiKey": "qwen-oauth",
"api": "openai-completions",
"models": [
{
"id": "coder-model",
"name": "Qwen Coder",
"reasoning": false,
"input": [
"text"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 8192
},
{
"id": "vision-model",
"name": "Qwen Vision",
"reasoning": false,
"input": [
"text",
"image"
],
"cost": {
"input": 0,
"output": 0,
"cacheRead": 0,
"cacheWrite": 0
},
"contextWindow": 128000,
"maxTokens": 8192
}
]
}
改为
"dmxapi": {
"baseUrl": "https://www.dmxapi.cn/v1",
"apiKey": "复制的API-KEY",
"api": "openai-completions",
"models": [
{
"id": "任选一个模型模型",
"name": "任选一个模型",
"contextWindow": 32768,
"maxTokens": 8192
}
]
}
填入刚刚复制的API_KEY
再在模型价格免费模型里面随便选择一个,这里我选择了第二个
复制填入
3)
"agents": {
"defaults": {
"model": {
"primary": "qwen-portal/coder-model"
},
"models": {
"qwen-portal/coder-model": {
"alias": "qwen"
},
"qwen-portal/vision-model": {}
},
"workspace": "C:\\\\Users\\\\cal17\\\\.openclaw\\\\workspace",
"compaction": {
"mode": "safeguard"
},
"maxConcurrent": 4,
"subagents": {
"maxConcurrent": 8
}
}
},
priamary这里改为"dmxapi/你选择的模型"
保存文件后
cmd命令行输入openclaw gateway restart就大功告成了(由于模型是免费的,高峰期会有些慢)
总的成果如下
模型免费(如果使用付费api只需要修改对应的模型名字即可,利用dmxapi的情况下)
