OpenClaw 本地部署安装指南

版本	作者	更新内容	时间
v1.0	Rix	本次更新重点补充了安装后的初始化配置，帮助您理解每一个步骤的实际作用，让 AI 真正“跑起来”。	2026-2-26

OpenClaw 是一个开源的个人 AI 助手平台。

简单来说，它是一个可以将你自己的 AI 助手接入你已经在用的即时通讯工具（Telegram、WhatsApp、飞书等）的系统。你可以自己挑选 AI 模型进行连接，添加各种工具和技能（如飞书等），构建专属工作流。说白了如果应用的够好，它就是一个能帮你干活的“员工”。

一、推荐硬件与系统环境

操作系统： Windows 10/11 或 macOS 12+。
硬件：建议 CPU 4 核以上，内存 16GB（运行更稳），硬盘可用空间 >5GB。

系统最低要求

项目	最低要求	推荐配置
CPU	2 核	4 核+
内存	2 GB	4-8 GB
磁盘	10 GB	40 GB+
Node.js	>= 22.0.0	最新 LTS
操作系统	macOS / Linux / Windows (WSL2)	macOS (Apple Silicon)
核心端口	TCP 18789	TCP 18789 + 80

二、快速部署方式总览

部署方式对比表

部署方式	难度	成本	适用场景	设置时间
一键脚本安装	⭐ 最低	免费 + API费用	本地快速体验	~5 分钟
npm 全局安装	⭐⭐ 低	免费 + API费用	开发者日常使用	~5 分钟
Mac Mini 本地部署	⭐⭐⭐ 中	800-2000 美金硬件	零云端费用、隐私优先	~30 分钟
Docker 容器化	⭐⭐⭐ 中	免费 + API费用	隔离运行、安全优先	~15 分钟
阿里云轻量服务器	⭐⭐ 低	68元/年起 + API	国内用户快速上手	~10 分钟
腾讯云 Lighthouse	⭐⭐ 低	99元/年起 + API	国内用户快速上手	~10 分钟
DigitalOcean 1-Click	⭐ 最低	5-12 美金/月 + API	海外用户一键部署	~5 分钟
Emergent.sh	⭐ 最低	免费层可用	零配置体验	~5 分钟
Railway / Render	⭐⭐ 低	0-7 美金/月 + API	开发者云部署	~8-12 分钟
macOS VM (Lume)	⭐⭐⭐⭐ 高	0 美金（本地VM）	iMessage集成、完全隔离	~20 分钟
Cloudflare Workers	⭐⭐⭐⭐ 高	5 美金/月起	无服务器、高可扩展	~15 分钟

二、快速安装步骤

打开命令行工具

Windows 用户：点击“开始”，搜索 PowerShell 并打开。
macOS 用户：按 Command + 空格，输入 终端 或 Terminal 并回车。

步骤 1：下载并安装依赖

安装 Homebrew（如未安装）

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

安装 Node.js 22+

brew install node@22

验证 Node.js 版本

node --version # 应显示 v22.x.x 或更高

（可选）安装 Ollama 用于本地模型推理brew install ollama

步骤 2：安装 OpenClaw

在命令行中依次输入：

# 方式一：一键脚本（推荐）curl -fsSL https://openclaw.ai/install.sh | bash# 方式二：npm 全局安装npm install -g openclaw@latest# 方式三：从源码编译git clone https://github.com/openclaw/openclaw.git && cd openclawpnpm install && pnpm ui:build && pnpm build

步骤 3：运行配置向导（这步会自动进入）

openclaw onboard --install-daemon

三、核心：初始化配置详解（重点）

安装完成后，AI 还不能直接工作，需要进行“初始化配置”。这一步是给 AI 联网、给它“大脑（模型）”以及“工具箱”。

这一步主要是提醒你，使用 OpenClaw 可能会有一些风险。请问你是否继续？按向左方向键 ←，选择 Yes，按 Enter 回车确认；
选择选择 QiuickStart（快速开始模式），回车；
这里是配置 AI 模型 API Key，OpenClaw 需要连接到大语言模型才能工作。Openclaw 比较费 token，国外模型成本较高，新版本已经支持KIMI K2.5 ，小编以KIMI为例；

注：其他任意模型均可，也可以用 Ollama 本地运行的 DeepSeek 的蒸馏版，即可免费使用 AI 模型。
如果没有 KIMI 的API Key，打开下方官方地址注册账号获取API key，KIMI 认证后的账号可以获得15元的免费代金券；

