【小龙虾/OpenClaw安装】openclaw各系统详细安装教程（含QQ机器人对接）

最新推荐文章于 2026-06-15 19:31:22 发布

原创最新推荐文章于 2026-06-15 19:31:22 发布 · 1.5k 阅读

15 ·

本内容遵循CC 4.0 BY-SA版权协议

GEO检测

标签

#机器人 #openclaw #ai #龙虾 #养龙虾

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏，讲透 AI 如何接管脏活累活

一键订阅

openclaw详细安装教程

本文参考openclaw官方文档：https://docs.openclaw.ai/zh-CN

适配系统：Windows/macOS/Linux/ 树莓派

OpenClaw 是一款跨平台的 AI 智能体 Gateway 网关，核心实现「聊天应用 + AI 智能体」的无缝连接，支持 WhatsApp/Telegram/Discord/QQ 等多渠道交互，本地部署、隐私可控，本文参照个人实操与官方标准编写，兼顾快速上手与基础配置。

一、前置条件

核心环境：Node.js 20.x 及以上版本（官方推荐 22.x LTS），需提前安装并配置环境变量
包管理器：npm 9.x+ /pnpm/yarn（推荐 npm，与官方命令完全兼容）
网络要求：可访问外网（部分依赖包需从 GitHub 下载，必要时配置网络代理）
权限要求：Windows 需以管理员身份运行终端，macOS/Linux 可根据需要添加 sudo

快速检查环境
打开终端 / 命令行执行以下命令，验证 Node.js 安装成功：

# 检查 Node.js 版本
node --version
# 检查 npm 版本
npm --version

若未安装 Node.js，可前往官方官网【https://nodejs.org/zh-cn/download】下载对应系统版本，一键安装即可（默认自动配置环境变量）。

二、核心安装步骤

1. 全局安装 OpenClaw

执行官方一键安装命令，自动下载并安装最新版本：

npm install -g openclaw@latest
# 可选：使用 pnpm 安装（速度更快）
# pnpm add -g openclaw@latest

系统专属快捷安装（可选）
macOS/Linux：官方提供一键安装脚本，自动检测并配置环境

curl -fsSL https://openclaw.ai/install.sh | bash

Windows(PowerShell)：专属一键安装脚本

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

2. 新手引导 + 安装后台服务（核心步骤）

执行官方引导命令，完成交互式配置+系统守护进程安装，让 OpenClaw 支持后台自动运行：

openclaw onboard --install-daemon

引导流程关键操作

安全提示：选择 YES 确认继续
配置模式：选择 QuickStart（快速开始，官方推荐）
模型提供商：选择已拥有 API Key 的平台（如 OpenAI/DeepSeek/ 千问 Qwen），或选 Custom Provider 自定义，无 API Key 可暂时跳过
聊天渠道配置：按需选择 WhatsApp/Telegram 等，无需求直接选 Skip for now（后续可补充配置）
技能 / 钩子配置：新手建议选 NO 暂时跳过，后期在 Web 界面配置
最终选择：推荐选 Open the web UI，自动打开浏览器控制界面

3. 配对聊天渠道（以 WhatsApp 为例，官方默认）

完成引导后，执行官方命令配对聊天渠道，实现「聊天软件发指令控制 AI」：

# 登录并配对渠道（支持 WhatsApp/Telegram 等，终端会生成二维码，手机扫码即可）
openclaw channels login

扫码成功即完成渠道绑定，后续可直接通过该聊天软件向 OpenClaw 发送指令。

4. 启动 Gateway 网关（OpenClaw 核心服务）

执行官方命令启动网关，指定默认端口（官方标准端口 18789）：

openclaw gateway --port 18789

启动成功提示：终端显示「Gateway running on http://127.0.0.1:18789」即代表网关启动完成。

三、打开 Web 控制界面（官方仪表板）

Gateway 网关启动后，直接在浏览器访问以下地址，进入官方可视化控制界面，实现聊天管理 / 配置修改 / 会话监控 / 模型管理等所有操作：
本地默认地址

http://127.0.0.1:18789/

快捷打开命令
终端执行以下命令，自动唤起浏览器并打开仪表板：

openclaw dashboard

仪表板核心功能

