如何在Windows上安装并使用OpenClaw(个人AI助手)

monster
0
2026-07-21

最近开始折腾个人AI助手,发现OpenClaw这个项目挺有意思的。它是一款开源的AI助手框架,支持接入多种大模型(DeepSeek、ChatGPT、Claude等),可以作为你的私人编程助手、聊天机器人,甚至能控制你的设备。下面记录一下在Windows上从头安装配置OpenClaw的全过程。

安装准备

OpenClaw 基于 Node.js,可以在 Windows、macOS、Linux 上运行。安装前需要准备以下环境:

  • Node.js:v18 以上版本,建议 LTS 版本。可以直接从 nodejs.org 下载安装包安装。

  • npm/yarn:安装 Node.js 时自带,包管理工具。

  • Git:可选,用于拉取源码或主题。

  • 系统要求:Windows 10/11,8GB 内存以上推荐。

安装 Node.js

OpenClaw 依赖 Node.js 环境,首先确保你的电脑上已经安装了 Node.js。

打开命令行(Win+R 输入 cmd),输入以下命令检查是否已安装:

node --version
npm --version

如果能看到版本号,说明已经安装过了。如果提示"不是内部或外部命令",则需要去 Node.js 官网下载安装包安装。

安装 OpenClaw

OpenClaw 可以通过 npm 全局安装,非常简单,一行命令搞定:

npm install -g openclaw

安装完成后,验证是否安装成功:

openclaw --version

如果能显示版本号,说明 OpenClaw 已经安装成功了!

初始化配置

安装完成后,需要运行初始化命令来生成配置文件和目录结构:

openclaw init

这个命令会在当前用户目录下创建一个 .openclaw 文件夹,里面包含配置文件和工作空间。默认的目录结构如下:

~/.openclaw/
  workspace/      # 工作空间,存放你的文件和项目
  config.yaml     # 主配置文件
  plugins/        # 插件目录
  skills/         # 技能目录

配置模型接入

OpenClaw 本身不包含大模型,需要接入第三方模型服务。以 DeepSeek 为例,你需要先在 DeepSeek 开放平台注册并获取 API Key。

然后编辑 config.yaml 文件,配置模型信息:

# config.yaml 模型配置示例
providers:
  deepseek:
    apiKey: "sk-你的API密钥"
    baseUrl: "https://api.deepseek.com"
    model: "deepseek-chat"

同样也可以配置 OpenAI、Claude、Gemini 等其他模型。

启动 OpenClaw

配置完成后,启动 OpenClaw 服务:

openclaw gateway start

启动后,你可以在终端里直接跟它对话,也可以配置 Discord、Telegram、微信等渠道,把它接入到各种聊天平台中使用。

配置渠道(以 WebChat 为例)

OpenClaw 支持多种聊天渠道,使用最多的就是 WebChat(浏览器聊天的 Web 界面)。在 config.yaml 中启用 WebChat:

# config.yaml
channels:
  webchat:
    enabled: true
    port: 3080

重启后,浏览器打开 http://localhost:3080 就能看到聊天界面了。

常用操作命令

这里整理了一些日常会用到的命令:

# 启动网关
openclaw gateway start

# 查看状态
openclaw status

# 查看配置
openclaw config get

# 安装插件
openclaw plugin install <插件名>

# 查看已安装技能
openclaw skill list

# 查看会话
openclaw session list

总结

整体来说,OpenClaw 的安装配置流程非常流畅,从零到能用大概只需要十几分钟。Node.js 生态的包管理让安装变得很简单,配置也都是 YAML 格式,清晰直观。

比较适合喜欢折腾、想要自己定制 AI 助手的开发者。如果你也在用类似的工具,欢迎交流~

动物装饰