OpenClaw 安装指南零基础

用户488159395551
25 阅读20分钟

—— 真正零基础、一步不落、全网最详尽的“喂饭级”教程

文档版本：3.0 | 适用读者：完全零基础 | 最后更新：2024年
核心原则：假设读者第一次接触电脑，每个步骤都有“为什么做”、“怎么做”、“做完会看到什么”

📚 第一部分：开篇必读（请一定一字不落看完）

1.1 欢迎来到OpenClaw的世界

亲爱的同学，你好！欢迎踏上OpenClaw的探索之旅。我是你的讲师，接下来我会手把手带你完成整个安装过程。

OpenClaw是什么？
简单来说，它是一个能帮你干活的AI助手，但和你平时用的ChatGPT不同：

  • ✅ 它在你自己的电脑上运行：你的数据、文件都留在本地，不会上传到云端
  • ✅ 它能看到你的文件：你可以让它整理桌面、重命名文件、搜索文档
  • ✅ 它能执行代码：你可以让它写个Python脚本，然后直接运行
  • ✅ 它能接入聊天软件：把它拉进微信群、飞书群，它就能在群里帮你干活

但请注意：正因为它能力强大，所以安装时需要多花一点心思。别担心，跟着这份指南走，你一定能成功！

1.2 安装前的心理建设

很多零基础的同学看到“命令行”、“终端”、“代码”这些词就紧张。我向你保证：

  1. 你不需要会编程：全程只需要复制粘贴我给你的命令
  2. 所有操作都有反馈：我会告诉你每一步之后应该看到什么
  3. 所有问题都有预案：常见错误我都提前告诉你如何处理
  4. 你只需要认真仔细：像做菜一样，按顺序放“调料”就行

请记住：如果过程中遇到任何和指南描述不一致的地方，不要慌，停下来仔细看报错信息，然后翻到文档最后的【故障排查】部分找解决办法。

1.3 你需要准备什么？（完整清单）

需要准备的东西是否必需怎么获得检查方法
一台电脑✅ 必需你已经有了开机就能看到
稳定的网络✅ 必需连接WiFi或网线能打开百度/谷歌
充足的时间✅ 必需留出30-60分钟别着急，慢慢来
API Key（钥匙）✅ 必需去官网免费申请（详见1.5）复制到记事本备用
Node.js✅ 必需我们会在第2章安装安装后能看到版本号
Git⚠️ 部分方案需要我们会在需要时安装安装后能看到版本号
WSL2⚠️ Windows用户推荐我们会在第3章安装安装后能打开Ubuntu

1.4 如何选择你的安装方案？（重要！）

请先找到你的操作系统，然后按照推荐方案执行：

你的操作系统推荐方案为什么选这个预计时间
macOS用户方案A：macOS一键安装最简单，最稳定15-20分钟
Linux用户方案B：Linux一键安装服务器首选10-15分钟
Windows 10/11用户方案C：WSL2 + Ubuntu（强烈推荐）最稳定，所有功能都能用30-40分钟
Windows 10/11用户（只想快速看看）方案D：PowerShell原生（尝鲜）不用装Linux，但可能遇到小问题15-20分钟

讲师强烈建议：如果你是Windows用户并且打算长期使用OpenClaw，请直接选择方案C。虽然第一次配置多花20分钟，但后续使用会非常顺畅，不会遇到各种奇怪的兼容性问题。

1.5 【必须先做】获取你的API Key（钥匙）

OpenClaw需要一把“钥匙”才能调用AI模型。这里提供两种最友好的选择，请任选一个完成。

选择一：Google Gemini（推荐，免费，国内可访问）

特点：免费额度大，速度快，申请简单

详细步骤：

  1. 打开申请页面

    • 打开浏览器（Chrome/Edge/ Safari都可以）
    • 在地址栏输入：https：//aistudio.google.com/app/apikey
    • 按回车键

  2. 登录Google账号

    • 如果已经登录，直接进入下一步
    • 如果没有登录，会看到登录界面
    • 输入你的Google邮箱和密码
    • 如果没有Google账号，点击“创建账号”，按提示注册（需要手机号验证）

  3. 创建API Key

    • 登录后，你会看到一个蓝色的  “Create API Key”  按钮
    • 点击它
    • 会弹出一个窗口，问你要不要新建项目
    • 选择  “Create API key in new project” （在新项目中创建）

  4. 复制你的Key

    • 页面会显示一串以 AIzaSy 开头的字符
    • 这就是你的API Key！
    • 用鼠标选中它，按 Ctrl+C（Mac用户按 Command+C）复制
    • 重要：把它粘贴到记事本里保存，后面要用

