OpenClaw简介--windows系统安装OpenClaw

OpenClaw 的名字经历了三次变更,第一次叫做 ClawdBot,后来因为名字跟 Claude 太过相似,被 CLaude 告侵权,遂改名 MoltBot 。

但是后来在改名过程中遭遇域名和社交账号被抢注,甚至出现同名加密货币割韭菜的情况,导致名称传播受阻。

最终定名为:OpenClaw。

所以,名字经历先后顺序为:ClawdBot -> MoltBot -> OpenClaw

一、什么是 OpenClaw?

OpenClaw(曾用名 Clawdbot)是一款 2026 年爆火的开源个人 AI 助手,GitHub 星标已超过 10 万颗。与传统 AI 聊天机器人的根本区别在于:

真正的执行能力:不仅能回答问题,还能实际操作你的电脑

24/7 全天候待命:在你睡觉时也能主动完成任务

完全开源免费:数据完全掌控在自己手中

支持多种通讯平台:在国外,WhatsApp、Telegram、Discord、Slack、iMessage 等,在国内,飞书,钉钉等各大厂商的即时聊天软件已经支持接入

它能做什么?

它不只是回答问题的聊天机器人,而是真的能在你电脑上动手操作。比如你告诉它"帮我整理一下上个月的邮件",它就默默去处理了;你睡觉时,它还能继续干活,退订广告、预约行程、甚至找找 Bug。

它完全免费,你的数据都在自己手里。而且可以用钉钉,飞书,WhatsApp、Telegram等各类即时通讯软件来指挥他干活!

简单来说,一句话交给它,从整理桌面文件到控制家里灯光,它都默默帮你搞定。是你电脑里真正的贾维斯!超级智能的AI助理!

二、安装nodejs

后面执行一键安装命令,可以自动安装nodejs,但是如果为了加快速度,防止安装意外,可以先安装nodejs:

官方下载地址:https://nodejs.org/zh-cn/download

注意版本最好在 node v22.x 以上。

三、安装git和pnpm

openclaw需要从git仓库拉取某些依赖。

1.先安装 Git

复制代码
# 方法1:使用winget安装(推荐)
winget install Git.Git

# 方法2:直接下载安装
# 打开浏览器下载:https://git-scm.com/download/win

# 安装后刷新环境变量
$env:Path = [System.Environment]::GetEnvironmentVariable("Path","Machine") + ";" + [System.Environment]::GetEnvironmentVariable("Path","User")

2.验证安装版本

复制代码
# 验证git可用
git --version

3.安装包管理器 pnpm

复制代码
npm install -g pnpm

注意,npm 在处理依赖树时可能会卡死,所以需要安装 pnpm

四、开始安装OpenClaw

一)设置 PowerShell 执行权限

以管理员身份运行 PowerShell:

按 Win 键,搜索 PowerShell

右键点击 Windows PowerShell

选择 以管理员身份运行

点击 是 确认

在管理员 PowerShell 窗口中,依次执行以下两条命令:

复制代码
# 允许当前用户运行本地和下载的脚本
Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

# 临时跳过当前窗口的脚本执行限制
Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass

安全提示:这些命令只会影响您自己的账户,不会影响系统安全或其他用户。

二)执行一键安装命令

复制以下命令,粘贴到 PowerShell 窗口中,按 Enter 执行:

复制代码
iwr -useb https://openclaw.ai/install.ps1 | iex

安装过程会自动完成:

检测系统环境 如果已安装会自动跳过。

安装必要依赖(Node.js 等) 如果已安装会自动跳过。

下载 OpenClaw 核心文件

配置环境变量

自动启动配置向导

可能遇到的问题请查看

OpenClaw-遇到的问题-此脚本包含恶意内容,已被你的防病毒软件阻止CategoryInfo : ParserError: (😃 [], ParentContainsErrorRecordExceptionFullyQualifiedErrorId : ScriptContainedMaliciousContent

OpenClaw-遇到的问题-D:\openclaw/node_modules/npm/bin/npm-cli.jsCategoryInfo : NotSpecified: (npm error code ENOENT:String) FullyQualifiedErrorId : NativeCommandError[], RemoteException

安装成功如下:

四、初始配置向导

安装完成后,会自动进入配置向导(openclaw onboard)。

一)风险告知

这一步主要是告诉你,使用OpenClaw可能会有一些风险。请问你是否继续?

按 向左方向键 ←,选择 Yes,按 Enter 回车确认

二)选择 QiuickStart 模式

按上下方向键,选择模式,按 Enter 回车确认

三)配置 AI 模型 API Key

OpenClaw 需要连接到大语言模型才能工作。Openclaw 比较费token,国外模型成本高,门槛也高。

可以选择国内的智谱的GLM-4.6V-Flash(免费),或者性能均衡的GLM-4.6V(收费)。

