谁不想在自家的电脑上养一个“听话”又懂技术的数字员工呢？OpenClaw作为近期在技术圈子里热度飙升的本地化AI项目，凭借其强大的 Neng力和对本地环境的深度掌控，吸引了一大批极客和开发者的目光。不过说实话，想要把这个大家伙请到本地运行起来中间的坑可不少。别担心，今天我们就来一场硬核的“开荒”之旅，手把手教你搞定OpenClaw的本地部署，哪怕你只是个刚入门的技术小白，只要跟着节奏走，也Neng顺利通关。

一、工欲善其事：环境准备与避坑指南

在正式开始之前，我们得先把地基打好。OpenClaw这玩意儿有点“挑剔”，对运行环境有硬性要求。Ru果这一步没走稳，后面全是报错，搞心态得hen。

1. Node.js版本是道坎

你的电脑里必须得有Node.js。但请注意，OpenClaw可不是随便给个Node就Neng跑的，它明确要求Node版本必须在22以上。别拿你那两三年前装的Node 16或者18来硬撑，绝对会报错。我的建议是直接去官网下载Zui新的LTS版本，哪怕是Node 24.x也没问题，小版本号的差异几乎Ke以忽略不计。安装完后记得打开终端，输入 node -v 确认一下版本号，kan到v24.xx.x这样的字眼，才算心里有底。

2. Git与网络连通性

除了Node，Git也是必不可少的。Windows用户可Neng需要去Git官网单独下载安装，而Mac用户通常自带这个工具。同样，在终端里敲一下 git --version，只要没报“command not found”，那就没问题。

这里有个极其重要的前提：请务必确认你的网络Neng访问 https://github.com/openclaw/openclaw。因为OpenClaw是开源项目，安装过程本质上是从GitHub拉取代码到本地。Ru果连这个地址dou打不开，那后续的步骤就像是无米之炊，天王老子来了也救不了你。Ru果网络不通，建议先解决“梯子”的问题，否则寸步难行。

3. Mac用户的Homebrew噩梦

对于Mac用户来说安装过程中可Neng会遇到一个让人头秃的问题——Homebrew。hen多脚本依赖这个包管理器，但官方源在国内的连接速度感人，经常卡在安装界面一动不动。Ru果你发现终端一直在转圈圈，别傻等，赶紧中断，去搜一下国内镜像安装Homebrew的方法。比如使用Gitee上的安装脚本，Neng省下你喝咖啡的时间。先把 brew 命令搞定，这是Mac系统级指令的核心，别在这个阴沟里翻船。

二、正式安装：把OpenClaw拉到本地

环境确认无误后我们就Ke以开始动真格的了。这一步的目标是在你的机器上安装OpenClaw的核心程序。

打开终端，根据你的系统类型，执行相应的安装命令。对于Mac和Linux用户，通常Ke以使用一行命令搞定：

curl -fsSL https://openclaw.ai/install.sh | bash
# 或者分开执行，geng稳妥一点
npm i -g openclaw@latest

Windows用户则Ke以使用PowerShell：

iwr -useb https://openclaw.ai/install.ps1 | iex

执行完这些命令后屏幕上会开始滚动一堆日志。这时候你不需要kan懂每一行在写什么只要没有红色的Error报错，就让它慢慢跑。有时候网络波动会导致npm安装失败，或者因为之前的缓存残留导致卡死。Ru果不幸遇到了记得把之前的缓存清理干净，或者换个国内的npm镜像源重试。安装完成后输入 openclaw --help，Ru果kan到帮助信息弹出来恭喜你，第一步成功了！

三、核心配置：注入灵魂与大脑

装上软件只是第一步，OpenClaw现在还只是一个空壳，它需要“大脑”和“记忆”。这就涉及到配置文件的修改，这也是新手Zui容易懵圈的地方。

1. 获取千问API Key

OpenClaw默认对接的是千问的大模型，所以你需要去阿里云的千问平台搞一个API Key。这就像给机器人办一张身份证。登录千问开放平台，找到API Key创建页面生成一个新的Key并复制下来。这串字符至关重要，千万别弄丢了。

2. 修改JSON配置文件

接下来是重头戏。你需要编辑OpenClaw的配置文件。这里有个大坑要提醒大家：虽然OpenClaw提供了Web UI，但在Web UI里直接修改Raw JSON并保存时由于某些敏感信息脱敏策略，页面有时候不会及时显示geng新后的内容。这会让你以为修改失败了其实后台可NengYi经改好了。所以Ru果你对终端操作不排斥，我强烈建议直接用命令行工具去修改配置，或者修改后去Chat里问它“配置改了吗？”，这样geng靠谱。

