零基础安装 OpenClaw:打造你的专属 AI 助手

OpenClaw 是一个开源的 AI 代理框架，让你在本地跑一个属于自己的智能助手——能聊天、能读文件、能操作浏览器、能接微信飞书，还能帮你干活。一句话：它是你的第二大脑，而且这次真的能记住事儿。

和 ChatGPT、文心一言那种网页聊天工具不同，OpenClaw 不只是一个对话界面。它是一个真正能持续运行的代理（Agent），有自己的记忆系统、技能库、定时任务，还能连接到你的各种聊天渠道。你给它配好之后，它就像团队里的一个同事，随时在线，随叫随到。

这篇是系列第一篇，从零开始，手把手带你把 OpenClaw 装起来、配好、跑通。不需要任何编程基础，跟着步骤走就行。

其实就一件事：Node.js v22 或以上。

OpenClaw 是用 TypeScript 写的，跑在 Node.js 上。如果你的电脑已经有 Node.js，先确认版本：

node --version

输出 v22.x.x 或更高就行。如果是 v18、v20，需要升级。

macOS 用户

推荐用 Homebrew：

brew install node@22

或者去 nodejs.org^[1] 下载 LTS 安装包，一路下一步。

Windows 用户

去 nodejs.org^[1] 下载 .msi 安装包，安装时勾选 “Add to PATH”，然后打开 PowerShell 或 CMD，运行上面的 node --version 确认。

Linux 用户

如果你用的是 Ubuntu/Debian，可以用 NodeSource 源：

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

pnpm 是 OpenClaw 推荐的包管理器。 如果你还没装，先跑一句：

npm install -g pnpm

pnpm 相比 npm 和 yarn，安装速度更快、磁盘占用更小。OpenClaw 内部也用 pnpm 管理依赖，所以先装好它，后面能省不少事。

二、一键安装 OpenClaw

Node.js 搞定后，装 OpenClaw 就是一行命令的事。

macOS / Linux

npm install -g openclaw@latest

Windows

在 PowerShell 里运行（建议用管理员模式打开）：

npm install -g openclaw@latest

安装过程大概半分钟到一分钟，取决于网速。装完后验证：

openclaw --version

看到类似 OpenClaw 2026.5.6 的输出，说明安装成功。

小贴士： 如果提示权限错误（EACCES），macOS/Linux 用户可以加 sudo，或者配置 npm 全局目录权限（推荐后者，搜 “npm global without sudo”）。Windows 用户如果遇到权限问题，确保用管理员身份运行 PowerShell。

三、初始配置——QuickStart 模式

装好之后，跑一下配置向导：

openclaw configure

这会启动交互式配置流程，引导你设置几个关键项：

• • Workspace（工作目录）：OpenClaw 存放记忆、技能、配置的地方。建议用默认值 ~/.openclaw，它会把所有东西——记忆文件、技能、配置、日志——都集中放在这个目录下。如果你用的是云服务器，确保这个目录所在分区有足够空间
• • Model（AI 模型）：选择你要用哪个 AI 后端，这步可以先跳过，我们后面单独配置更划算的方案
• • Gateway（网关）：OpenClaw 的服务端口，默认 3000。如果这台机器上 3000 端口已经被占了（比如被 Node.js 其他项目占了），换一个就行
• • Channels（渠道）：接入微信、飞书、Discord 等聊天平台，这步也先跳过，下一篇专门讲

第一次配置不用纠结，跟着走就行。配完后，OpenClaw 会提示你启动 Gateway。

Gateway 是 OpenClaw 的核心服务，负责调度 AI 模型、管理渠道连接、处理记忆和任务——所有功能都依赖它。启动方式：

openclaw gateway start

如果你希望 Gateway 开机自动启动（生产环境推荐）：

openclaw gateway start --daemon

或者用 systemd 方式（Linux 服务器）：

openclaw daemon installopenclaw daemon start

四、接入阿里云 Token Plan 团队版（省钱关键）