https://platform.moonshot.cn/console/api-keys
然后复制你的API key，请保存好自己的 API；
选择Kimi API key (.cn)，回车；
然后输入你的API Key，回车；
选择保持当前（moonshot/kimi-k2.5），回车；
接着你会看到选择聊天选择工具的选项。这里你建议先「暂时跳过」，先在终端（Terminal）里把 OpenClaw 跑起来，确认它的 AI 大脑、文件读写权限都正常工作，后面再单独部署；
这里选择「Yes」，也可以暂不配置选择「No」，后面通过UI界面再进行配置；
选择「npm」；
关于技能，你可以先跳过选择此步骤，或者使用空格键您需要的技能，可多选；
这里可以配置备用 API，如果不想配置就都选「No」即可；
正在完成最后的启动服务配置，大约30秒左右；
配置完成，选择「Open the web UI」，打开可视化页面；
安装完成，浏览器自动打开 Web UI 界面；在overview菜单，查看是否有其他问题。

把 OpenClaw 接入飞书机器人（其他IM以此类推）

首先进入飞书开放平台。登录成功后，点击创建企业自建应用；
接着填写应用名称（如 “AppOS-OpenClaw助手”）、应用描述，选择应用图标，点击「创建应用」按钮，进入应用管理页面；
在添加应用能力中选择「机器人」→ 点击「添加」；
在开发配置中点击「权限管理」→「开通权限」；
在搜索框内搜索「im:」勾选全部相关权限名称，最后点击「确认开通权限」；
点击左侧「云文档」勾选全部相关权限名称，最后点击「确认开通权限」；
点击顶部「创建版本」按钮；
简单填写相关内容，然后点击「保存」；
点击「确认发布」；
机器人发布完成，开始配置OpenClaw
为了防止与自带的飞书文件夹冲突，我们直接把之前的先全部删掉，方便后面顺利安装，输入下方代码到终端内，然后回车，输入开机密码执行；运行项目并下载源码
```
sudo rm -rf ~/.openclaw/extensions/feishu
```
清理完成后，接着下载飞书插件，在终端输入下方代码，然后回车，输入开机密码执行；运行项目并下载源码
```
openclaw plugins install @m1heng-clawd/feishu
```
正在下载飞书插件，耐心等待即可；
出现下面界面表示飞书插件安装成功；
在输入下方输入代码，然后回车，输入开机密码执行；

openclaw config 运行项目并下载源码
选择「Local (this machine)」，然后回车;
选择「Channels（渠道）」，然后回车；
选择「Configure/link（配置链接）」，然后回车；
选择「Feishu/Lark（飞书）」，然后回车；
打开飞书开放平台，在「应用凭证」里，复制 AppID 和 AppSecrect；
在终端对应位置分别输入飞书的 AppID 和 AppSecrect；
选择「Feishu（feishu.cn）- China 」，然后回车；
选择「Open – respond in all groups（requires mention）」，然后回车；
选择「Finished」然后回车；
选择「Yes」，回车；
选择「Open…」，回车；
选择「Continue」，回车；
配置完成，关闭终端；
重新打开终端，然后输入下方代码，重启配置；

openclaw gateway 运行项目并下载源码
打开飞书开放平台，选择「事件与回调」→「订阅方式」→「使用长连接接收事件」→「保存」；
然后点击同一页面内的「添加事件」；
在弹出的列表中，搜索并添加「接收消息」、「消息已读」、「机器人进群」、「机器人被移出群」，最后点击「确认添加」；
添加完成后如下图所示；
点击「权限管理」→搜索「通讯录」→选中「获取通讯录基本信息」→「确认开通权限」；
配置完成后我们需要重新发布新版本，点击顶部「创建版本」；
按如图所示输入；
点击「确认发布」；
打开手机端「飞书」，搜索机器人的名字，给机器人发消息，如果机器人以AI的方式进行回复，那么恭喜你配置成功（太不容易了）。

四、 OpenClaw常用命令

OpenClaw 技能库

最后再推荐两个 OpenClaw 技能库，它就是给你的 AI 装上一堆「技能插件」，让它从“动嘴皮子”变成“真能干活”。

宝藏仓库地址 GitHub 地址：https://github.com/VoltAgent/awesome-openclaw-skills
ClawHub，精英特工的技能平台。https://clawhub.ai/

里面包含内容众多，可根据自身需求进行安装

五、常见问题排查

npm install 报错：检查 Node.js 版本是否太低，建议使用 node -v 确认是 v22 以上。
AI 不回复：检查 .env 文件里的 API_KEY 是否正确，以及网络能否正常访问模型接口。
工具无法使用：确保 mcp_config.json 里的工具路径是正确的绝对路径。

六、卸载

两种方式：

如果 openclaw 仍已安装，使用简单方式。
如果 CLI 已删除但服务仍在运行，使用手动服务移除。

简单方式（CLI 仍已安装）

七、寻求帮助

如果在安装或配置过程中卡壳，请联系作者技术支持：

微信号： wx_rixzhang （请加微信）

一、 推荐硬件与系统环境