OpenClaw 安装指南：从零开始搭建你的本地 AI 助手

type

Post

status

Published

date

Mar 10, 2026

slug

openclaw-install-guide

summary

一篇面向新手的 OpenClaw 安装入门指南，包含安装前准备、初始化、登录授权、常见配置与排错建议。

一、OpenClaw 适合什么人

如果你只是偶尔和模型聊几句，网页聊天工具可能已经够用了。但如果你希望助手能持续记住工作区、接入消息平台、读写本地文件、执行自动化任务，那 OpenClaw 会更合适。

想把 AI 当成长期协作助手，而不是一次性聊天工具的人

希望把消息、文件、技能、定时任务串起来的人

愿意在自己的电脑上维护一个可控、本地优先的助手环境的人

二、安装前要准备什么

正式安装前，先准备好几个基础条件。这样后面会顺很多。

一台可正常联网的电脑，macOS 和 Linux 都比较合适

Node.js 22 或更高版本

一个可用的模型登录方式；如果支持网页授权，可以不手填 API Key

预留一个工作区目录，用来放配置、技能、记忆和项目文件

如果你以后还想接 Telegram、企业微信、Notion 这类外部服务，也可以先不急着一次性全接好，先把 OpenClaw 主体跑起来再说。

三、安装 OpenClaw

OpenClaw 常见的安装方式是通过 npm 或 pnpm。先确认 Node.js 已安装，再执行下面的命令：

安装完成后，建议先检查一下命令是否生效：

如果这里提示命令找不到，通常是全局安装路径还没有加入 PATH。这类问题先别急着怀疑 OpenClaw 本身，十有八九是 Node 的全局命令路径没配好。

四、第一次初始化

第一次使用时，最省事的方式就是直接跑初始化引导：

引导过程中，通常会让你确认这些内容：

默认使用哪个模型

是否通过网页登录授权

是否启用一些基础功能

如果你不想自己维护 API Key，而是更希望像网页登录那样完成授权，那么按提示走 OAuth 就行。这种方式一般更省心，也更适合个人使用。

五、安装完成后先做什么

很多人装完就停在“命令能跑”这一步，其实真正重要的是：确认它能正常工作。建议你装好以后，立刻做这几步检查。

如果你启用了网关，也顺手看一下：

这几条命令能帮你快速判断：当前有没有正常运行、有没有更新、网关是不是活着。

六、怎么开始真正用起来

OpenClaw 最有价值的地方，不是“能安装”，而是“能进入你的日常流程”。比较推荐的入门方式是从最小可用开始。

先让它处理简单任务，比如查天气、整理文件、生成文档

把你常用的工作内容放进 workspace

需要时再接入 Notion、Telegram、企业微信等外部入口

把重复性任务逐步改造成定时任务或固定工作流

不要一上来就想把所有能力一次性配满。真正好用的助手，往往都是边用边长出来的。

七、常见问题

1）命令找不到怎么办？

优先检查 Node.js 是否正确安装、npm/pnpm 全局路径是否进入 PATH。

2）模型为什么不可用？

先看登录状态，再看默认模型配置，最后看网络连通性。

3）消息平台为什么不工作？

一般优先检查 token、allowlist、配对状态，以及对应插件是否启用。

4）安全审计出现 warning 要不要紧？

多数 warning 不是马上会出事故的高危项，但最好尽早收紧，比如插件 allowlist、插件版本固定、防火墙状态、外网暴露方式。

八、装好之后的建议

先跑一次安全审计：openclaw security audit --deep

再确认更新状态：openclaw update status

如果是个人电脑，建议打开系统防火墙并保留磁盘加密

接第三方服务时，尽量用最小权限原则

结语

OpenClaw 适合那种“不是只想聊几句，而是真想把助手养起来”的使用方式。安装本身不难，真正拉开体验差距的，是你是否愿意把它接入自己的工作区、笔记系统和日常流程。

如果你刚开始接触，最好的节奏不是追求一步到位，而是先让它稳定跑起来，再一点点把你自己的习惯和需求塞进去。等你用顺手之后，它就不只是一个模型入口，而会更像一个真正的个人助手。