前置依赖:Node.js与Homebrew的安装准备

安装OpenClaw之前,必须确保系统已具备Node.js和Homebrew这两个核心依赖。首先访问Node.js官网(nodejs.org),在首页选择“Get Node.js”按钮,推荐下载LTS版本(Long Term Support),因为这是长久供应的稳定版。以演示用的24版本为例,根据操作系统选择对应的安装包(如macOS的.pkg或Linux的二进制包),并勾选安装nvm和npm。复制官网提供的命令行代码,打开终端(Terminal),粘贴并回车执行下载。> “Node.js直接输入nodejs.org进入它的官网,进来之后选择第一个Get Node.js。”

安装过程中若终端提示需要手动处理环境变量,不要盲目跟随错误指引。回到官网复制第二条配置命令(通常涉及PATH或Shell配置文件),在终端粘贴执行;接着从官网获取第三条命令nvm install 24,同样在终端粘贴并回车。等待片刻后,通过输入node -v和npm -v验证版本号是否成功显示。最后使用clear命令清空终端屏幕,标志着Node.js环境配置完毕。随后访问Homebrew官网(brew.sh),复制其官方安装脚本,在终端粘贴并回车。由于博主已预装Homebrew,此处省略具体等待过程,但需确保该工具就绪。> “进入终端之后...它只是一个交互的软件而已,我们可以把它当成一个word。”

OpenClaw的一键安装与环境初始化

当Node.js和Homebrew均就绪后,即可开始安装OpenClaw。访问OpenClaw官网,找到针对Mac或Linux系统的一键安装代码。该脚本会自动检测Node.js等前置环境是否完整,若缺失则自动补全。对于Windows用户,官网提供了另一条专用的安装指令,流程类似但命令不同。若熟悉npm操作,也可通过npm install -g openclaw进行安装,但官方推荐的一键脚本能提供更完善的自动化检查。> “一键安装这边,它会去帮助你检查你的Node.js等等内容。”

回到终端粘贴复制的一键安装命令并回车,系统随即启动配置流程。首先进行环境配置检查,随后进入OpenClaw的核心安装阶段。当前演示版本为2026.6.6。整个过程无需人工干预,只需等待进度条完成。博主提示此处可加速观看,当终端显示安装成功并出现交互选项时,表示核心程序已部署。此时需使用键盘左右方向键切换“yes”与“no”,选中高亮的yes后按回车进入下一步。这一步骤标志着OpenClaw本体已就绪,接下来将进入交互式配置向导。> “我们看到这里第一步,他在配置这个环境;第二步已经开始安装OpenClaw了。”

模型接入:选择OpenRouter与API Key配置

进入配置向导后,首要任务是选择AI模型提供商。虽然系统支持Google、Anthropic、OpenAI及MiniMax等主流大模型,包括英伟达和千问的API接口,但博主强烈推荐使用OpenRouter。选择OpenRouter后按回车,系统提供两种认证方式:使用API Key或授权登录。本教程选择第一种(API Key),因为这种方式更灵活且易于控制成本。

前往OpenRouter官网注册账号并充值。登录后,点击右上角的Workspaces(工作区),进入后选择第一个选项创建API Key。点击“New”按钮自定义名称(如OpenClaw),并设置限额策略。为防止Token被意外耗尽,建议输入具体金额限制(如10美元),并可选择按月或按天设定上限。若选择N/A,则仅受总限额约束。最后设置API Key的有效期(根据实际需求设定),点击Create生成以sk-开头的密钥。复制该Key回到终端粘贴,按回车确认。> “这里我推荐大家使用OpenRouter...这里面它支持大部分这种大模型。”

默认设置与通讯渠道的跳过策略

粘贴API Key后,系统进入模型选择阶段。博主建议直接使用默认选项(回车),后续将通过配置文件调整具体使用的模型,无需在此处纠结。接着是通讯渠道(Channel)配置,系统询问是否安装飞书、微信或企业微信等插件。由于这些渠道涉及复杂的网络配置和后续调试,博主建议初学者暂时跳过。使用上下键选择“Skip for now”并回车。> “这里我们一般选择第一个快速启动...第二第三个大家可以根据自己的一个情况去尝试。”

