大家都在电脑上安装了openclaw了吗？
安装OpenClaw的完整流程可以概括为 9 个步骤：
- 确认机器配置。
- 安装基础环境（Node.js + Git）。
- 获取并安装 OpenClaw。
- 启动 OpenClaw 服务。
- 运行
onboard配置向导。 - 接入大模型（云端 / 本地）。
- 给龙虾“装技能”（安装 Skills）。
- 配置对话入口（飞书、QQ、企业微信 等通道）。
- 发一条测试指令，确认开始干活。
最主要的是：
- 安装基础环境（Node.js + Git）。
- 安装 OpenClaw，常见有3条路线：脚本一键安装、Docker / docker-compose 安装、图形安装器 / 第三方一键包。
- 运行
onboard配置向导（新手必走）。 - 接入大模型。
- 安装 Skills。
- 配置对话入口（聊天网关）：QQ / 微信企业号 / 钉钉 / 飞书。
安装基础环境（Node.js + Git）是非常重要的一步。
只有这一关过了，后面一键安装OpenClaw、本地跑服务、装技能才不会到处报错。
先搞清楚：为啥一定要装 Node.js 和 Git？
没有 Node.js，OpenClaw 根本起不来；没有 Git，后面拉代码、装技能都会很麻烦。
组件用途和要求：
| 组件 | 它干嘛用 | 对OpenClaw的影响 | 最低要求 |
|---|---|---|---|
| Node.js | JavaScript 运行时环境 | 一切服务的基础，版本过低会导致程序无法运行。 | 必须 22.x 及以上 |
| npm / pnpm | 包管理器 | 管理OpenClaw及其所有依赖。 | 随Node.js自动安装即可 |
| Git | 代码版本管理工具 | 从GitHub拉取OpenClaw源码/发行包，以及后续的Skills。 | 2.x 及以上 |
配置用官方的 Node.js 22 LTS 版本。Git 则通过系统包管理器或官方安装包安装。
OpenClaw官方更推荐在Linux环境运行。所以，Windows用户的主流做法是：
安装 WSL2 (Windows Subsystem for Linux 2)，在其内部的Ubuntu系统安装Node.js和Git，再部署OpenClaw。
WSL2 + Ubuntu 安装：
（1）PowerShell，执行命令：
wsl --install -d Ubuntu-24.04（2）安装完成后重启电脑。在开始菜单打开“Ubuntu”，完成初始的用户名和密码设置。这里就不展开了，很简单的系统设置。
（3）在 WSL2 的 Ubuntu 安装 Node.js 22 和 Git：
# 1. 添加 NodeSource 源并安装 Node.js 22
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt update
sudo apt install -y nodejs git
# 2. 验证安装是否成功
node -v
npm -v
git --versionmacOS 上最省心的方式是用 Homebrew。
# 1）更新 Homebrew
brew update
# 2）安装 Node 和 Git
brew install node git
# 3）确认版本
node -v
npm -v
git --version如果之前装过老版本 Node，可以：
brew upgrade node让 Homebrew 升级到较新版本，再检查是否到 22 及以上。
常见小坑和排查思路：
| 情况 | 可能原因 | 解决办法 |
|---|---|---|
| node: command not found | 安装失败或 PATH 未更新 | 重新跑安装命令，或重启终端 / 机器；nvm 要 source ~/.bashrc |
| node -v 显示 v18 / v20 | 系统自带老版本 | 安装 nvm，用 nvm install 22 && nvm use 22，并设为默认 |
| git: command not found | 未安装 Git | sudo apt install git / brew install git / Windows 走 git-scm 安装器 |
| Windows 能在 CMD 里跑 Node，但 WSL 里找不到 | 装在 Windows 系统里了，WSL 是另一套环境 | 记住：OpenClaw 的所有安装都在 WSL 的 Linux 里进行 |
接下来是安装 OpenClaw。对于新手，推荐用官方一键脚本，简单快捷。
官方一键脚本安装适用macOS（Apple芯片 / Intel）、各种Linux（Ubuntu, Debian等）、Windows WSL2 的 Ubuntu。
自动检测Node版本、全局安装OpenClaw最新稳定版，并可选择是否自动运行onboard向导。
安装命令：
# 标准安装：包含自动运行onboard向导
curl -fsSL https://openclaw.ai/install.sh | bash
如果只想先安装程序本体，稍后再配置，可以添加参数跳过onboard：
# 仅安装程序，不运行onboard
curl -fsSL https://openclaw.ai/install.sh | bash -s --no-onboard安装完成后，会看到类似输出：
🦞 OpenClaw Installer
I run on caffeine, JSON5, and the audacity of "it worked on my machine."
✓ Detected: linux
Install plan
OS: linux
Install method: npm
Requested version: latest
[1/3] Preparing environment
✓ Node.js v22.22.1 found
· Active Node.js: v22.22.1 (/usr/bin/node)
· Active npm: 10.9.4 (/usr/bin/npm)
[2/3] Installing OpenClaw
✓ Git already installed
· Configuring npm for user-local installs
✓ npm configured for user installs
· Installing OpenClaw v2026.3.8
✓ OpenClaw npm package installed
✓ OpenClaw installed
[3/3] Finalizing setup
! PATH missing npm global bin dir: /home/flu/.npm-global/bin
This can make openclaw show as "command not found" in new terminals.
Fix (zsh: ~/.zshrc, bash: ~/.bashrc):
export PATH="/home/flu/.npm-global/bin:$PATH"openclaw onboard是一个交互式新手引导，会一步步提问，帮生成完整的配置文件（~/.openclaw/openclaw.json），并启动服务。
向导会帮完成：
- 检查Node版本和必要依赖。
- 选择要使用的大模型（云端API或本地模型）。
- 选择对话渠道（Telegram / 飞书 / QQ / Web UI 等）。
- 选择是否安装一批常用技能（Skills）。
- 把上述选择写入配置文件，并根据需要启动服务。
执行命令：
openclaw onboard --install-daemon接下来终端会出现一连串提问，只要：
- 用左、右、上、下箭头键选择选项；
- 或者直接回车接受默认值；
- 个别地方要手动粘贴 API Key / Bot Token。
不想一上来就配置各种聊天工具、技能，也可以优先把 模型接通 + 基础网关 配好；聊天通道和 Skills 可以先留空，等用顺手了再回来补。
下面就是在 onboard 的一个标准流程：
◇ I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│ Yes
│
◇ Onboarding mode
│ QuickStart
│
◇ Config handling
│ Use existing values
│
◇ Model/auth provider
│ ○ OpenAI
│ ○ Anthropic
│ ○ Chutes
│ ○ vLLM
│ ○ MiniMax
│ ○ Moonshot AI (Kimi K2.5)
│ ○ Google
│ ○ xAI (Grok)
│ ○ Mistral AI
│ ○ Volcano Engine
│ ○ BytePlus
│ ○ OpenRouter
│ ○ Kilo Gateway
│ ● Qwen (OAuth)
│ ○ Z.AI
│ ○ Qianfan
│ ○ Copilot
│ ○ Vercel AI Gateway
│ ○ OpenCode Zen
│ ○ Xiaomi
│ ○ Synthetic
│ ○ Together AI
│ ○ Hugging Face
│ ○ Venice AI
│ ...
│
◇ Filter models by provider
│ qwen-portal
│
◇ Default model
│ Keep current (qwen-portal/coder-model)
│
◇ Select channel (QuickStart)
│ Skip for now
│
◇ Search provider
│ Skip for now
│
◇ Configure skills now? (recommended)
│ No
│
◇ Enable hooks?
│ Skip for now
│
◇ Gateway service already installed
│ Restart
│
└ Onboarding complete. Use the dashboard link above to control OpenClaw.注意，选择QWen的时候，要复制下面的地址到浏览器去授权（注册登录Qwen的账户）。
◇ Model/auth provider
│ Qwen
│
◐ Starting Qwen OAuth…│
◇ Qwen OAuth ─────────────────────────────────────────────────────────────────────────╮
│ │
│ Open https://chat.qwen.ai/authorize?user_code=JYLTVQJ3&client=qwen-code to approve │
│ access. │
│ If prompted, enter the code JYLTVQJ3. │
│ │
├──────────────────────────────────────────────────────────────────────────────────────╯认证授权界面：
跑完 onboard 之后，用命令确认一下:
openclaw --version # 看看版本号，有就行
openclaw doctor # 环境自检，有 WARN 正常，别出现 FATAL
openclaw status # 看守护进程 / 网关是否 running如果都显示正常，基本说明链路已经是通的。
接下来就是 QQ 接入 OpenClaw了！
开浏览器输入QQ开放平台，直接QQ扫码登录。
然后创建机器人。
创建完成后，出现下面的提示接入流程，按照页面上的指引复制到终端就可以了，最好是点 扫码聊天，把机器人添加到QQ上。
按照指引复制配置信息到终端：
# 安装QQ机器人插件
openclaw plugins install @sliverp/qqbot@latest
# 添加QQ频道（替换为你的AppID和AppSecret）
openclaw channels add --channel qqbot --token "你的AppID:你的AppSecret"
# 重启网关
openclaw gateway restart之后，就可以在 QQ 给OpenClaw发指令啦！
官方推荐先用本地 Web 控制台，不用一开始就折腾 通讯软件：
openclaw dashboard然后浏览器打开：
http://127.0.0.1:18789/如果能看到一个 Web 界面：