成功标志：你看到并复制了一串类似 AIzaSyB1xGj9XxXxXxXxXxXxXxXxXxXxXxXxXxX 的字符

注意事项：

  • Google Gemini是完全免费的，每分钟可以调用60次，足够个人使用
  • 虽然需要绑定信用卡（美国地区）才能开通，但不会扣费，只是验证身份
  • 如果不想绑定信用卡，可以选择下面的阿里云

选择二：阿里云百炼（通义千问，中文友好）

特点：国内服务，中文支持好，新人有免费额度

详细步骤：

  1. 打开阿里云官网

    • 浏览器输入：https：//www.aliyun.com/
    • 点击右上角的“登录/注册”

  2. 注册/登录账号

    • 如果没有账号：点击“免费注册”，按提示完成（需要手机号验证）
    • 如果有账号：直接登录

  3. 完成实名认证（必须）

    • 登录后，鼠标悬停在右上角头像上
    • 点击“实名认证”
    • 选择“个人认证”
    • 按提示输入姓名和身份证号
    • 通过支付宝扫码验证（约1分钟完成）

  4. 进入模型服务控制台

    • 在浏览器新标签页输入：https：//bailian.console.aliyun.com/
    • 如果是第一次进入，可能需要同意服务条款，勾选同意即可

  5. 获取API Key

    • 在左侧菜单栏找到  “模型广场”
    • 展开后点击  “API-KEY管理”
    • 点击蓝色的  “创建API-Key”
    • 在弹出的窗口中，输入名称（比如“openclaw”）
    • 点击“确定”

  6. 复制你的Key

    • 页面会显示一串以 sk- 开头的字符
    • 这就是你的API Key！
    • 点击“复制”按钮，粘贴到记事本保存

成功标志：你看到并复制了一串类似 sk-8a5f3c9b2e1d4a7f8c3b6e9d2a5f8c1b 的字符

注意事项：

  • 新用户赠送100万tokens（约等于100万汉字），足够新手玩很久
  • 用完免费额度后需要充值，否则AI会报错

1.6 【重要提醒】API Key的安全须知

⚠️ 请一定记住：

  • ✅ API Key要保存在自己的记事本里
  • ✅ 只在配置OpenClaw时粘贴使用
  • ❌ 不要分享给任何人（包括朋友、网友）
  • ❌ 不要发到任何网站、论坛、群里
  • ❌ 不要把包含Key的截图发出去

如果误将Key泄露，请立即回官网删除并重新生成。

🍎 第二部分：macOS用户安装指南（方案A）

如果你是Mac电脑用户（包括Intel芯片和M1/M2/M3芯片），恭喜你，这是最简单的方案！

2.1 第一步：打开“终端”（Terminal）

终端是一个黑乎乎的窗口，我们通过它来输入命令指挥电脑。

打开方法：

  1. 点击屏幕右上角的放大镜图标（聚焦搜索）
  2. 输入  “终端” （不要输入引号）
  3. 看到黑色的终端图标，点击它
  4. 你会看到：一个白色或黑色的窗口，光标在闪烁，前面有你的电脑名和用户名

小提示：以后可以把这个终端图标拖到下面的Dock栏，方便随时打开

2.2 第二步：检查是否已安装Node.js

Node.js是OpenClaw的“发动机”，必须先确认有没有装过。

在终端中输入以下命令（复制粘贴，然后按回车）：

bash

node -v

你会看到三种可能的结果：

你看到的意思接下来怎么做
v22.3.0 或 v22.x.x✅ 已安装且版本符合要求直接跳到2.4节
v18.12.0 或更低版本⚠️ 版本太低，需要升级继续2.3节
command not found❌ 没安装，需要安装继续2.3节

2.3 第三步：安装Node.js 22.x

