封面图
前言
OpenClaw（社区俗称 “龙虾”）是一款主打本地优先、隐私安全、自主执行的开源 AI 自动化智能体平台，支持对接各类云端与本地大模型，可通过聊天界面远程控制电脑完成文件处理、代码编写、浏览器操作、任务自动化等实际工作，凭借轻量化部署、跨平台兼容和活跃的开源生态，成为当前极受欢迎的本地 AI 执行工具。
Openclaw具有如下特点：
- 本地优先，隐私可控：全本地部署，数据与记忆本地存储不上传云端，支持离线运行，保障数据主权。
- 强执行能力：具备系统级权限，可直接操作文件、终端、浏览器、访问外部服务，完成自动化任务，而非仅文字对话。
- 模型无关：兼容 GPT、Claude和百炼等大模型服务商，此外还可以支持vLLM等本地大模型，可自由切换。
- 跨渠道交互：无需专用 App，通过 Slack、Discord、微信、飞书等聊天工具远程控制。
- 主动与持久化：支持 24/7 后台运行、定时任务、心跳检测，可主动监控与触发流程。
- 开源可定制：MIT 协议开源，模块化架构，支持自定义技能与二次开发。
- 轻量跨平台：支持 Windows/macOS/Linux，部署便捷、资源占用低。
本篇为大家讲解Openclaw的部署和安装。
安装环境要求
Openclaw的安装分为两种方式，一种是直接安装，另一种是通过Docker安装。
直接安装需要依赖系统下的Node.js，但Docker无此要求。Docker的安装较为简单但如果出现问题不容易排查（Openclaw的Docker镜像为了精简，缺失大量系统工具），建议有能力的读者采用直接安装的方式。
注意：因Openclaw运行的权限较高，可以操作机器所在文件系统。因AI的行为不可控，可能误删除文件或者是破环系统环境，造成不可估量的损失。因此建议不要在实际生产环境或者主力办公机器上安装。建议使用虚拟机或者是Docker环境，限制AI的操作范围。
直接安装
安装Node.js
无论是Windows还是MacOS，Linux，需要事先安装Node.js。Openclaw对Node.js的版本要求较高，如已经安装过，建议先升级到新版本。
MacOS 安装Node.js，需要事先在MacOS中安装好Homebrew。然后执行：
brew install node
安装Node.js。
Linux或者Windows WSL 安装Node.js方法和实际上运行的发行版本有关。可以先search一下已存在的按照包，例如node，nodejs，npm等等。然后再根据提供的包，和系统中实际缺失的包的情况再安装。以Ubuntu为例，可使用如下命令安装。
apt install nodejs npm
Windows环境安装可以从https://nodejs.org/download/release/latest/下载Windows安装包（exe或者是msi格式文件），然后双击按照向导安装。
安装Openclaw
上一步Node.js安装完毕之后执行：
npm config set-registry https://registry.npmmirror.com
npm install -g openclaw@latest
首先设置Node.js的源为国内源，加快下载速度。然后使用npm全局安装openclaw的最新版本。
等待第二条命令执行完成，openclaw安装成功。
安装后配置
Openclaw安装之后需要简单配置下才能使用。
首先执行：
openclaw onboard
进入配置向导，首先是安全须知页面
翻到最下面：
选择Yes继续。接着Onboarding mode选择QuickStart。
接下来是配置模型提供商。根据自己申请的模型服务，选择对应的模型服务商，需要准备好API key。
如果是本地独立部署的服务，选择vLLM。可以对接vLLM、Ollama等本地模型推理服务。
注意：经过试用2026.2.x版本中没有找到vLLM，使用本地模型服务的用户建议安装Openclaw的最新版。
这里我们以vLLM为例。
不知道如何安装Ollama或者vLLm的读者，可以参考：
Ollama 服务Docker部署简明教程
vLLM 部署和使用简介
选择vLLM之后需要配置vLLM的地址，将其修改为实际环境的地址。
接着填写vLLM的API key。不知道API key的用户可以在vLLM的运行环境下执行
ps -ef | grep vllm
返回示例如下：
root 21140 1 0 Mar05 ? 00:01:04 /root/vllm011/bin/python3 /root/bin/vllm serve /model/Qwen3_32B ... --api-key sk-xxxxxxx --served-model-name Qwen3_32B
找到--api-key参数，后面的值就是API key，将其复制到Openclaw安装向导中。
对于Ollama，由于Ollama本身不用配置API key，这一步API key可以任意填写。
紧接着是Model Name配置。同样，在前面ps命令返回结果中找到--served-model-name参数，后面的名称即模型名。
如果使用的是Ollama，可以运行ollama list命令，查看模型名。示意图如下：
填写完模型名称之后，最后需要选择默认模型，这里选择keep current，即刚刚配置的模型。
接着而来的是Channel配置。Channel配置可以让openclaw接入Discord，Slack，国内的飞书，QQ等IM工具，从而实现“远程控制”的功能。不配置channel的情况下仍可以通过网页对话的方式操作Openclaw，并不影响其功能。具体方式在后续博客内介绍。这里选择最下方的Skip for now跳过配置。
然后是Skills配置。Skills即Openclaw的能力，可以具体做哪些事，对接哪些外部系统（例如web搜索，微博，小红书等）。这里我们选择No，暂不配置。
我们继续，接下来是Hooks配置。Hooks可以让外部系统触发Openclaw动作。同样选择Skip for now跳过配置。
最后是配置gateway。Gateway即网关服务，可以通过web页配置和操作Openclaw。由于这里已经安装过Gateway，可以选择Restart，重启Gateway。
如果是首次接下来会自动安装gateway服务。
如果使用的是openclaw 2026.3.2版本，该步骤在Ubuntu系统下可能会出现如下错误：
原因是该版本有bug，建议使用openclaw2026.3.1版本。也可以等待社区发布修复版本后尝试。安装openclaw2026.3.1的步骤首先使用
openclaw uninstall
卸载掉openclaw，然后指定版本重新安装。
npm install -g openclaw@2026.3.1
配置完Gateway之后选择操作方式（上一步出错的话，没有这一步配置），是在控制台中使用还是打开浏览器Web UI。这里我们选择Do this later。
配置 gateway
执行openclaw gateway status，查看gateway状态。如下图所示：
从上图我们找到：
Runtime: stopped (state inactive, sub dead, last exit 0, reason 0)
说明Gateway处于停止状态。
执行如下命令启动gateway：
openclaw configure --section gateway
选择This Machine。
填写gateway端口，可以采用默认的18789端口。
选择绑定模式，如果只在本机访问（127.0.0.1），选择Loopback，安全性最高。如果想在局域网访问，选择LAN。这里选择LAN模式。
接着是gateway认证方式选择，建议选择token方式。
是否暴露Tailscale，选择off。
最后一步，如果前面选择的是token方式认证，这里需要指定Gateway token。示例图如下：
设置完token之后，gateway配置完成。
执行：
openclaw gateway install
安装gateway服务。
最后执行：
openclaw gateway start
启动Gateway。
Web UI token配置
使用浏览器访问http://localhost:18789。出现如下页面，并且无法操作Openclaw：
unauthorized: gateway token missing (open the dashboard URL and paste the token in Control UI settings)
很明显是没有认证。
回到命令行执行：
openclaw dashboard --no-open
找到下方的Dashboard URL：复制到浏览器打开。错误信息不再提示，大功告成。
可以尝试在chat页面和大模型对话。
到此为止Openclaw安装和配置完成。
Docker安装
Docker安装较为简单，只有一条命令
执行如下命令：
docker run -d --name openclaw -p 18789:18789 -e OPENCLAW_GATEWAY_TOKEN=abcedfg --network host ghcr.io/openclaw/openclaw:2026.3.2
如果镜像无法拉取，请查找国内Docker镜像站获取镜像。具体方法可参考其他博客。
需要注意的是，启动Docker镜像必须指定OPENCLAW_GATEWAY_TOKEN环境变量，配置gateway的token，否则会启动失败。
然后执行docker exec -it openclaw bash，进入容器内再执行openclaw onboard开始向导配置。配置过程和前面直接安装类似。但有一个问题，向导自动重启openclaw gateway的时候容器会停止执行。此时可以执行：
docker start openclaw
再次拉起容器。上次配置的内容仍会保留。
其余配置方式和直接安装完全相同。如果需要Docker内的Openclaw操作本机文件或者是持久化保存一些资料到本机磁盘，可以将目录挂载到Docker镜像中。方法为docker run命令增加-v参数：
docker run -v /your_folder:/home/node ...
Docker安装Openclaw的方法就介绍到这里。祝各位读者养虾快乐^_^
