OpenClaw 部署实战指南 · 从零把开源 AI 员工跑在自己机器上

它到底能做什么

文件与命令

读写文件、执行 Shell、跑脚本。可以给完整系统权限，也可以关在沙盒里。

浏览器与消息

通过 CDP 打开网页、填表单、抓数据、截图；在 Telegram、WhatsApp、Discord 等渠道里跟你对话。

记忆与定时

跨会话保留上下文和你的偏好；定时任务与 Webhook 让它主动开工，不用你每次去戳。

三步跑起来

从空机器到能对话，三步

备料
装 Node.js 22 以上，准备一把 AI 服务商的 API Key，或者装 Ollama 走完全本地。
安装
一行安装脚本，或 npm 全局安装。Windows 走 WSL2，也可以直接跑官方 Docker 镜像。
配置
跑 onboard 向导：命名、选模型、粘 Key、接上聊天渠道，然后发出第一条消息。

01 · OpenClaw 是什么

OpenClaw（前身 Clawdbot，中间叫过 Moltbot）是 Peter Steinberger 发起的开源自主 AI 代理。它跑在你自己的设备上——Mac mini、Linux 服务器、树莓派，或者通过 WSL2 跑在 Windows 上。

跟 ChatGPT、Claude 这类对话产品的区别在于：它不只回答问题，它真的去做。管理文件、执行 Shell 命令、操控浏览器、发送消息、跑定时任务——全天候、本地、完全由你掌控。

它与模型无关：Anthropic Claude、OpenAI、Google Gemini 都能接，也可以通过 Ollama 用完全本地的模型。你跟它的交互全在日常聊天软件里完成，支持的渠道包括 WhatsApp、Telegram、Discord、Slack、iMessage、Signal、Teams、Matrix，以及自带的 WebChat。

能力	说明
文件与命令	读写文件、执行命令、运行脚本。完整系统访问或沙盒模式二选一。
浏览器控制	通过 CDP 浏览网站、填写表单、提取数据、截图。
持久记忆	学习你的偏好和上下文，记忆跨会话保存。
定时与 Webhooks	主动任务、定时作业、事件驱动的自动化。
100+ 技能	预配置插件，也可以自建，它甚至能自己写新技能。
50+ 集成	智能家居、Notion、Obsidian、GitHub、Apple 生态等。

02 · 开跑之前，先对一眼配置

项目	要求
操作系统	macOS 10.15+ / Linux（Ubuntu 20.04+）/ Windows 10+（需 WSL2）
Node.js	v22+，硬性要求
内存	2 GB 起，推荐 4 GB 以上；跑本地模型需要 8 GB 以上
硬盘	500 MB 以上
网络	用云端模型必须联网；完全本地部署可以不联网
AI 服务商	Anthropic / OpenAI / Google 的 API Key，或用 Ollama 跑本地模型

社区里最常见的一套是 Mac mini M2/M4（16 GB）常年开机——静音、省电（原站给的示意是约 3 美元一个月电费，以你的电价为准）、性能够用。但任何一台 Mac、Linux 机器，甚至一台 4 GB 的树莓派 4，都能跑起来。

03 · 装 Node.js，拿一把 API Key

OpenClaw 要求 Node.js 22 以上。如果你用后面的一键安装脚本，它会自动处理这一步；想手动装，按你的系统选一种。

macOS（Homebrew）

# 没装 Homebrew 的话先装
$ /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

# 装 Node.js 22
$ brew install node@22

# 验证
$ node -v

Linux / WSL2（NodeSource）

$ curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
$ sudo apt install -y nodejs
$ node -v

nvm（任何系统通用，也最好回滚）

# 安装脚本里的版本号，去 nvm 官方 README 复制当前那一行，不要照抄旧教程
$ curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh | bash

# 重开终端，然后
$ nvm install 22
$ nvm use 22
$ node -v

三种模型来源，挑一种

Anthropic Claude（原站标为推荐）。工具调用和代理行为上表现最稳。去 console.anthropic.com 建一把 Key，也可以用 Claude Pro/Max 订阅凭证。
OpenAI。去 platform.openai.com 建 Key，具体可选型号以你打开时控制台里列出的为准。
Ollama（完全本地）。零云端依赖，从 ollama.com 装好再拉模型，需要 8 GB 以上内存。国内网络下这也是最省事的一条路。

