跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客GitHub 精选镜像工具UI配色美学隐私政策关于联系
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
JavaScriptNode.jsAI大前端

OpenClaw 开源 AI 助手安装与使用教程

综述由AI生成OpenClaw 是一款基于 Node.js 的开源本地 AI 助手,支持浏览器自动化、桌面控制及多端接入。安装前的环境准备(Node.js 22+、API Key),提供了一键脚本、npm、源码及 Docker 四种安装方式。配置完成后通过 onboard 向导设置模型与密钥,验证环境后可启动 Web 界面或使用 CLI 对接微信、飞书等渠道。适合前端开发者作为 AI 自动化练手项目。

RefactorPro发布于 2026/4/6更新于 2026/5/2128 浏览

一、OpenClaw 是什么?

OpenClaw(社区俗称「小龙虾」)是一款可本地/自建的开源 AI 助手,特点是「能干活」:除对话外,支持浏览器自动化、桌面控制、向量记忆、定时任务等,并可通过 Gateway 接入微信、飞书、Telegram、Discord 等渠道。技术栈以 Node.js 为核心,适合作为「AI + 自动化 + 多端接入」的练手或生产项目。

本文介绍安装流程与配置方法。


二、安装前准备

2.1 系统与硬件
  • 系统:Windows 10/11、macOS 12+(推荐 14+)、或 Linux(如 Ubuntu 20.04+、Debian 11+)
  • 内存:至少 2GB,推荐 4GB 以上
  • 磁盘:预留约 500MB
  • 网络:需要联网(调用各类 AI API)
2.2 必装环境:Node.js

OpenClaw 依赖 Node.js 22 或更高版本(推荐 LTS)。若未安装:

  • 官网下载:https://nodejs.org/

或用 nvm 管理多版本:

# 安装并切换到 Node 22
nvm install 22 && nvm use 22

安装后验证:

node -v # 应 >= v22.x.x
npm -v
2.3 准备一个 AI API Key(必选)

OpenClaw 本身免费,但需要接入一家 AI 服务商的 API:

  • 新手推荐:MiniMax — 国内直连、提供免费试用额度,无需信用卡
  • 其他可选:Claude、GPT、DeepSeek、通义等(按官方文档配置对应 Key 即可)

先到所选平台注册账号,在控制台里拿到 API Key,安装完成后在配置向导里填入。


三、安装方式(任选其一)

方式一:一键脚本(最省事)

Windows(PowerShell,以管理员身份运行):

iwr -useb https://clawd.org.cn/install.ps1 -OutFile install.ps1; ./install.ps1

macOS / Linux:

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

也可使用带参数的安装(例如指定 git 方式):

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-method git

脚本会自动处理依赖,一般 3~5 分钟即可完成。


方式二:npm / pnpm 全局安装(适合前端同学)

已熟悉 Node 生态的话,可以直接:

npm install -g openclaw # 或使用 pnpm(推荐)pnpm add -g openclaw@beta

安装完成后,在终端输入 openclaw 或 claw 应能识别。


方式三:从源码安装(适合想改代码、学架构的前端)
git clone https://github.com/openclaw/openclaw.git
cd openclaw
pnpm install
pnpm build

之后可通过项目内的 CLI 或脚本启动,便于阅读和二次开发。


方式四:Docker 部署(适合有容器经验的)
docker pull openclaw/openclaw:latest
docker run -d --name openclaw -p 3000:3000 -v ~/.openclaw:/root/.openclaw openclaw/openclaw:latest

按需把端口 3000 改成你本机未被占用的端口。


四、第一次配置:openclaw onboard

安装完成后,务必先跑一遍配置向导:

openclaw onboard

(若使用源码安装,可能是 pnpm run onboard 或项目内提供的等效命令,以仓库说明为准。)

向导会引导你:

  1. 选择 AI 模型 / 供应商(如 MiniMax、Claude、DeepSeek 等)
  2. 填写 API Key(上一步准备好的)
  3. 选择聊天平台(如微信、飞书、Telegram 等,可先不选,后续再配)
  4. Gateway 等高级选项(一般默认即可)

配置会写入 ~/.openclaw/(Windows 一般在用户目录下的 .openclaw),之后可手动编辑同一目录下的配置文件做进阶调整。


五、验证安装是否成功

在终端执行:

openclaw --version # 查看版本
openclaw doctor    # 环境与依赖自检

若 doctor 通过,说明环境正常。接下来可启动本地 Web 界面或对接聊天平台。


六、启动与使用

6.1 Web 界面(前端/学习最直观)

很多安装方式会默认启动 Web 服务,或提供类似命令:

openclaw start # 或按文档说明启动 Web

浏览器访问:**http://127.0.0.1:18789/**(端口以实际文档为准,常见 18789 或 3000)。 在这里可以直接和 OpenClaw 对话,并体验「浏览器操作」「电脑控制」等能力,对前端同学理解「AI + 前端」交互非常直观。