你需要重点关注两个字段：

models下的apiKey： 在配置文件里找到 models -> providers -> qwen-portal -> apiKey。把这里面的占位符替换成你刚才从千问平台复制来的Key。这步不Zuo，你的AI就是个哑巴。

agents下的workspace： 找到 agents -> defaults -> workspace。这里需要填入你的工作空间目录，也就是OpenClaw存放文件的路径。Ru果这个字段是空的，它就不知道去哪里读写数据，直接填上你的OpenClaw文件夹地址即可。

其他的配置项，比如 wizardauth 之类的，Ru果你kan不懂，Zui好别乱动，改坏了可Neng会导致服务起不来。改完这些，记得保存并重启服务。

四、连接飞书：让AI走进你的日常

虽然OpenClaw自带Web界面但要想随时随地跟它聊天还是接入飞书这种即时通讯工具Zui方便。这就需要我们安装飞书插件并进行一系列的授权配置。

1. 安装飞书插件

在终端中输入以下命令，把飞书插件装上：

openclaw plugins install @openclaw/feishu

安装完成后回到OpenClaw的Web Dashboard，你应该Neng在频道列表里kan到Feishu的选项了。

2. 飞书开放平台配置

这一步稍微繁琐一点，需要你去飞书开放平台折腾一番：

创建企业自建应用。登录飞书开放平台，创建一个新应用，类型选“机器人”。创建好后你会kan到 App ID 和 App Secret，把这两个值填回到OpenClaw的飞书配置里。

接着，配置权限与事件。在飞书后台的“权限管理”里搜索并开通 im:message等必要的权限。然后在“事件与回调”里添加订阅方式，选择“长连接”。这一步是为了让飞书Neng把消息实时推送给你的OpenClaw。

Zui后发布版本。在左侧菜单找到“版本与管理”，创建一个新版本并发布。不发布的话，hen多权限是不会生效的。

3. 配对连接

配置dou填好之后回到OpenClaw的终端或者Chat界面执行配对命令。系统会生成一个临时的配对码，你需要用这个码去完成绑定：

openclaw pairing approve feishu  --notify

Ru果一切顺利，你在飞书App里搜索刚才创建的机器人，就Neng发消息给它了。Ru果它一直回复“access not configured”或者不理你，那多半是DM Policy没设置对，或者飞书那边的权限没授权给你的账号，回去检查一下“开放策略”是不是设为了Open。

五、技Neng ：别让AI变成只会聊天的废柴

OpenClaw的强大之处在于它Neng安装各种Skills，让它Neng帮你干活，比如写代码、查资料、甚至控制你的电脑。但在安装技Neng时新手hen容易踩坑。

hen多人听说OpenClawNeng自动安装技Neng，就直接让它去装。结果它默认使用 web_search 去搜，这又需要配置搜索引擎的API Key，导致失败。正确的姿势是告诉它：

不要用 web_search，直接用 clawhub search/install 来安装 skills

这样它就会直接从内置的插件源里拉取，速度快还不容易报错。装上几个常用的技Neng后你的AI助理才算真正具备了战斗力。

六、常用命令与维护

部署完成不代表一劳永逸，日常维护还得靠几个核心命令。建议把这些记在小本本上，以备不时之需：

启动/停止服务： openclaw gateway start / openclaw gateway stop

查kan状态： openclaw gateway status

打开控制台： openclaw dashboard

卸载重装： Ru果实在玩脱了想彻底重来Ke以用 openclaw uninstall --all --yes，这会删库跑路，包括配置文件，慎用！

有时候，Web UI上显示“disconnect: no reason”或者一直显示“updating”，别慌，这大概率是UI显示的Bug。实际上后台可NengYi经连上了。你Ke以试着在Chat里发个指令，或者点击Reload按钮重置一下。

享受你的本地AI生活

折腾到这里kan着屏幕上那个活蹦乱跳的AI助理，是不是hen有成就感？OpenClaw的本地部署虽然过程曲折，充满了各种“大坑”和“小坑”，但一旦跑通，那种数据掌握在自己手中、无需kan云端脸色的安全感，是任何SaaS服务dou给不了的。而且，随着你不断给它安装新的Skills，它会变得越来越聪明，越来越懂你。现在去倒杯咖啡，开始和你的专属AI员工愉快地聊天吧！

---