我们使用Homebrew来安装，这是Mac上最方便的软件管理工具。

2.3.1 先安装Homebrew

在终端中复制粘贴以下命令（一整行），然后回车：

/bin/bash -c "$(curl -fsSL https：//raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

过程中你会遇到：

  1. 系统可能会提示输入密码（就是你开机登录的密码）

    • 输入时屏幕完全没反应（不显示星号，光标也不动）——这是正常的！
    • 正常输入密码，输完后按回车

  2. 会看到很多文字在滚动，最后出现 Installation successful 或类似提示

  3. 整个过程可能需要几分钟，取决于网速，请耐心等待

如果卡住不动了：

  • 按 Ctrl+C 取消
  • 重新执行上面的命令

2.3.2 使用Homebrew安装Node.js

继续在终端中输入：

brew install node@22

你会看到：很多文字滚动，最后出现绿色的 ✓ 和 🍺 图标

2.3.3 将Node.js添加到系统路径

为了让系统能找到新安装的Node.js，需要执行：

echo 'export PATH="/usr/local/opt/node@22/bin：$PATH"' >> ~/.zshrc
source ~/.zshrc

你会看到：没有输出是正常的，直接回到命令提示符

2.3.4 验证Node.js安装

输入：

node -v

你应该看到：v22.x.x（x是具体数字）

如果还是显示旧版本或找不到：

  • 关掉终端，重新打开一个新的
  • 再次输入 node -v 验证

2.4 第四步：一键安装OpenClaw

现在可以正式安装OpenClaw了！

在终端中复制粘贴以下命令：

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

如果你在中国大陆，访问上述地址慢，请使用这个镜像源：

bash

curl -fsSL https：//gitee.com/openclaw/install/raw/main/install.sh | bash

你会看到：

  • 很多文字在滚动
  • 最后出现类似 Installation complete！ 或 OpenClaw has been installed successfully 的提示

2.5 第五步：运行配置向导（最关键的步骤）

安装完成后，会自动启动配置向导。如果没自动启动，手动输入：

openclaw onboard

接下来你会看到一系列问题，需要你做出选择。请严格按照下面的表格回答：

【问题1】  I understand this is powerful and inherently risky. Continue？

  • 中文意思：我了解这个软件功能强大且有风险，要继续吗？
  • 你应该：按 y 然后回车（或者直接按回车，默认就是Yes）
  • 你会看到：进入下一个问题

【问题2】  Onboarding mode： 下面有选项

  • 选项有：QuickStart / Advanced / Custom
  • 你应该：用键盘上下键移动到 QuickStart，然后按回车
  • 为什么：快速启动模式会自动帮我们配置大部分选项

【问题3】  Model/auth provider： 选择模型提供商

  • 选项有：OpenAI / Google / Anthropic / Custom Provider 等

  • 你应该：

    • 如果你用的是Google Gemini的Key：选择 Google
    • 如果你用的是阿里云的Key：选择 Custom Provider

  • 怎么选：用上下键移动，按回车确认

【问题4】  接下来取决于你的选择：

情况A：你选了Google

  • 会问 Select a model：（选择模型）
  • 选项有：gemini-pro / gemini-1.5-flash 等
  • 你应该选：gemini-1.5-flash（速度最快，免费额度高）
  • 然后直接跳到【问题5】

情况B：你选了Custom Provider

  • 会问 API Base URL：（API地址）

  • 你应该：直接按回车跳过（后面可以再配置）

  • 然后会问 Model name：（模型名称）

  • 你应该：直接按回车跳过

  • 然后会问 API Key：（粘贴你的钥匙）

  • 你应该：粘贴你在阿里云复制的Key（以sk-开头的那串）

    • 粘贴方法：在终端中直接点击鼠标右键，或者按 Command+V

【问题5】  API Key：（如果上面还没粘贴）

  • 你应该：粘贴你在Google复制的Key（以AIzaSy开头的那串）
  • 粘贴方法：在终端中直接点击鼠标右键，或者按 Command+V
  • 注意：粘贴后屏幕不会显示你贴的内容，这是正常的！直接按回车

