OpenClaw 最近这么火，刚好趁着周末，我也安装一个试试，紧跟潮流。

一、先确认你的环境（必须满足）

1. 系统与硬件

  • Windows 10 64 位

  • 内存 ≥ 4GB（推荐 8GB+）

  • 磁盘可用 ≥ 5GB

  • 稳定网络

2. 软件依赖（已装 Node 可跳过）

OpenClaw 要求 Node.js ≥ v22。

检查当前 Node 版本

打开 PowerShell（管理员），执行：

node -v
npm -v
安装/升级 Node.js

其实不需要自己升级，后面安装openclaw时候会自动坚持环境，它会帮你下载升级，还是很智能的。

二、一键安装 OpenClaw（推荐，最省事）

1. 以管理员身份打开 PowerShell

  • Win+X → 选择 Windows PowerShell (管理员)

  • 或开始菜单搜索 PowerShell → 右键“以管理员身份运行”

2. 执行官方安装脚本

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

  • 脚本会自动：

    • 检查 PowerShell 版本（≥5.0）

    • 检查/安装 Node.js 22+

    • 检查/安装 Git

    • 全局安装 openclaw

    • 配置环境变量

    • 运行 openclaw doctor 自检

3. 验证安装

openclaw --version

出现版本号（如 2026.3.x）即成功。

三、初始化配置（首次必做）

1. 运行初始化向导

openclaw onboard --install-daemon

  • 按提示一路回车（默认即可）

  • 会让你选择：

    • 模型服务商（本地 Ollama / 云端 API）

    • 网关模式（本地 / 远程）

    • 端口（默认 18789）

    • 聊天渠道（飞书/微信等，可选）

2. 启动服务

# 启动网关（默认端口 18789）
openclaw gateway

# 查看状态
openclaw status

# 打开 Web 仪表盘
openclaw dashboard

浏览器访问：http://localhost:18789

四、手动安装（进阶，适合定制）

1. 克隆源码

git clone https://github.com/OpenClaw-Labs/OpenClaw.git
cd OpenClaw

2. 安装依赖（用 pnpm 更快）

npm install -g pnpm
pnpm install
pnpm ui:build
pnpm build

3. 初始化并启动

pnpm openclaw onboard --install-daemon
pnpm openclaw gateway --port 18789

五、常见问题与排错

1. 执行脚本提示“策略禁止运行脚本”

Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope CurrentUser

输入 Y 确认，再重新执行安装脚本。

2. 安装卡在 node-gyp 编译

# 安装 Windows 编译工具
npm install -g windows-build-tools

3. 命令找不到 openclaw

  • 关闭所有 PowerShell 窗口，重新打开

  • 手动添加 PATH：

    • 此电脑 → 右键属性 → 高级系统设置 → 环境变量

    • 在用户变量 Path 中添加：%APPDATA%\npm

    • 重启终端

4. 国内网络慢

# 切换 npm 淘宝镜像
npm config set registry https://registry.npmmirror.com

六、安装完成后做什么

  1. 打开 Web 面板：openclaw dashboard

  2. 配置你的大模型（本地 Ollama 或 API Key）

  3. 开始用 OpenClaw 做自动化任务

Win10 + Node 环境下 OpenClaw 常用命令速查手册

一、安装 & 自检

# 一键安装
iwr -useb https://openclaw.ai/install.ps1 | iex

# 查看版本
openclaw --version

# 环境自检（排查问题必用）
openclaw doctor

二、初始化 & 配置

# 首次初始化向导
openclaw onboard

# 只重置配置（不删数据）
openclaw config reset

三、启动 & 运行

# 启动核心网关（Web 面板 + API）
openclaw gateway

# 后台守护进程（关闭终端也不挂）
openclaw daemon start

# 停止后台
openclaw daemon stop

# 重启
openclaw daemon restart

四、面板 & 状态

# 直接打开 Web 仪表盘
openclaw dashboard

# 查看运行状态
openclaw status

# 查看日志
openclaw logs

五、模型相关

# 列出支持的模型
openclaw model list

# 拉取模型
openclaw model pull 模型名

# 删除模型
openclaw model remove 模型名

六、常见排错命令

# 修复权限/脚本禁止运行
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 切淘宝 npm 镜像（解决安装慢/失败）
npm config set registry https://registry.npmmirror.com