04 · 安装 OpenClaw，四选一

一键脚本（推荐） —— 自动检测 Node、完成安装，并直接拉起配置向导。

$ curl -fsSL https://openclaw.ai/install.sh | bash

npm —— 你已经有 Node 22+，想自己控制每一步。

$ npm install -g openclaw@latest

# 然后跑配置向导
$ openclaw onboard --install-daemon

--install-daemon 会把 OpenClaw 注册成后台服务（macOS 用 launchd，Linux 用 systemd），开机自启。想让它 7×24 待命，这个参数别省。

Windows —— 必须走 WSL2，不推荐原生 Windows。

PS> wsl --install

提示重启就重启，之后从开始菜单打开 Ubuntu，创建用户名和密码，再在 Ubuntu 终端里跑上面那行一键脚本。

Docker —— 想把它关在容器里，这是最干净的方式。

$ docker run -d --name openclaw \
  -v ~/.openclaw:/root/.openclaw \
  -p 18789:18789 \
  ghcr.io/openclaw/openclaw:latest

# 然后进容器跑向导
$ docker exec -it openclaw openclaw onboard

05 · 配置向导会问你六件事

装完跑 openclaw onboard，交互式向导会一路问下来：

接受风险声明。它功能强，风险也是真的，需要你确认理解后才继续。
给代理起个名字。Atlas、Jarvis、Nova、Friday 都行，这就是你之后在聊天里叫它的方式。
选模型服务商、粘 API Key。Anthropic（原站标为推荐）、OpenAI、Google 或 Ollama。Anthropic 这边一般是性价比款和能力最强款两个档，具体型号名以向导当天列出的选项为准，别照抄任何教程里写死的名字。
选聊天渠道。WhatsApp、Telegram、Discord、Slack 等，之后还能再加。具体配置见下一节。
装技能（可选）。向导会列一批内置技能，可以先跳过。在你有能力审计第三方代码之前，只用内置的。
启用 Hooks。三个值得开：Boot hook（启动例程）、Command logger（审计日志）、Session memory（上下文窗口快满时自动存盘——最重要的一个）。三个都开。

配置写在 ~/.openclaw/config.json，随时可以手动改。

06 · 接上聊天渠道

Telegram

打开 Telegram 搜 @BotFather（认准蓝色认证标志），发 /newbot。设一个显示名和一个以 bot 结尾的唯一用户名，BotFather 会回给你一串 Token。
向导问渠道配置时把 Token 粘进去。然后给这个新机器人发条消息触发配对流程，批准配对码即可。

WhatsApp

在向导里选 WhatsApp。OpenClaw 用 Baileys 库通过二维码连接，不需要 WhatsApp Business API。
向导会在终端里画出二维码。手机上打开 WhatsApp，进设置，点右上角的二维码图标，扫一下。

Discord

去 Discord 开发者平台新建一个应用，进 Bot 设置，打开「Message Content Intent」，复制 Bot Token，再把机器人邀请进你的服务器。
向导里粘上 Token，并在配置里写上你自己的 Discord 用户 ID 做白名单——这一步别跳，否则服务器里任何人都能指挥它。

07 · 发出第一条消息

确认 Gateway 在跑：

# 没有注册成守护进程的话，手动起
$ openclaw gateway

然后在已连接的聊天软件里给它发消息，正常几秒内就有回应。四条适合当第一句的：

你能做什么？
把桌面上所有截图移到一个新建的 Screenshots 文件夹
查一下天气，如果要下雨就提醒我带伞
总结一下我收件箱里最近 5 封邮件

08 · 技能与 Hooks

技能（Skills）是扩展它能力的插件。官方生态里有 100+ 预配置的 AgentSkills，涵盖 Shell 命令、文件管理、网页自动化、智能家居、Notion、Obsidian、GitHub、Apple 生态等。你也可以自己写——或者直接让它替你写一个。

安全规则：如果不是你写的，也没读过代码，就不要装。 第三方技能可以在你的机器上执行任意代码。在你有能力审计之前，只用内置技能。

