备受关注的开源AI助手OpenClaw,因其能够直接操作本地电脑执行任务,而不仅仅是聊天问答,吸引了大量希望提升效率的用户。它能将AI大模型(作为“大脑”)与用户的电脑(作为“手脚”)连接起来,实现整理文件、操作浏览器、管理日程等自动化工作。然而,相较于普通软件,OpenClaw的安装部署过程更为复杂,涉及环境配置、命令行操作等步骤,这使得许多非技术背景的用户在入门时遇到困难。本文将总结一套完整的OpenClaw安装流程与关键注意事项,帮助初学者顺利完成部署。
一、 安装前的环境准备
成功安装OpenClaw的前提是做好充分的环境准备,这能避免绝大多数安装失败的情况。
你需要一台主流操作系统的电脑,无论是Windows 10/11、macOS还是Linux系统均可,并建议至少有8GB内存以保证流畅运行。
也是最关键的一步,是安装Node.js。OpenClaw对Node.js的版本有严格要求,必须是v22.0.0或更高的版本。这是导致安装失败最常见的原因。在安装前,你可以在终端(Windows下为命令提示符或PowerShell,macOS/Linux下为终端)中输入`node -v`来检查当前版本。如果版本过低或未安装,需要前往Node.js官网下载最新LTS版本进行安装。安装时,请确保勾选“Add to PATH”选项,以便系统能正确识别相关命令。

此外,由于部分安装过程需要从代码仓库拉取文件,电脑上最好也安装了Git。
你需要准备一个大模型的API密钥(API Key)。OpenClaw本身只是一个执行框架,需要接入AI模型才能“思考”。你可以根据自己的需求,选择如DeepSeek、Kimi、智谱AI或Claude、GPT等模型,并提前在其官方平台申请好API密钥,妥善保存以备后用。
二、 核心安装步骤
对于初学者而言,最推荐的安装方式是使用官方提供的一键安装脚本,它能自动处理大部分依赖和配置,大大降低了操作门槛。
对于Windows用户,首先需要以“管理员身份”运行PowerShell,这一点至关重要,否则后续步骤会因权限不足而失败。然后,在打开的窗口中执行一键安装命令 `iwr -useb https://openclaw.ai/install.ps1 | iex`。如果网络访问不佳,可以使用国内镜像地址的脚本。
对于macOS和Linux用户,操作类似,只需打开终端,执行 `curl -fsSL https://openclaw.ai/install.sh | bash` 即可。

脚本会自动下载并安装OpenClaw及其所需组件。等待几分钟,当终端提示安装成功后,可以输入 `openclaw --version` 来验证,如果能看到版本号,则说明核心程序已成功安装。
除了脚本安装,熟悉开发环境的用户也可以选择通过npm或pnpm进行全局安装,或者使用Docker进行容器化部署,后者在安全隔离方面更具优势。
三、 首次配置与启动
安装完成后,还需要进行一次初始化配置。在终端输入 `openclaw onboard` 命令,系统会启动一个交互式的配置向导。
向导会引导你完成一系列设置,其中最核心的是配置AI模型。你需要选择你准备使用的模型供应商,并填入之前获取的API密钥。至于连接飞书、Telegram等聊天工具的“通道(Channel)”设置,以及扩展功能的“技能(Skills)”,初次安装时可以选择暂时跳过,待基本功能跑通后再进行配置。
配置完成后,你可以通过 `openclaw gateway` 命令启动其核心网关服务,然后另开一个终端窗口输入 `openclaw dashboard`,浏览器便会自动打开一个本地控制台界面(通常地址为 `http://127.0.0.1:18789`)。至此,你就可以开始与你的AI助手进行交互了。
四、 接入聊天工具与常见问题
为了实现随时随地通过手机或电脑下达指令,用户通常会将其接入飞书、Discord等即时通讯工具。以飞书为例,大致流程是在飞书开放平台创建一个企业自建应用,为其开启机器人功能并配置相应权限,获取App ID和App Secret,再回到OpenClaw的配置中添加飞书通道并填入凭证。整个过程涉及在不同平台间进行设置,需要耐心和细致。
在安装和使用过程中,可能会遇到一些常见问题。例如,提示“命令未找到”,通常是Node.js或OpenClaw的环境变量没有正确配置;提示“权限不足”,则需要确保以管理员身份运行终端;如果AI只能对话却无法执行文件操作等任务,可能是新版本中工具的执行权限默认被关闭,需要手动修改配置文件(通常是 `~/.openclaw/openclaw.json`)来启用。
五、 安全与成本提醒
必须强调的是,OpenClaw拥有非常高的系统权限,能够读写你的文件、执行命令。因此,从安全角度出发,强烈建议将其安装在备用电脑或使用Docker等沙盒环境中运行,避免在主力工作机上直接部署,以防误操作导致数据丢失或泄露。
在成本方面,OpenClaw软件本身是免费的,但调用大模型API会产生费用,并且在执行复杂任务或长时间待机时,Token消耗可能超出预期。为了控制成本,建议日常任务选用价格更低的国产模型或轻量级模型,并在模型供应商的后台设置消费上限。
OpenClaw是一款功能强大的AI助手框架,但其安装部署具有一定的技术门槛。只要遵循正确的步骤,耐心做好环境准备和基础配置,绝大多数用户都能成功“养”起这只“龙虾”,体验AI带来的效率革命。