最近开始折腾个人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 助手的开发者。如果你也在用类似的工具,欢迎交流~