【问题6】  Choose channels to install：（选择要安装的通讯渠道）

  • 选项有：wechat / feishu / telegram 等，前面有 [ ]

  • 你应该：确保所有选项都是空的（没有[X]）

    • 如果有选项被选中，按空格键可以取消选中
    • 全部取消后，按回车选择 Skip for now（暂时跳过）

  • 为什么：第一次安装，我们先在网页上熟悉，以后再配置接入聊天软件

【问题7】  Install skills？（安装技能吗？）

  • 你应该：输入 n 然后回车（或者直接按回车，默认是No）
  • 为什么：技能是扩展功能，第一次先不装

【问题8】  Install daemon？（安装守护进程吗？）

  • 你应该：输入 y 然后回车（这个很重要！ ）
  • 为什么：这样OpenClaw就能在后台自动运行，即使你关掉终端窗口，它也不会“死掉”

【问题9】  Hatching method：（孵化方式）

  • 选项有：Open the Web UI / Print connection info / Just exit
  • 你应该：选择 Open the Web UI（打开网页界面）
  • 你会看到：浏览器会自动弹开

2.6 第六步：验证安装成功

  1. 浏览器应该自动打开了 http：//127.0.0.1：18789/

  2. 你会看到一个简洁的聊天界面，中间有一个输入框

  3. 输入你的第一句话：

    你好，请问你是谁？

  4. 按回车发送

  5. 你会看到：OpenClaw开始回复，介绍自己

如果浏览器没有自动打开：

  • 手动在终端输入：openclaw dashboard
  • 终端会显示一行网址，用浏览器打开它

2.7 第七步：测试基本功能

在聊天框里输入以下命令，测试OpenClaw的执行能力：

测试1：让它在你的电脑上创建一个文件

帮我创建一个名为“hello.txt”的文件，内容写上“Hello OpenClaw， I‘m your master！”

你会看到：它告诉你文件已创建，并且在你当前目录下确实多了这个文件

测试2：让它帮你搜索信息（需要网络）

帮我搜索一下今天的天气

你会看到：它会调用搜索功能，返回结果

测试3：让它执行简单代码

用Python计算一下 12345 * 6789 等于多少

你会看到：它会写一段Python代码并执行，返回计算结果

🎉 恭喜！你的OpenClaw已在macOS上成功运行！  你可以继续阅读【第四部分：日常操作指南】，学习如何管理你的OpenClaw。

🐧 第三部分：Linux (Ubuntu) 用户安装指南（方案B）

如果你是Linux用户（以Ubuntu为例），安装过程与macOS类似，但命令略有不同。

3.1 第一步：打开终端

  • 按 Ctrl + Alt + T 组合键
  • 你会看到：一个黑色的窗口，光标在闪烁

3.2 第二步：更新软件源

在终端中输入：

sudo apt update

系统会提示输入密码（就是你登录Linux的密码），输入后回车。输入时屏幕无显示，正常！

3.3 第三步：安装Node.js 22.x

curl -fsSL https：//deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

3.4 第四步：验证Node.js安装

node -v

你应该看到：v22.x.x

3.5 第五步：安装Git（可选但推荐）

sudo apt install -y git

验证：

git --version

你应该看到：git version 2.x.x

3.6 第六步：一键安装OpenClaw

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

3.7 第七步：运行配置向导

openclaw onboard

请完全按照【2.5节】的表格回答所有问题

3.8 第八步：验证安装

openclaw dashboard

浏览器会自动打开，看到聊天界面即成功。

🪟 第四部分：Windows用户安装指南（方案C：WSL2推荐）

这是Windows用户最稳定、最推荐的方案。我们将在Windows里安装一个完整的Linux系统（Ubuntu），然后在里面运行OpenClaw。

4.1 第一步：检查电脑是否支持虚拟化（必须先做）

WSL2需要CPU支持虚拟化，并且要在BIOS中开启。

检查方法：

  1. 按 Ctrl + Shift + Esc 打开任务管理器

  2. 点击左下角的  “性能”  标签页

  3. 点击左侧的  “CPU”

  4. 在右下角找到  “虚拟化：已启用”

    • 如果显示  “已启用”  → ✅ 可以继续
    • 如果显示  “已禁用”  → 需要进入BIOS开启（见下文）
    • 如果显示  “不支持”  → 你的CPU太老，无法使用WSL2，请转【方案D】