如果没有智谱的API Key,点击官方地址自己注册账号获取API key:https://www.bigmodel.cn/glm-coding?ic=RBSKXMPNJP

也可以用性价比最高的 DeepSeek V3.2(收费)。

注册地址

https://platform.deepseek.com/api_keys

按上下方向键,选择模型厂家,智谱选择 Z.AI,DeepSeek选择 OpenAI。

如果列表没有直接显示 DeepSeek,选择 Custom (OpenAI Compatible)

API Key: 填入你刚才获取的 sk-xxx。

Model ID: deepseek-reasoner 或者 deepseek-chat 或者 deepseek-coder (更多模式参考https://platform.deepseek.com/api-docs/)

URL: 填入 https://api.deepseek.com/v1

Endpoint ID: custom-api-deepseek-com

Model alias (optional) :deepseek

如果有可以选择的厂家,直接输入自己的 API Key即可:

更多配置详情参考 http://clawd.org.cn/guides/custom-ai-providers

配置成功显示如下:

可能遇到的问题- Verification failed: status 402,

Payment Required (需要付款):这是核心问题。你的 DeepSeek 账户余额不足或已欠费。即使是便宜的模型,也需要账户内有可用额度才能发起调用。

401 Unauthorized (未授权):这通常意味着 API 密钥无效、被禁用,或者与请求的端点不匹配。在余额不足的情况下,有时 API 也会先返回 402 错误。

四)连接即时通讯平台

配置完 AI 模型后,OpenClaw 会询问你要连接哪个通讯平台?

OpenClaw 原生支持的即时通信平台主要是海外的 WhatsApp、Telegram、Discord、Slack、iMessage 等,国内用户不习惯,这里国产即时通信软件大厂也跟进了,现在QQ、钉钉,飞书等都已支持接入OpenClaw

后面会把QQ机器人、飞书机器人等接入 OpenClaw,使大家可以通过QQ、飞书即可指挥OpenClaw为我们干活,但是配置比较复杂,这里我们先选择跳过,后面我们可以通过继续进行配置:

五)选择Skills

这里也选择:No,暂不配置,后面通过UI界面进行配置:

六)是否开启Hooks

操作步骤:选择跳过,先敲空格,表示选中当前项,再敲回车键

更多hooks信息参考 https://docs.openclaw.ai/hooks

五、测试

一)启动服务并打开UI界面

此时它会自动安装服务,启动服务:

复制代码
o  Installing Gateway service...
Installed Scheduled Task: OpenClaw Gateway
Task script: C:\Users\Surface\.openclaw\gateway.cmd
o  Gateway service installed.

这个过程是在启动服务,可能会需要等一点时间

同时,大约过30秒左右,浏览器自动打开Web UI界面:

如果无法打开,使用命令排查

复制代码
openclaw health

可能遇到的问题:OpenClaw-遇到的问题-Health check failed: gateway closed (1006 abnormal closure (no close frame)): no close reason

也可以手动运行启动命令

复制代码
# 进入目录并手动运行
cd C:\Users\Surface\.openclaw\
.\gateway.cmd

大概需要运行5分钟左右

观察命令行窗口输出的具体错误信息(如缺少文件、权限拒绝等)。

输出以下为正常:

记住 带有token的链接:

把链接复制好

http://127.0.0.1:18789/#token=a02e2f38904f9f922c80bd634d9a6561b214d58e9ec8b7c1

成功启动界面如下:

二)测试一下

启动成功后,进入管理面板或交互式命令行,试着给 Agent 下达第一个指令:

"请帮我在桌面上创建一个名为 hello_openclaw.txt 的文件,并在里面写入:你好,OpenClaw。"

Agent 将会自动规划任务、调用文件系统 API,并完成操作。

注意观察启动.\gateway.cmd的窗口,如果卡住不动,会有异常信息输出。

可能遇到的问题-OpenClaw-遇到的问题- FailoverError: Model context window too small (4096 tokens). Minimum is 16000

运行成功输出如下,桌面上创建了 hello_openclaw.txt 的文件。


一次简单的指令,一个请求差不多是 0.01元。具体按照任务复杂度花费的tokens计算。

六、常用命令速查

命令

openclaw onboard 重新进入配置向导

openclaw status 查看运行状态

openclaw health 健康检查

openclaw gateway start 启动服务

openclaw gateway stop 停止服务

openclaw update 更新到最新版本

openclaw doctor 诊断问题

openclaw uninstall 卸载 OpenClaw

七、常见问题解答

Q1: 提示 "openclaw 命令找不到"

解决方法:

关闭所有 PowerShell 窗口

重新打开 PowerShell

如果还不行,执行 exec bash 或重启电脑

Q2: 安装卡住不动

解决方法:

按 Ctrl + C 中断当前操作

执行:openclaw doctor