# 重装依赖
npm install -g openclaw --force

七、升级 & 卸载

# 升级
npm update -g openclaw

# 完整卸载
npm uninstall -g openclaw

OpenClaw API模式完整配置文档（Win10+Node环境）

文档适用场景：已在Win10系统完成OpenClaw安装（已解决iwr命令执行失败问题）、搭载合规Node.js环境，需对接云端大模型API，不依赖本地模型部署，主打轻量化快速使用。

核心前提：OpenClaw已安装成功、拥有目标平台有效的API密钥、终端为管理员权限PowerShell。

一、配置前准备工作

1.1 环境自检（必做）

先确认OpenClaw安装正常、环境无异常，避免后续配置报错，打开管理员权限PowerShell，依次执行以下命令：

# 查看OpenClaw版本，确认安装成功
openclaw --version
# 环境全面自检，排查依赖、权限、端口占用问题
openclaw doctor
# 停止可能正在运行的本地网关进程，防止端口冲突
openclaw daemon stop

自检通过标准：无红色报错提示，版本号正常显示，端口18789（默认）未被占用。

1.2 API密钥获取须知

API模式需提前在对应大模型平台申请密钥，注意区分Secret Key/API Key，复制时避免携带空格、换行等多余字符，国内平台优先选择豆包API，无需代理即可使用；OpenAI等海外平台需配置网络代理，否则会出现连接超时。

二、主流大模型API配置步骤（成品命令直接复用）

以下配置均为一键命令式操作，无需手动修改配置文件，替换命令中的【你的API密钥】即可直接执行，按平台分类整理，适配绝大多数用户需求。

2.1 豆包API配置（国内首选，无代理要求）

豆包API国内访问稳定，免费额度充足，适配日常基础使用，是Win10用户最优选择。

2.1.1 密钥获取渠道

访问火山方舟控制台：https://console.volcengine.com/ark/region:ark-cn-beijing/apikey，登录账号后创建API密钥，复制Secret Key备用。

点击这里的API介入按钮，登录实名后复制API，这个是需要付费token的，好像阿里的千问有免费token，可以去看看，免费token量肯定是不能大的，只能测试用。。

2.1.2 完整配置命令

# 配置默认大模型提供商为豆包
openclaw config set --key llm.default.provider --value doubao
# 填入复制的豆包Secret Key
openclaw config set --key llm.default.apiKey --value 你的豆包Secret Key
# 配置豆包API官方请求地址
openclaw config set --key llm.default.baseUrl --value https://ark.cn-beijing.volces.com/api/v3
# 设置默认调用模型（doubao-pro为通用版，可按需更换）
openclaw config set --key llm.default.model --value doubao-pro
# 启动OpenClaw网关服务
openclaw gateway
# 测试API连通性，验证配置是否生效
openclaw llm test --provider doubao

2.2 DeepSeek API配置（高性价比，国内可直连）

2.2.1 密钥获取渠道

访问DeepSeek平台：https://platform.deepseek.com/api_keys，注册登录后创建API密钥并复制。

2.2.2 完整配置命令

# 配置提供商为DeepSeek
openclaw config set --key llm.default.provider --value deepseek
# 填入DeepSeek API密钥
openclaw config set --key llm.default.apiKey --value 你的DeepSeek API密钥
# 配置官方API地址
openclaw config set --key llm.default.baseUrl --value https://api.deepseek.com
# 设置默认模型（deepseek-chat为通用对话模型）
openclaw config set --key llm.default.model --value deepseek-chat
# 启动网关并测试
openclaw gateway
openclaw llm test --provider deepseek

2.3 OpenAI API配置（海外模型，需代理）

2.3.1 密钥获取与前置要求

访问OpenAI平台：https://platform.openai.com/api-keys 创建密钥；国内用户需提前开启网络代理，记录代理地址（常规为http://127.0.0.1:7890）。

2.3.2 完整配置命令

# 配置提供商为OpenAI
openclaw config set --key llm.default.provider --value openai
# 填入OpenAI API Key
openclaw config set --key llm.default.apiKey --value 你的OpenAI API密钥
# 设置默认模型（gpt-3.5-turbo性价比最高）
openclaw config set --key llm.default.model --value gpt-3.5-turbo
# 配置本地代理地址（根据自身代理端口修改）
openclaw config set --key network.proxy --value http://127.0.0.1:7890
# 启动网关并测试
openclaw gateway
openclaw llm test --provider openai

