OpenClaw完整操作指南:开源AI助手框架安装配置、技能插件与日常运维全解析

今天我来分享一款此前热度很高、近期再度爆火的开源项目——OpenClaw(昵称“小龙虾”)。从现场安装到卸载,甚至衍生出了上门安装的一条龙服务。本文主要介绍我在终端环境下的配置与使用方式。

OpenClaw

OpenClaw 是一个开源的自托管个人 AI 助手框架(Apache 2.0 协议),GitHub 星标数已超过 24.7 万。它并非简单的聊天机器人,而是能够读取文件、执行命令、操作浏览器、收发邮件、定时执行任务的“数字员工”,支持 7×24 小时后台运行。

核心能力



架构概览





OpenClaw 的 Gateway 充当“交通指挥”的角色——只负责路由,不进行推理。Agent Runtime 则是“大脑”——调用大语言模型、执行工具、运行 ReAct 循环。两者分离的设计使 Gateway 始终保持轻量与稳定。


安装方法

OpenClaw 的安装流程设计得极为友好,即使是非开发者也能快速上手。

系统要求(不限于 Mac mini):

硬件:要求极低,2GB 内存即可运行。 环境:支持 Mac、Windows、Linux,需要安装 Node.js(pnpm)或使用 Docker。


推荐安装方式(一键脚本)

直接在终端执行以下命令即可。

macOS/Linux 系统:

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


Windows 系统:

#PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex #CMD curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

该脚本会自动安装 Node.js(版本 ≥22)并完成基础配置。


手动安装

需要 Node.js ≥22 并完成基础配置:

使用 npm:

npm i -g openclaw 如果速度较慢,可指定国内镜像: npm i -g openclaw --registry=https://registry.npmmirror.com

或使用 pnpm:

pnpm add -g openclaw

安装完成后,初始化并安装后台服务(launchd / systemd 用户服务):

openclaw onboard


从源码安装(开发模式)

git clone https://github.com/openclaw/openclaw.git cd openclaw pnpm install pnpm ui:build 首次运行会自动安装 UI 相关依赖并构建前端界面 pnpm build # 构建整个项目(包含后端与相关模块) # 初始化 OpenClaw 并安装为系统后台服务(开机自动运行) pnpm openclaw onboard --install-daemon # 开发模式:监听 TypeScript 代码变更并自动重载网关服务 pnpm gateway:watch


配置说明

我们推荐使用一键脚本安装。

macOS/Linux 系统:

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


Windows 系统:

#PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex #CMD curl -fsSL https://openclaw.ai/install.cmd -o install.cmd && install.cmd && del install.cmd

它会完成环境检测,安装必要的依赖,并启动 onboarding(设置向导)流程。

后期如需重新进入设置向导,可执行以下命令:

openclaw onboard --install-daemon






这里我选择的是



有三个选项,我选第一个快速启动



我已使用过,因此选择保留当前配置,大家按需选择



这里是模型配置,我配置了 DS 的模型,选择一项填写你的 API 密钥及接口,去 DS 官网查看 API 接口即可



也可以用 cc switch 配置模型,如图所示,以下是官网





这是我配置的模型,我选择保持当前



这里是配置接入,我选择飞书



我选择第二个,之前已经配置过了



我选择最后一个



点击是



我选择第一个,按空格键



我选择跳过



我选择第一个



这样就配置好了



这是我的对话

卸载

使用内置卸载程序:

openclaw uninstall 非交互式(自动化 / npx): openclaw uninstall --all --yes --non-interactive npx -y openclaw uninstall --all --yes --non-interactive


使用技能

技能是包含 SKILL.md 文件的独立文件夹。若要为 OpenClaw 代理拓展新功能,ClawHub 是查找和安装技能的最佳选择。

ClawHub 技能仓库地址:https://clawhub.ai/

ClawHub 国内镜像:https://skillhub.tencent.com/


安装 ClawHub 工具:

推荐方式(npx 无需全局安装)npx clawhub@latest --version# 或全局安装(方便以后直接用 clawhub 命令)npm install -g clawhub# 或者用 pnpmpnpm add -g clawhub

登录:

clawhub login

搜索技能:

clawhub search "postgres backups"

下载安装新技能:

clawhub install my-skill-pack

批量更新已安装技能:

clawhub update --all


插件管理

插件是轻量级代码模块,可通过新增命令、工具及 Gateway RPC 能力,为 OpenClaw 扩展额外功能。

查看已加载插件:

openclaw plugins list

安装官方插件(示例:语音通话插件):

openclaw plugins install @openclaw/voice-call

插件安装后重启网关生效:

openclaw gateway restart


日常运维命令速查




修改配置后,记得运行 openclaw gateway restart 使改动生效~