检查问题

如提示网络问题,检查防火墙设置

Q3: API Key 配置错误

解决方法:

执行:openclaw onboard

选择重新配置 API Key

确保密钥格式正确

Q4: 端口 18789 被占用

解决方法:

复制代码
openclaw gateway ---port 18790

使用其他端口启动服务。

八、成本说明

OpenClaw 软件本身完全免费,主要成本来自 AI 模型 API 调用,可选择国产大模型,降低成本。

具体价格对比可参考

https://www.datalearner.com/ai-models/api-prices

https://llmprice.cn/

若追求极致性价比,首选DeepSeek V3.2(官方渠道);若需要免费或极低成本的多模态能力,智谱AI的GLM-4.6V-Flash

下面是基于每百万tokens(1M tokens) 价格、筛选出的"便宜好用"之选:

** 最便宜:文本模型之王**

  • 模型 : DeepSeek V3.2
  • 供应商 : DeepSeek-AI (官方)
  • 输入价格 : ¥0.199 (按$0.028, 汇率7.1估算)
  • 输出价格 : ¥2.99 (按$0.42估算)
  • 核心优势 :
    • 绝对低价:在主流模型中,其标准模式下的输入价格极具竞争力。
    • 缓存优惠:支持缓存模式,对于多轮对话或长提示词场景,成本可进一步降低。

最良心:免费的多模态模型

  • 模型 : GLM-4.6V-Flash
  • 供应商 : 智谱AI
  • 输入价格 : ¥0.00
  • 输出价格 : ¥0.00
  • 核心优势 :
    • 完全免费:在表格中,它是为数不多输入和输出都免费的标准模型。
    • 多模态能力:支持文本和图片输入,能处理视觉任务,性价比极高。

** 最均衡:综合性能优选**

  • 模型 : GLM-4.6V (非Flash版)
  • 供应商 : 智谱AI
  • 输入价格 : ¥1.0 (标准)
  • 输出价格 : ¥3.0 (标准)
  • 核心优势 :
    • 平衡之选:价格适中,同样具备多模态能力,并支持缓存模式(写入¥0.5/命中免费),适合对性能有更高要求的常规任务。
    • 智谱生态:如果你需要与智谱的其他模型(如语音模型GLM-ASR)配合使用,生态集成会更方便。

选型建议与重要提醒

  1. 注意"便宜"的前提:DeepSeek的官方低价主要针对文本模型,且输出价格相对输入更高,如果应用是生成大量内容(如写作),需综合计算。
  2. 警惕涨价风险 :智谱AI已开始调价。表格中的 GLM-4.7 价格(输入¥4/输出¥16)已显著高于GLM-4.6系列 ,且未来更多模型可能跟进。免费或低价的Flash版本可能随时调整或取消,需关注官方动态。
  3. 用好"便宜"的技巧
    • 批量任务 :如果非实时,可以关注各平台的批量模式,通常有5-7折优惠(如表中DeepSeek V3.2批量输入仅$0.28)。
    • 上下文缓存 :对于固定长提示词,务必使用支持缓存模式的模型,能大幅降低输入成本。

注意,千万不要泄露大模型API的密钥,被盗用会导致经济损失。还有部分情况会导致OpenClaw执行异常反复尝试的场景,导致花费上涨。后面会给出具体的解决方案。

九、结语

OpenClaw 代表了个人 AI 助理的未来趋势------从"聊天工具"进化为"执行工具"。虽然目前的配置过程有一定门槛,但一旦完成设置,将拥有一个 24*7 待命的超级助手。

相关推荐
HaiLang_IT2 小时前
计算机科学与技术专业优质选题推荐 选题合集 | 人工智能/自然语言处理/计算机视觉
人工智能·自然语言处理·课程设计
Rolei_zl2 小时前
AIGC(生成式AI)试用 46 -- AI与软件开发过程1
人工智能·aigc
hello_fengfeng2 小时前
WSL2 安装到其他磁盘(D/E盘)完整指南
windows·ubuntu
波动几何2 小时前
信息图风格提示词方案
人工智能
tq10862 小时前
多智能体协作问题和解决方案
人工智能
gorgeous(๑>؂<๑)2 小时前
【ICLR26-Oral Paper】透过对比的视角:视觉语言模型中的自改进视觉推理
人工智能·算法·语言模型·自然语言处理
新缸中之脑2 小时前
AI代理的两种沙盒架构
人工智能·架构
HyperAI超神经2 小时前
视觉真实之外:清华WorldArena全新评测体系揭示具身世界模型的能力鸿沟
人工智能·深度学习·神经网络·机器学习·计算机视觉·机器人
AC赳赳老秦2 小时前
软件组件自动化的革命:DeepSeek 引领高效开发新时代
运维·人工智能·算法·云原生·maven·devops·deepseek