三、配置验证与启动管理

3.1 配置生效验证

  1. 命令验证：执行对应平台的openclaw llm test --provider 平台标识命令，出现“测试成功”提示，代表API密钥、地址配置无误。

  2. 面板验证：执行openclaw dashboard命令，自动打开浏览器Web仪表盘，登录后可在模型设置页查看当前API配置状态，正常加载模型列表即为成功。

  3. 状态查看：执行openclaw status，查看网关运行状态、API连接状态，无异常报错即可正常使用。

3.2 服务后台运行（关闭终端不退出）

默认openclaw gateway命令关闭终端后服务会停止，如需后台常驻，执行以下命令：

# 启动后台守护进程
openclaw daemon start
# 重启后台服务（配置修改后需执行）
openclaw daemon restart
# 停止后台服务
openclaw daemon stop
# 查看实时运行日志
openclaw logs

四、API配置常见问题与排错（必看注意事项）

核心注意事项：API密钥严格区分大小写，复制时切勿多复制空格、换行；配置完成后若修改密钥或模型，必须重启网关服务才会生效；海外平台API务必配置正确代理，否则会提示连接超时、密钥无效。

4.1 常见报错及解决方案

  • 报错：密钥无效/认证失败：重新核对API密钥是否复制正确，确认平台账号已完成实名认证、有可用额度，部分平台新密钥需等待1-2分钟生效。

  • 报错：连接超时/无法访问API地址：国内平台检查网络是否正常，海外平台确认代理地址和端口配置正确，可执行ping 对应API域名测试网络连通性。

  • 报错：端口18789被占用：执行netstat -ano | findstr "18789"找到占用进程，关闭对应程序，或启动时指定端口openclaw gateway --port 自定义端口。

  • 报错：命令无法识别openclaw：关闭所有PowerShell终端，重新打开管理员权限终端，环境变量会自动加载；若仍无效，手动将npm路径添加到系统环境变量。

4.2 配置修改与重置

# 查看当前全部API配置
openclaw config get llm.default
# 切换默认模型（无需重新配置密钥）
openclaw config set --key llm.default.model --value 新模型名称
# 重置所有LLM配置（配置混乱时使用）
openclaw config reset llm
# 重置全部配置（慎用，会清空所有自定义设置）
openclaw config reset

五、API模式常用命令速查

命令内容

功能说明

openclaw llm test --provider 平台名

测试对应平台API连通性

openclaw dashboard

快速打开Web管理面板

openclaw status

查看服务与API运行状态

openclaw daemon start

后台启动服务，关闭终端不退出

openclaw config get llm.default

查看当前API配置详情

不同的人，用不同的玩儿法，多动手试试吧。

Logo
龙虾开发者社区

小龙虾开发者社区是 CSDN 旗下专注 OpenClaw 生态的官方阵地，聚焦技能开发、插件实践与部署教程，为开发者提供可直接落地的方案、工具与交流平台，助力高效构建与落地 AI 应用

更多推荐

OpenClaw+GLM-4.7-Flash语音交互：对接Whisper实现语音控制

本文介绍了如何在星图GPU平台上自动化部署【ollama】GLM-4.7-Flash镜像，构建语音交互系统。该系统结合Whisper语音识别与GLM-4.7-Flash的指令理解能力，实现智能家居控制等场景的语音操作，提升日常任务执行效率。

avatar 龙虾开发者社区

学生党福音：OpenClaw+nanobot搭建学习监督助手

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，构建智能学习监督助手。该方案利用轻量级模型实现网课进度跟踪、自动生成练习题和错题整理功能，特别适合学生群体通过QQ机器人实现移动端学习管理，显著提升学习效率。

avatar 龙虾开发者社区

OpenClaw创意工坊：用nanobot镜像生成技术海报文案

本文介绍了如何在星图GPU平台上自动化部署🐈 nanobot：超轻量级OpenClaw镜像，快速生成技术海报文案。该镜像基于Qwen3-4B模型，能将复杂技术术语转化为通俗表达，适用于技术活动宣传、社交媒体推广等场景，显著提升内容创作效率。

avatar 龙虾开发者社区