09 · 常用命令速查

# 启动 / 重启 Gateway
$ openclaw gateway
$ openclaw gateway restart

# 体检，把配置问题暴露出来
$ openclaw doctor

# 实时日志
$ openclaw logs --follow

# 查看所有连接状态
$ openclaw status --all

# 升级到最新版
$ npm install -g openclaw@latest

# 管理 Hooks
$ openclaw hooks

# 重新跑配置向导
$ openclaw onboard

10 · 安全须知，请认真对待

这是一个长期运行的高权限服务，有文件访问、Shell 执行和网络能力。它不是玩具。把 ~/.openclaw 当成密码库来对待——里面躺着你所有渠道的 Token 和 API Key。

不要跑在你的主力设备上。 用一台专用机器、虚拟机、VPS 或 Docker 容器，把个人数据隔开。手边没有闲置的 Mac mini，租一台常年开机的 VPS 装 Docker 跑也一样，出事重建一台就行。
永远不要把 18789 端口暴露到公网。 这个端口上的控制界面等于完整的代理控制权。要远程访问就走 Tailscale 或 SSH 隧道。
初期开着确认模式。 在配置里设 exec.ask: "on"，写入和执行类操作前都要经你批准。等信任建立起来再逐步放宽。
定期体检。 openclaw doctor 用来查配置和连接问题；如果你的版本还带独立的安全审计子命令，以 openclaw --help 的输出和官方文档为准，别照抄旧教程里的命令名。

官方资源

装之前先把这几个地址存好：

官网与安装脚本入口：openclaw.ai
官方文档：docs.openclaw.ai
源码与 issue：github.com/openclaw/openclaw
社区 Discord：入口挂在官网首页

去 OpenClaw 官网 →

掌握其中 10%，你已经是地球玩家。

本页是 OpenClaw 的第三方部署笔记，不是官方站点，也不隶属于 OpenClaw 项目。文中命令、版本号、模型型号名与配置项会随版本变动，一律以官方文档和你当下跑出来的实际输出为准。OpenClaw 是高权限服务，自行部署带来的数据、账号与设备安全风险由部署者自行承担。

常见问题

Gateway 没反应，日志里写「0 tokens used」怎么办？

多半是守护进程停了，或者 API 认证没过。先 openclaw gateway restart 重启，再回配置里核对 API Key 是不是过期、余额是不是用完。重启后仍无响应，用 openclaw logs --follow 看实时日志。

报「RPC probe: failed」是什么意思？

18789 端口被别的进程占了。用 sudo lsof -i :18789 找出占用的进程再结束它，然后重新启动 Gateway。

提示 Node.js 版本过旧？

OpenClaw 要求 Node.js 22 以上，这是硬性要求。用 nvm 最省事：nvm install 22 然后 nvm use 22，再 node -v 确认版本。系统包管理器装的老版本 Node 可能还留在 PATH 前面，确认一下当前生效的是哪个。

装完提示 command not found？

先重开一个终端窗口，多数情况就好了。还不行说明 npm 全局 bin 目录不在 PATH 里：npm config set prefix ~/.npm-global，再把 ~/.npm-global/bin 加进 PATH，重新加载配置文件。

国内网络能装吗？

安装脚本从 openclaw.ai 拉取，文档在 docs.openclaw.ai，源码和 issue 在 GitHub，社区在 Discord——这几个域名在国内网络下通常需要自备网络条件才能打开。装之前先在这台机器上确认能连通，否则会卡在下载那一步。用云端模型还要能连上对应服务商的接口；如果这条走不通，Ollama 本地模型是唯一不依赖境外网络的路。

跑起来一个月要花多少钱？

OpenClaw 本身开源免费，花钱的是模型调用和那台常年开机的机器。模型费按 token 走，取决于你用哪家、跑多频繁；机器可以是家里闲置的 Mac mini（电费很低），也可以是一台按月付费的 VPS。原站给过「约 3 美元一个月电费」的示意数字，实际以你的电价和机型为准。

把 AI 员工跑在自己机器上

开源、自托管、模型可换。装在你自己的硬件上，数据不出门，指令在聊天框里下。