如何进入BIOS开启虚拟化：

  1. 重启电脑

  2. 开机时不断按特定键（不同品牌不同）：

    • Dell/联想：F2 或 F12
    • HP：F10
    • 华硕：F2 或 Del
    • 宏碁：F2

  3. 进入BIOS后，找到类似配置：

    • Intel CPU：Intel Virtualization Technology 或 VT-x
    • AMD CPU：SVM Mode

  4. 设置为 Enabled

  5. 按F10保存退出

4.2 第二步：以管理员身份打开PowerShell

PowerShell是Windows下的命令行工具，我们需要用管理员权限运行它。

正确打开方法：

  1. 点击屏幕左下角的  “开始”  按钮
  2. 直接输入 PowerShell
  3. 在搜索结果中，会看到  “Windows PowerShell”
  4. 重要：鼠标右键点击它，选择  “以管理员身份运行”
  5. 如果弹出用户账户控制窗口，点击  “是”

确认是否成功：

  • 窗口标题应该以  “管理员：”  开头
  • 示例：管理员： Windows PowerShell

4.3 第三步：一键安装WSL2

在管理员PowerShell中，复制粘贴以下命令（鼠标右键点击即可粘贴）：

wsl --install

你会看到：

  • 很多文字滚动，显示正在安装
  • 最后会提示安装成功，并可能需要重启

这个命令会自动完成：

  • 启用WSL功能
  • 启用虚拟机平台
  • 下载并安装默认的Ubuntu系统

如果中途报错或卡住：

情况A：提示“无法解析服务器名称或地址”

  • 网络问题，可以手动安装：
# 先启用WSL功能
dism.exe /online /enable-feature /featurename：Microsoft-Windows-Subsystem-Linux /all /norestart

# 再启用虚拟机平台
dism.exe /online /enable-feature /featurename：VirtualMachinePlatform /all /norestart

情况B：提示“0x80070003”错误

  • 系统版本太低，需要更新Windows

4.4 第四步：重启电脑

必须重启！  让所有更改生效。

4.5 第五步：首次启动Ubuntu

  1. 重启后，点击  “开始”  按钮
  2. 输入 Ubuntu
  3. 点击出现的  “Ubuntu”  应用（紫色图标）

第一次启动需要设置用户名和密码：

  1. 系统会显示：

    Installing， this may take a few minutes...
Please create a default UNIX user account.
Enter new UNIX username：

  2. 输入用户名：

    • 输入一个你喜欢的名字（如你的英文名或拼音）
    • 建议用简单好记的，比如：openclaw 或你的名字拼音
    • 输完后按回车

  3. 输入密码（这里非常重要！ ）：

    New password：
    • 输入时屏幕上完全没有任何显示！ （不显示星号，光标也不动）
    • 这不是电脑坏了，是Linux的安全机制
    • 正常输入你想设置的密码（建议简单点，比如 123456）
    • 输完后按回车

  4. 确认密码：

    Retype new password：
    • 再次输入同样的密码
    • 同样屏幕无显示
    • 输完后按回车

  5. 成功标志：

    • 看到类似 openclaw@yourcomputer：~$ 的提示符
    • 这表示你已经成功进入Ubuntu系统了！

如果忘记密码了怎么办：

  • 回到PowerShell（管理员），执行：
wsl --unregister Ubuntu
  • 然后重新从【4.5节】开始

4.6 第六步：在Ubuntu中更新软件源

现在你已经在Ubuntu系统中了，所有命令都在这个紫色的Ubuntu窗口中执行。

sudo apt update

系统会提示输入密码，输入刚才设置的Ubuntu密码（输入时仍然无显示），按回车。

4.7 第七步：在Ubuntu中安装Node.js

curl -fsSL https：//deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs

验证：

node -v

你应该看到：v22.x.x

4.8 第八步：在Ubuntu中安装Git

sudo apt install -y git

验证：

git --version

你应该看到：git version 2.x.x

4.9 第九步：在Ubuntu中一键安装OpenClaw

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

4.10 第十步：运行配置向导

openclaw onboard

请完全按照【2.5节】的表格回答所有问题！  一模一样地回答。

4.11 第十一步：启用systemd（让服务开机自启）