6.2 安装「技能」模块(可选)

按需安装官方/社区技能,例如:

claw install browser      # 浏览器操作
claw install desktop-control # 电脑控制
claw install vector-memory # 记忆系统
claw install auto-updater # 自动更新

装好后在 Web 或聊天平台里即可使用对应能力。

6.3 接入微信 / 飞书 / Telegram

在 openclaw onboard 或配置文件中按文档填写对应平台的 Token/密钥,即可在聊天软件里和同一只「小龙虾」对话,实现「多端一个助手」。


七、学习与前端向的小建议

  1. 先 Web 再聊天:先把 Web 界面玩熟,再接微信/飞书,更容易理解「对话 → 任务 → 执行」的流程。
  2. 看源码:若你偏前端,可 clone 官方仓库,从 Web UI 和技能插件的代码看起,对理解 AI 产品形态很有帮助。
  3. 成本:软件免费,主要成本是 AI API 调用费;MiniMax 等有免费额度,适合练手和做小项目。
  4. 遇到问题:优先查 OpenClaw 官方文档、GitHub Issues 和社区支持。

八、小结

步骤动作
1. 环境安装 Node.js 22+,准备一个 AI API Key
2. 安装一键脚本 / npm 全局 / 源码 / Docker 任选
3. 配置执行 openclaw onboard 选模型、填 Key
4. 验证openclaw doctor、openclaw --version
5. 使用浏览器打开 Web 地址,或接入微信/飞书等

按上述流程走一遍,你就能在本地拥有一个「能干活的」小龙虾 OpenClaw,非常适合作为 学习 AI + 前端 的实战入口。

目录

  1. 一、OpenClaw 是什么?
  2. 二、安装前准备
  3. 2.1 系统与硬件
  4. 2.2 必装环境:Node.js
  5. 安装并切换到 Node 22
  6. 2.3 准备一个 AI API Key(必选)
  7. 三、安装方式(任选其一)
  8. 方式一:一键脚本(最省事)
  9. 方式二:npm / pnpm 全局安装(适合前端同学)
  10. 方式三:从源码安装(适合想改代码、学架构的前端)
  11. 方式四:Docker 部署(适合有容器经验的)
  12. 四、第一次配置:openclaw onboard
  13. 五、验证安装是否成功
  14. 六、启动与使用
  15. 6.1 Web 界面(前端/学习最直观)
  16. 6.2 安装「技能」模块(可选)
  17. 6.3 接入微信 / 飞书 / Telegram
  18. 七、学习与前端向的小建议
  19. 八、小结
  • 💰 8折买阿里云服务器限时8折了解详情
  • Magick API 一键接入全球大模型注册送1000万token查看
  • 🤖 一键搭建Deepseek满血版了解详情
  • 一键打造专属AI 智能体了解详情
极客日志微信公众号二维码

微信扫一扫,关注极客日志

微信公众号「极客日志V2」,在微信中扫描左侧二维码关注。展示文案:极客日志V2 zeeklog

更多推荐文章

查看全部
  • Dify 工作流实战:快速搭建专业 Web 登录界面
  • C++ 进阶:unordered_set 与 unordered_map 模拟实现
  • JavaScript 基础:location 对象属性与用法
  • 激光雷达点云滤波核心技术:高效去噪算法与实战优化
  • C++ 多态的概念、实现与原理详解
  • 通义万相 2.1 多模态 AI 生成技术解析与应用前景
  • FPGA 实现 OV5640 摄像头视频图像显示
  • IO 多路复用 select 接口解析与服务器实战
  • C++ STL 核心容器模拟:unordered_set 与 unordered_map 实现
  • Linux 命令行进度条实现原理解析
  • 前端现代化:从传统到现代的技术演进
  • GLM-4.6V-Flash-WEB 食品包装识别准确性验证
  • HarmonyOS 底部导航栏组件 rc_concave_tabbar 使用指南
  • STL 文件预览工具:Windows 资源管理器直接查看 3D 模型
  • WebGoat 靶场实战:环境搭建与漏洞解析
  • Neo4j 图数据库安装与操作指南 (Mac 版)
  • C++ 函数重载:规则、实现与实战案例
  • 前端国际化实战:i18n 选型、架构设计与 RTL 布局避坑
  • GitHub Copilot 智能编程助手功能详解
  • MCPo 技术解析:MCP 协议转 OpenAPI 代理与集成实践

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Keycode 信息

    查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具,Keycode 信息在线工具,online

  • Escape 与 Native 编解码

    JavaScript 字符串转义/反转义;Java 风格 \uXXXX(Native2Ascii)编码与解码。 在线工具,Escape 与 Native 编解码在线工具,online

  • JavaScript / HTML 格式化

    使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具,JavaScript / HTML 格式化在线工具,online