OpenClaw 默认支持 OpenAI、Anthropic 等海外模型，但国内用户直接调用要么速度慢，要么成本高。这里推荐阿里云百炼平台的 Token Plan 团队版，性价比极高，适合个人和小团队。

为什么选阿里云 Token Plan？

• • 包量制计费：不用按调用次数逐次算钱，买一个 Token 包，用得越多越划算，比按量付费省得多
• • 模型全家桶：Qwen 全系列都能用，从日常对话的 turbo 到综合最强的 plus，编程专精的 coder，看图分析的多模态模型，一个包全覆盖
• • 团队共享：一个 Plan 多人用，Token 池共享，适合小团队协作
• • 国内直连：服务器在国内，延迟低，不用翻墙

怎么接入

第一步，去阿里云百炼控制台开通 Token Plan 团队版，拿到 API Key。

第二步，在 OpenClaw 里配置模型：

openclaw configure --section model

模型 ID 填你需要的模型，推荐从这几个开始试：

第三步，设置环境变量。OpenClaw 走 OpenAI 兼容协议，阿里云百炼的 API 完全兼容，所以环境变量名虽然是 OPENAI_API_KEY，但实际对接的是阿里云：

export OPENAI_API_KEY="你的阿里云API-KEY"export OPENAI_BASE_URL="https://dashscope.aliyuncs.com/compatible-mode/v1"

把这两行加到 ~/.bashrc 或 ~/.zshrc 里，这样每次开终端都自动生效。

提醒： 如果你用的是云服务器，建议用 systemctl edit 把环境变量写进 Gateway 的 service 文件里，避免环境变量丢失导致 Gateway 找不到 API Key。

五、启动验证——看看能不能跑起来

配置搞定后，来验证一下。有两种方式：

方式一：TUI 终端界面

openclaw tui

这会打开一个终端交互界面，你可以直接在里面跟 AI 对话。界面支持 Markdown 渲染，代码块高亮，体验很不错。发一句”你好”试试，看看有没有回复。

方式二：Web Dashboard

openclaw dashboard

这会在浏览器里打开控制面板，可以看到 Gateway 状态、模型连接情况、渠道状态、运行日志等信息。界面对新手更友好，不需要适应终端操作。

快速自检清单

• • ✅ openclaw --version 能看到版本号
• • ✅ openclaw gateway start 启动后没有报错
• • ✅ openclaw health 返回 healthy
• • ✅ 在 TUI 里发消息能收到回复
• • ✅ Dashboard 能正常打开

如果哪一步卡住了，跑一下：

openclaw doctor

这会自动检查常见问题并给出修复建议，非常实用。

常见问题排查

1. Gateway 启动失败

通常是端口被占或者配置文件有语法错误。先看日志：

openclaw logs

日志里会明确告诉你哪个环节出了问题。

2. 模型返回 401/403 错误

API Key 没配或者配错了。确认环境变量 OPENAI_API_KEY 和 OPENAI_BASE_URL 都设对了，可以用 echo $OPENAI_API_KEY 快速验证。

3. TUI 打不开

确认 Gateway 已经在运行。TUI 是客户端，需要连接到一个活着的 Gateway 才能工作。先跑 openclaw gateway start，再跑 openclaw tui。

4. Windows 上编码问题

如果终端中文显示乱码，在 PowerShell 里跑一句：

chcp 65001

把编码切换到 UTF-8。

六、装好了，然后呢？

现在你有一个跑在本地（或服务器上）的 AI 助手了。但它还只是个”裸机”——没有接入微信、飞书、Telegram，也没有加载各种技能。

下一篇我们会讲渠道接入：怎么把 OpenClaw 和你的微信、飞书、Discord 连起来，让 AI 助手真正”活”在你的日常沟通工具里。

在此之前，你可以先探索几个命令：

openclaw docs          # 搜索在线文档openclaw logs          # 查看运行日志openclaw memory        # 查看/搜索记忆文件openclaw agents list   # 查看当前 agent 状态openclaw configure     # 随时重新配置

有问题随时留言，下期见。

引用链接

[1] nodejs.org: https://nodejs.org/