为了让OpenClaw能在后台自动运行，需要启用systemd。

  1. 编辑配置文件：
sudo nano /etc/wsl.conf
  1. 在打开的文件中粘贴以下内容：
[boot]
systemd=true

  1. 保存退出：

    • 按 Ctrl + O（字母O），然后按回车（保存）
    • 按 Ctrl + X（退出）

  2. 重启WSL2：
    回到Windows的PowerShell（管理员），执行：

wsl --shutdown
  1. 重新打开Ubuntu，再次进入
  2. 验证systemd是否生效：
systemctl status

如果看到很多绿色的"●"和服务列表，说明生效

4.12 第十二步：访问Web界面

在Ubuntu终端中输入：

openclaw dashboard

第一次运行可能会弹出Windows防火墙提示：

  • 会看到“Windows Defender防火墙已阻止此应用的部分功能”
  • 请勾选“专用网络” （Private networks）
  • 不要勾选“公用网络” （Public networks）
  • 点击“允许访问”

浏览器会自动打开 http：//127.0.0.1：18789/，看到聊天界面即成功。

4.13 额外知识：Windows和WSL2如何互传文件

从Windows访问WSL2的文件：

  1. 打开文件资源管理器
  2. 在地址栏输入：\wsl$\Ubuntu
  3. 按回车，就能看到Ubuntu里的所有文件
  4. 你的个人文件在 home/你的用户名/ 目录下

从WSL2访问Windows的文件：

  1. 在Ubuntu终端中，Windows的C盘在 /mnt/c/
  2. 例如要访问桌面：cd /mnt/c/Users/你的Windows用户名/Desktop

🎉 恭喜！你的OpenClaw已在Windows WSL2环境中成功运行，这是最稳定的方案！

🪟 第五部分：Windows用户快速尝鲜指南（方案D：PowerShell原生）

如果你暂时不想折腾WSL2，只是想快速看看OpenClaw长什么样，可以选择这个方案。但请注意：后续安装插件时可能会遇到兼容性问题。

5.1 第一步：安装Node.js

  1. 打开浏览器，访问：https：//nodejs.org/

  2. 下载Node.js：

    • 页面左侧有个绿色的按钮  “LTS”
    • 点击它下载（会自动识别你的系统）
    • 确保下载的是64位版本（除非你的电脑是古董32位）

  3. 安装Node.js：

    • 双击下载的安装包
    • 一路点击“Next”（下一步）
    • 关键步骤：当看到 Automatically install the necessary tools 时，一定要勾选！
    • 继续点“Next”直到“Install”
    • 点击“Finish”完成

  4. 验证安装：

    • 按 Win + R，输入 powershell，回车
    • 输入 node -v
    • 你应该看到：v22.x.x

5.2 第二步：解决PowerShell执行策略

Windows默认禁止运行脚本，需要放开限制。

以管理员身份打开新的PowerShell：

  1. 按 Win 键，输入 PowerShell
  2. 右键点击“Windows PowerShell”，选“以管理员身份运行”

执行以下命令：

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser -Force

验证：

Get-ExecutionPolicy

应该显示：RemoteSigned

5.3 第三步：一键安装OpenClaw

在PowerShell（普通权限即可，不一定需要管理员）中执行：

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

如果慢，用镜像源：

iwr -useb https：//gitee.com/openclaw/install/raw/main/install.ps1 | iex

5.4 第四步：运行配置向导

powershell

openclaw onboard

请完全按照【2.5节】的表格回答所有问题

5.5 第五步：访问Web界面

openclaw dashboard

浏览器会自动打开 http：//127.0.0.1：18789/，看到聊天界面即成功。

🎉 恭喜！你的OpenClaw已在Windows PowerShell原生环境中运行！

📖 第六部分：日常操作指南

6.1 常用命令速查表

你想做什么在终端/PowerShell中输入你会看到什么
查看OpenClaw版本openclaw -v版本号，如 v1.2.3
查看运行状态openclaw statusgateway： running (pid 1234)
启动网关服务openclaw gateway startGateway started
停止网关服务openclaw gateway stopGateway stopped
重启网关服务openclaw gateway restartGateway restarted
打开Web界面openclaw dashboard浏览器自动打开
查看实时日志openclaw logs follow实时滚动的日志，按 Ctrl+C 退出
重新配置openclaw onboard重新进入配置向导
健康检查openclaw doctor环境检查报告

