一、前提准备

1、下载node.js(环境要求： Node.js ≥ 22)

官网下载链接：https://nodejs.org/zh-cn/download/

安装步骤：

1）打开node.js官网>选择版本22以上的node>点击下载msi格式的安装程序

2）双击安装包打开安装向导

3）勾选接受协议>点击next

4）自定义安装路径或默认安装路径>点击next

5）默认配置>点击next

6）点击next

7）点击install

8）点击finish完成安装

9）win+R输入cmd打开命令行窗口>输出指令node -v查看node版本，输出版本号则证明安装成功

2、获取大模型API key，以阿里云百炼模型为例(共1,000,000免费额度)

1）访问阿里云百炼官网：https://bailian.console.aliyun.com/cn-beijing#/home

2）操作步骤：进入API Key页面>点击创建API Key>点击确定>复制API Key (图文教程见下图)

点击确定

点击即可复制获取API Key

3）大模型token额度查看

二、安装OpenClaw

1、调出命令行窗口

Win+R输入cmd>回车调出命令行窗口

2、下载openclaw

执行指令：npm install -g openclaw-cn@latest

3、开启部署向导

执行指令：openclaw-cn onboard --install-daemon

4、根据安装向导完成操作

步骤：选择Yes>快速开始>选择阿里云大模型>选择API key认证方式>输入你的API key>选择任意模型

三、将OpenClaw接入应用，以QQ机器人为例(可根据需求接入其他通道)

1、配置QQ机器人信息

选择QQ>安装插件>输入QQ机器人ID和密钥(获取方式见步骤2)

2、QQ机器人ID和密钥的获取

1）打开QQ开放平台官网：https://q.qq.com>选择进入龙虾专用入口

2）步骤：点击创建机器人>复制机器人ID>复制机器人密钥

配置完QQ机器人信息后>选择跳过启用钩子>空格键跳过>此时会提示网关错误，只需要执行启动网关命令即可启动小龙虾服务

3）启动OpenClaw服务网关

执行指令：openclaw-cn gateway --port 18790 --verbose 启动网关(默认端口为18989，可以修改)

访问小龙虾主页，如果系统没有自动访问小龙虾可以去浏览器手动输入访问链接：http://127.0.0.1:18790/?token=a0d7e7cd2e438e21e8cf4786d019c9151cafc5929723ab7f

QQ可以与机器人聊天

四、启动和关闭小龙虾

OpenClaw（小龙虾）的核心是 gateway 网关服务，用这几条命令就能一键启停、查看状态：

1、启动小龙虾（网关服务）

# 后台启动网关（最常用）
openclaw gateway start

# 前台启动（会一直占着终端窗口，适合调试）
openclaw gateway

# 强制启动（端口被占用时用）
openclaw gateway --force

2、关闭小龙虾（网关服务）

# 正常停止网关服务
openclaw gateway stop

# 重启（改配置后必用）
openclaw gateway restart

3、查看运行状态

# 查看网关是否在运行
openclaw gateway status

# 查看完整状态（含端口、进程）
openclaw gateway status --deep

4、常用组合（日常使用）

# 1. 先看状态
openclaw gateway status

# 2. 没运行就启动
openclaw gateway start

# 3. 打开 Web 面板
openclaw dashboard
# 或直接访问：http://127.0.0.1:18789

5、如果提示端口被占用，更换端口启动：

# 临时使用其他端口
openclaw gateway --port 18790

# 或永久修改配置
openclaw config set gateway.port 18790
openclaw gateway restart