随后是搜索引擎配置。系统询问使用何种搜索工具,博主计划后续接入Tavily Search,因此此处同样选择跳过。接下来是技能(Skills)安装。博主演示了是否启用ClawHub,这是OpenClaw的官方技能库。若选择安装且系统已装Homebrew,则自动通过npm部署;否则需手动处理。由于ClawHub可能需要Google API Key且非核心必需,博主选择跳过(No)。> “这里的话它是使用搜索引擎...后面的话我们会使用这个Tavily Search。”

高级Hook脚本与权限设置

配置向导进入Hooks(钩子)选择环节。这是OpenClaw的高级功能,用于自动化处理会话状态。博主建议正式用户勾选全部5项: 1. 欢迎信息与初始化:常用问候及环境状态检查。 2. 文档读取:启动时自动加载agent.md和tools.md等身份文件。 3. 日志记录:便于审计、排错及查询历史记录。 4. 会话压缩提示:当对话历史被精简时,发送明显聊天提示告知用户。 5. 上下文保存:执行new或reset命令时,将当前上下文保存为Markdown文件,构建长期知识库。

“如果我们是正式的去使用OpenClaw的话,就建议把这5项全部给它勾选起来。”

完成Hook选择后,系统询问环境权限。若希望OpenClaw控制当前环境的手机或设备,可点击“允许”;否则选择“不允许”。最后确认启动方式,直接选择第一个选项(终端模式)即可。至此,OpenClaw的基础安装全部完成。

验证状态与后续配置预告

安装结束后,按两次Command + C退出当前进程。博主强调,理解终端如同Word文档一样直观即可操作。通过输入命令openclaw status检查运行状态,显示“Running”即表示服务正常启动。然而,此时Agent尚未接入任何通讯渠道,功能受限。

为了进一步使用,需输入openclaw dashboard打开网页端控制面板。在Dashboard中,用户可以赋予AI Agent个人角色、技能配置及详细参数。博主预告后续内容将涵盖:接入飞书等通讯渠道、安装高级技能(Skills)、配置多个Agent以避免单个Agent上下文过长导致的记忆混乱,以及如何通过分工提升效率。> “整体来讲其实是非常的简单的...我们可以在终端中输入openclaw status去检查一下目前OpenClaw的一个状态。”

关键配置数据与操作总结

为确保读者能准确复现,以下整理安装过程中的关键版本信息与配置选项。所有数值均基于视频演示时的实际显示,未做模糊化处理。

配置项 推荐值/演示版本 说明
Node.js LTS版本 24.x (演示用) Long Term Support,稳定版
OpenClaw安装版本 2026.6.6 (演示用) 当前最新稳定版
API Key限额示例 $10 (总/月/日) 防止Token无限消耗,可自定义
ClawHub安装方式 npm (需Homebrew) 官方技能库,依赖包管理器
Hook脚本勾选数 5项全选 (推荐) 包含日志、文档读取及上下文保存
通讯渠道配置 Skip for now (跳过) 建议后续单独配置飞书/微信
搜索引擎选择 Skip for now (跳过) 后续计划接入Tavily Search

“这里,可以给它选择不允许...当然如果你希望通过OpenClaw去控制你当前环境的一些手机的话,也可以给它点击一个允许。”

整个安装流程的核心逻辑是:环境准备(Node/Homebrew)→ 一键部署 → API Key认证 → 基础功能跳过/高级Hook启用。通过这一结构化步骤,用户可在几分钟内获得一个可交互的本地AI Agent基础框架。后续的配置(如多Agent分工、特定Channel接入)将基于此稳固的基础进行扩展,确保每个Agent专注于单一任务,从而优化上下文记忆与响应效率。