聊天窗口：直接与 AI 智能体对话，下达本地操作指令
模型配置：添加 / 修改 AI 模型 API 信息，支持多模型切换
渠道管理：新增/ 解绑 WhatsApp/Telegram 等聊天渠道
会话管理：查看 / 清空会话记录，按发送者隔离会话

四、基础配置（官方标准，可选）

OpenClaw 所有配置文件统一存放在用户主目录，无需修改即可默认运行，如需个性化配置（如限制访问、群组规则），可编辑官方指定配置文件。

1. 配置文件路径

~/.openclaw/openclaw.json
Windows 路径：C:\Users\你的用户名.openclaw\openclaw.json
macOS/Linux 路径：/Users/你的用户名/.openclaw/openclaw.json

2. 官方推荐基础配置示例（限制访问 + 群组规则）

编辑 openclaw.json，添加白名单和群组提及规则，防止陌生人非法访问：

{
  "channels": {
    "whatsapp": {
      "allowFrom": ["+8613800000000"], // 仅允许该手机号发送指令（替换为自己的号码）
      "groups": { "*": { "requireMention": true } } // 所有群组需@openclaw才会响应
    }
  },
  "messages": { 
    "groupChat": { "mentionPatterns": ["@openclaw"] } // 群组唤醒关键词
  }
}

修改后重启网关即可生效：

openclaw gateway restart

五、网关服务常用命令（官方标准）

Gateway 是 OpenClaw 的核心，官方提供了一系列命令实现网关的状态查看 / 重启 / 安装为系统服务等操作，常用命令如下：

# 查看网关当前状态（运行/关闭）
openclaw gateway status
# 重启网关（配置修改后必备）
openclaw gateway restart
# 将网关安装为系统服务（开机自启，官方推荐）
openclaw gateway service install
# 停止网关服务
openclaw gateway stop
# 前台启动网关（指定端口+绑定局域网，支持局域网内其他设备访问）
openclaw gateway --port 18789 --bind lan

六、扩展：接入 QQ 机器人（官方合作渠道，腾讯一键支持）

OpenClaw 与腾讯 QQ 官方合作，支持1 分钟扫码创建 QQ 机器人，实现 QQ 端发指令控制 AI，步骤如下：

1.访问 QQ 开放平台：https://q.qq.com/qqbot/openclaw/login.html，手机 QQ
扫码登录（需实名登记）

2.点击「创建机器人」，自动生成机器人 Token（保存好，后续需用）

3.终端执行以下3条命令（官方预设，直接复制粘贴）：

# 安装 QQBot 插件
openclaw plugins install @sliverp/qqbot@latest
# 绑定 QQ 机器人（替换为自己的 Token）
openclaw channels add --channel qqbot --token "你的机器人Token"
# 重启网关生效
openclaw gateway restart

完成后即可在 QQ 中向机器人发送指令，支持图文 / 语音 / 文件等多媒体消息。

七、状态检查与故障排查（官方工具）

OpenClaw 提供内置命令，快速检查系统环境、配置文件、网关服务是否正常，新手遇到问题优先执行：

# 快速查看 OpenClaw 整体状态（网关/模型/渠道）
openclaw status
# 全面健康检查（检测依赖/配置/网络问题，官方推荐故障排查命令）
openclaw doctor

若检查提示错误，可根据终端输出的错误码 / 提示信息，对照官方文档或网络搜索解决方案。

八、官方安全建议（必看）

严禁公网暴露：默认网关仅绑定 127.0.0.1，如需远程访问，使用 Tailscale 等零信任 VPN，切勿在路由器做端口映射
不使用root / 管理员权限长期运行：防止 AI 执行危险命令，建议创建普通权限账号运行
设置 API 额度限制：在OpenAI/DeepSeek 等模型平台设置账单硬限额，避免恶意调用产生高额费用
及时更新版本：执行 npm update -g penclaw 保持版本最新，修复已知安全漏洞

九、Docker 安装方式（官方推荐，安全沙箱）

若需隔离运行 / 24 小时后台值守，官方提供 Docker 镜像，一行命令启动（需提前安装 Docker）：

docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  openclaw/openclaw:latest

Docker 方式自动包含所有依赖，无需手动配置 Node.js 环境，适合服务器 / 树莓派部署。

AI 时代程序员必备技能

Codex、Claude Code、Cursor、Hermes Agent、OpenClaw等工程化实战专栏，讲透 AI 如何接管脏活累活

一键订阅