行动型智能体正在悄然改变我们与AI的互动方式。从被动回答到主动执行，从单纯对话到真实操控，每一次任务完成都无需人工干预。OpenClaw（又称“龙虾”，曾用名Clawdbot）正是这一变革中的先锋力量。本文为零基础用户提供一份完整的入门指南，帮助你从零开始，搭建属于自己的第一个行动型智能体。
一、什么是OpenClaw？行动型智能体的核心引擎
很多人对AI的印象还停留在“聊天机器人”的层面，但OpenClaw将这一认知彻底刷新。它是一个开源免费的AI智能体框架，核心价值在于让大模型真正“长出双手”。
从对话到行动的本质跃迁
OpenClaw与传统AI助手有着本质区别。它对自然语言的理解，不止于给出回答，而是能够直接操作电脑、读写文件、运行命令、浏览网页、对接各类第三方平台，完成真实的自动化任务。这种“指令即执行”的能力，使其成为一个真正意义上的数字员工，而不是只会聊天的工具。
OpenClaw的架构设计围绕三个核心组件展开：
网关（Gateway）负责多平台接入和消息路由，支持飞书、Telegram、Discord等多种渠道，智能体可以接入团队常用的沟通工具。
大脑（Agent）是大模型能力的执行中枢，可以对接通义千问、Kimi、Claude及本地运行的开源模型，自由选择最适合的模型底座。
手脚（Skills）是执行能力的具体体现，社区提供海量技能插件，覆盖办公自动化、开发辅助、信息检索、内容创作等各类场景，支持按需安装与自定义扩展。
OpenClaw支持私有化部署，所有数据保存在本地，用户完全掌控自己的隐私，从而避免了数据外泄的风险。正是这种“数据我做主、模型自由选、能力随意扩”的特性，使其成为个人和小型团队打造专属AI助手的首选方案。
二、环境准备：开始前的必要检查
在正式搭建之前，需要确认电脑环境满足基本要求。OpenClaw对硬件的门槛并不高，即使是普通办公设备也能顺利运行。
系统与硬件要求
OpenClaw支持三大主流操作系统。Windows用户推荐使用Windows 10或11（最好配合WSL2），macOS要求12及以上版本，Linux则推荐Ubuntu 22.04及以上版本。
硬件方面，最低配置要求为2GB内存和1GB磁盘空间，但如果计划同时运行多个技能或处理复杂任务，推荐配置4GB以上内存、4核以上CPU以及10GB以上硬盘空间。
核心依赖安装
OpenClaw运行在Node.js环境之上，要求Node.js版本为22.0.0或更高。如果尚未安装，可根据操作系统选择对应的安装方式：
Windows用户：访问Node.js官网，下载左侧的LTS版本，双击安装即可。
macOS用户：可使用Homebrew包管理器安装，执行brew install node@22。
Linux用户（Ubuntu/Debian）：通过NodeSource仓库安装，依次执行系统更新、仓库配置和安装命令。
安装完成后，在终端执行node -v，如果输出v22.x及以上版本号，说明Node.js安装成功。
此外，部分技能需要使用Python环境，建议安装Python 3.10及以上版本；如果采用源码安装方式，还需要Git工具来克隆代码仓库。
国内网络环境优化
建议在执行安装前，将npm镜像切换为国内源，可以大幅提升下载速度：
npm config set registry https://registry.npmmirror.com
设置完成后，执行npm config get registry即可验证是否配置成功。
三、两种部署方案：云服务器 vs 本地设备
OpenClaw提供两种主流的部署路径，各有侧重，可根据实际使用场景灵活选择。
云服务器部署
云服务器部署适合需要7×24小时不间断运行、支持多设备远程访问、或需要团队协作使用的场景。云服务器全天候在线，智能体不会因本地电脑关机或睡眠而中断，最适合定时任务、监控值守等持续性工作。
本地设备部署
本地设备部署则适合个人日常使用、注重数据隐私、不希望额外购买服务器的用户。数据完全在本地处理，不上传任何云端，隐私安全更有保障；开箱即用的特性也使得无需复杂配置，几分钟内便可完成。
两种方案的核心安装逻辑是一致的，只是运行环境和配置步骤略有不同。新手学习阶段推荐先在本地部署上手体验，后续需要7×24小时运行时再迁移到云上。
四、安装OpenClaw：三步搞定
无论选择云服务器还是本地设备，安装OpenClaw都可以通过以下步骤快速完成。
第一步：一键命令，全局安装
最推荐的安装方式是一键脚本，它会自动检测并安装Node.js及所有依赖，无需手动配置复杂环境：
macOS / Linux：在终端中执行curl -fsSL https://openclaw.ai/install.sh | bash
Windows：以管理员身份打开PowerShell，执行iwr -useb https://openclaw.ai/install.ps1 | iex
脚本执行完成后，OpenClaw便已全局安装到系统中。运行openclaw –version验证安装是否成功，看到版本号输出即表示一切正常。
第二步：初始化配置
安装完成后，执行初始化命令openclaw onboard，系统会启动交互式配置向导，引导完成以下核心设置：
提示框会首先询问是否了解使用风险，选择Yes并回车。
选择QuickStart快速安装模式，这是新手最省心的选择。
模型选择：根据偏好选择AI模型（如Kimi、OpenAI或Claude）。如果选择Kimi，需要访问其平台获取API Key粘贴到终端。
渠道选择：选择与OpenClaw沟通的载体。新手可以先选择TUI（终端交互界面）直接对话体验，后续再配置飞书、Telegram等聊天渠道。
技能安装：按需选择想要安装的技能插件，默认选中的技能足够日常使用，直接按回车确认即可。
配置过程中大部分选项使用默认值即可，一路回车也不会出错。
第三步：启动服务并验证
配置完成后，执行启动命令openclaw打开控制台，浏览器将自动打开本地访问地址http://127.0.0.1:18789。若能正常打开控制台页面，说明OpenClaw已成功运行。
可以输入openclaw status查看运行状态，输入openclaw gateway status查看网关状态，输入openclaw tui则可以回到终端交互界面开始聊天。
五、大模型API配置：为智能体注入灵魂
安装了OpenClaw框架之后，还需要选择一个大模型作为智能体的“大脑”。大模型API（应用程序编程接口）的配置是整个过程中非常关键的一环。
获取免费大模型API
很多大模型服务商为新用户提供免费试用额度。以阿里云百炼平台为例，新用户可以享受90天的免费调用额度，无需任何费用即可开始使用。
获取API密钥的流程一般是：注册并登录对应平台的服务控制台，找到“密钥管理”或“API Key管理”模块创建新的API密钥，复制生成的密钥字符串并妥善保存——密钥仅在创建时可查看，丢失后只能重新生成。
配置API密钥到OpenClaw
配置方式根据部署方案略有不同：
云服务器部署：在服务器控制台的应用详情中，找到API密钥配置入口，将此前获取的密钥填入并保存，系统会自动写入配置。
本地部署：在OpenClaw控制台的“模型配置”或“设置”页面中，选择对应的模型服务商，粘贴API密钥即可生效。
支持的模型生态
OpenClaw具备模型无关的特性，理论上可以对接任意兼容OpenAI格式接口的大模型。常用模型包括阿里云百炼系列、Kimi、Claude、MiniMax以及本地运行的Ollama等。用户可以根据自己的预算、性能需求和隐私偏好自由切换。
六、技能管理：让智能体真正“会做事”
如果说大模型提供了通用的推理能力，那么技能（Skills）就是OpenClaw执行具体任务的手臂和手脚。技能生态是OpenClaw相较于其他AI框架的核心优势之一。
技能是什么
技能是模块化、可复用的能力单元。需要智能体搜索知识库？安装搜索技能。需要它解析PDF文件？安装文档处理技能。需要它操作浏览器？安装浏览器自动化技能。智能体实际上是由不同功能的技能组合起来，共同完成复杂任务的。
如何安装和使用技能
OpenClaw社区提供了规模庞大的技能库。通过控制台的“技能市场”或“插件管理”面板，可以浏览、搜索和安装各类技能。只需点击安装，技能便自动加载到系统中，智能体即可调用该技能完成对应操作。
安装时机与优先级
入门阶段：只需安装最基础的技能即可（如文件管理、网络搜索、文本处理），避免一次性安装过多技能导致系统臃肿、响应变慢。
进阶阶段：根据实际场景需要，按需添加专业技能。例如，日常办公可安装邮件自动化、表格处理、日程管理等；内容创作可安装文章生成、排版优化、多平台发布等。
避免盲目安装：技能虽多，但并非每个都常用。建议边用边装，确保每个技能都会被高频调用。
七、管理与监控：确保智能体稳定运行
智能体部署完成并投入使用后，日常管理和运行监控同样重要。
运行状态监测
通过openclaw status命令可以查看智能体的整体运行状态；openclaw gateway status则专门查看网关服务的健康度。定期检查这些状态，有助于及早发现异常。
服务控制
与其他后台服务一样，OpenClaw支持启动、停止、重启等常规操作。如果需要停止智能体运行，在终端按下Ctrl + C即可中断。
安全配置建议
行动型智能体能够执行真实操作，因此安全配置不容忽视。建议在新手入门阶段注意以下几点：
权限控制：智能体在初始安装时通常只被授予基础文件操作权限。执行敏感操作（如删除文件、修改系统设置）前务必三思，确保指令无误。
渠道绑定：如果配置了飞书、Telegram等外部渠道，确保只有授权用户可以向智能体下达指令，避免被他人滥用。
定期检查：养成查看操作日志的习惯，了解智能体在过去一段时间内执行了哪些操作，及时发现异常行为。
八、常见问题与避坑指南
新手在部署过程中难免遇到一些障碍，以下是几个高频场景及应对方法：
问题一：npm安装速度极慢或超时这是国内网络访问国外源时最常见的问题。解决方法是在安装前配置国内npm镜像源，例如淘宝镜像https://registry.npmmirror.com。配置完成后清理npm缓存并重新安装。
问题二：Windows系统提示权限不足或脚本无法执行多数情况下需要使用管理员权限打开PowerShell。在开始菜单搜索PowerShell，右键选择“以管理员身份运行”，再执行安装命令即可。
问题三：GitHub资源下载失败如果采用源码安装方式，从GitHub拉取代码时可能遇到速度慢或超时的问题。可以启用代理加速或更换SSH方式克隆。安装完成后，建议取消临时设置的代理，恢复默认网络配置。
问题四：安装后在终端找不到openclaw命令运行npm prefix -g查看全局包的安装位置，确认该目录是否已添加到系统的PATH环境变量中。如果未包含，需要手动将路径添加到shell的启动配置文件中。
九、实践从今天开始
读完这份指南，你已经具备了从零搭建一个行动型智能体的全部知识。从认识OpenClaw的本质，到完成环境准备、执行安装、配置大模型API、安装技能，每一个环节都已讲透。
实践永远是学习的最佳路径。花上十几分钟，跟着教程在自己的电脑上完成第一次安装，亲手向智能体发出第一个指令，感受它完成操作的瞬间——远胜于阅读任何攻略。
行动型智能体的未来充满可能。它是你的24小时在线助理，自动搜索资料、编写文章、整理文件；是办公效率的核心，自动处理邮件、安排日程、生成报告；是开发任务的得力帮手，完成代码分析、环境搭建、文档生成。这一切不需要昂贵的硬件、复杂的技术或高昂的成本。
OpenClaw已经从实验室走向了每个人的桌面。从今天开始，打造属于你的第一个行动型智能体吧。