6.2 如何让OpenClaw开机自启？

如果你在配置向导中选择了 Install daemon？ -> Yes：

  • ✅ 已经自动配置好了，不用管

如果你用的是Windows PowerShell原生方案且没装daemon：

  1. 按 Win + R，输入 shell：startup，回车

  2. 在打开的文件夹中右键点击，选择“新建” -> “快捷方式”

  3. 在位置输入：

    C：\Users\你的用户名\AppData\Roaming\npm\openclaw.cmd gateway start

  4. 点击“下一步”，输入名称“OpenClaw”，点击“完成”

6.3 如何更改配置（比如换个模型）？

方法一：重新运行配置向导（推荐新手）

openclaw onboard

方法二：直接修改配置文件
配置文件位置：

  • Windows：C：\Users\你的用户名.openclaw\config.yaml
  • macOS/Linux：~/.openclaw/config.yaml

用记事本打开，找到对应项修改即可。

6.4 如何安装技能（扩展功能）

# 搜索技能
openclaw skills search 文件管理

# 安装技能
openclaw skills install 文件整理大师

# 查看已安装技能
openclaw skills list

# 卸载技能
openclaw skills uninstall 技能名称

6.5 如何配置通讯渠道

# 查看可用渠道
openclaw channel list

# 配置微信
openclaw channel config wechat

# 配置飞书
openclaw channel config feishu

🚨 第七部分：故障排查大全（遇到问题先看这里）

7.1 命令找不到类问题

问题：openclaw： command not found

可能原因及解决办法：

  1. Node.js没安装或版本不对

    node -v

    如果看不到版本号，重新安装Node.js

  2. 安装后没重启终端

    • 关掉当前终端，重新打开一个新的
    • 如果还不行，重启电脑

  3. 安装路径不在环境变量中

    • Windows：重新运行安装程序，确保勾选“Add to PATH”
    • macOS/Linux：检查 ~/.bashrc 或 ~/.zshrc 中是否有npm路径

7.2 网关启动失败类问题

问题：Error： listen EADDRINUSE ：：：18789

原因：18789端口已被其他程序占用

解决方法：

  1. 找到占用端口的程序

    • Windows：

      netstat -ano | findstr ：18789

      看到最后一列的数字是PID（进程ID）

    • macOS/Linux：

      lsof -i ：18789

  2. 结束占用进程

    • Windows：

      powershell

      taskkill /PID 上面看到的数字 /F

    • macOS/Linux：

      bash

      kill -9 上面看到的数字

  3. 重启网关

    openclaw gateway restart

7.3 API Key相关错误

问题：AI不回复，或报错 Authentication failed / Invalid API key

原因：

  • API Key复制错了（多了空格、少复制字符）
  • API Key已过期或额度用尽
  • 网络无法访问AI服务商

解决方法：

  1. 检查API Key是否正确

    • 重新打开你保存Key的记事本
    • 仔细对比：Google的Key以 AIzaSy 开头，共39位
    • 阿里云的Key以 sk- 开头

  2. 重新配置API Key

    openclaw config --set model.apiKey=你的完整Key

  3. 测试网络连通性

    • Google：在浏览器打开 https：//generativelanguage.googleapis.com
    • 阿里云：在浏览器打开 https：//dashscope.aliyuncs.com
    • 如果打不开，说明网络不通，需要配置代理

7.4 日志查看技巧

日志是排查问题的“黑匣子”，学会看日志能解决90%的问题：

# 实时查看日志（最常用）
openclaw logs follow

# 查看最近100行日志
openclaw logs --lines 100

# 将日志保存到文件
openclaw logs > error.log

常见日志含义：

日志内容含义解决方法
Error： listen EADDRINUSE端口被占用见7.2节
Error： connect ECONNREFUSED网络连接被拒绝检查网络，配置代理
Error： Authentication failedAPI Key无效检查Key是否正确
Error： Cannot find module 'xxx'缺少依赖包重新安装OpenClaw
Error： Permission denied权限不足以管理员
avatar
文章
阅读
粉丝