(小白也能看懂)OpenClaw 保姆级安装教程:15 分钟从安装到跑通

如果你最近在折腾 AI 助手、自动化工作流，或者想把 AI 真正接进自己的聊天软件里，那你大概率已经听过
OpenClaw。

它和普通网页 AI 最大的区别在于：你不是在“用一个现成产品”，而是在搭一个真正属于你自己的 AI 助手系统。

它可以接聊天渠道、接模型、接技能，还能把很多事情串起来自动跑。但问题也很现实：很多人不是不会用，而是第一步安装就被劝退了。

这篇文章直接带你从 0 开始，把 OpenClaw 的安装、引导和模型配置这几步走通。

一、 OpenClaw 是什么？

用一句话讲明白：OpenClaw 是一个自托管的个人 AI 助手网关。

你可以把它理解成一个“中控台”：

一边连接：Telegram、Discord、Slack、WhatsApp 等聊天渠道。
一边连接：OpenAI、Anthropic，或者你自己的自定义模型接口。
中间处理：把这些能力统一交给你的 AI 助手去调用。

控制权在你自己手里：配置在本地，数据在本地，工作流也在本地。

这也是为什么越来越多人开始玩 OpenClaw。

它适合什么人？

如果你不满足于“在网页里跟 AI 聊两句”，而是想真正拥有一个能长期使用、能自己掌控、能接入工作流的 AI 助手系统，那 OpenClaw 就很值得折腾。

二、安装前需要准备什么？

1. Node.js 版本

要求 Node.js 22 及以上。在终端执行：

node --version

2. 操作系统

推荐：macOS、Linux。
Windows 用户：建议用 WSL2。

3. 模型提供商密钥

你至少需要准备以下其中一种：

Anthropic API Key
OpenAI API Key
自定义兼容接口的 API Key

如果你后面准备接第三方兼容接口，那还会用到：

Base URL
API Key
模型 ID

4. 预计耗时

如果环境没问题，整个流程大概需要：

10 到 15 分钟

第一次安装的话，可能会稍微慢一点，但整体不算复杂。

三、正式开始安装

3.1 macOS 用户先确认 Homebrew

如果你是 macOS，先检查 Homebrew 是否已经安装。

在终端执行：

brew --version

如果提示没有这个命令，那就先安装 Homebrew：

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

如果你不是 Mac，或者已经装过 Homebrew，这一步直接跳过。

3.2 安装 OpenClaw

OpenClaw 官方推荐的安装方式很直接，执行下面这条命令即可：

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

这条安装脚本会帮你自动处理很多事，比如：

检查环境
检测 Node.js
初始化 OpenClaw
进入首次引导流程

对于新手来说，这是最省心的方式。

四、安装过程中怎么选？

很多人第一次卡住，不是因为不会输命令，而是看到一堆确认界面就开始慌了。

其实大部分选项，按推荐值往下走就行。

安装过程中通常会遇到这些提示：

是否继续安装：选 Yes
是否创建网关和生成 token：选 Yes
是否给 ~/.openclaw 设置 700 权限：选 Yes
是否创建 Session 存储目录：选 Yes
是否启用 bash shell 补全：选 Yes
是否创建网关服务：选 Yes

如果中途发现界面不对，或者你觉得自己选乱了，也不用慌。

★
小技巧：如果选乱了，按 Ctrl + C 退出，重新跑一遍安装脚本就行。
直接按：
Ctrl + C
退出，然后重新执行：
curl -fsSL https://openclaw.ai/install.sh | bash
重来一遍就行。

五、看到这个地址，说明已经装上了

安装成功后，终端会出现：

`http://127.0.0.1:18789`

看到这个地址，说明 OpenClaw 本体已经安装完成。

但这里要注意一件事：

程序装好了，不代表模型已经能正常调用。

也就是说，安装只是第一步。接下来你还需要继续完成模型接入配置。

这也是很多人第一次容易误解的地方。

六、继续执行引导配置

在终端执行关键命令：

openclaw onboard

建议按以下思路选择：

风险提示：Yes
配置模式：QuickStart (最适合新手)
使用已有配置：Use existing values
模型提供商：如果是第三方接口，选 Custom Provider

七、自定义模型提供商怎么填？

进入 Custom Provider 后：

Base URL：填写模型商地址。
Endpoint Compatibility：通常选 OpenAI-compatible。
Model ID：填写模型名称（如 gpt-4o）。
Endpoint ID：重中之重！ 请记下系统自动生成的 ID（如 custom-claude-chiddns-com），后面调参数要用。

八、渠道、技能先别急着配

很多人第一次装的时候，习惯一口气把所有功能全配上。

结果越配越乱，最后连主流程都没跑通。

更稳的方式是：

先把 OpenClaw 主体装好，再把模型接通，最后再慢慢加聊天渠道、技能和 hooks。

所以在初始阶段，建议你这样选：

channel：Skip for now
skills：No
hooks：Skip for now

这样最稳。

九、完成引导后重启

当引导流程最后提示是否重启网关时，选择：

Restart

如果后面还有一些额外提醒，可以先选：

Do this later

到这里，OpenClaw 的基础安装和模型接入，算是完成了大半。

但先别急着高兴，很多人真正卡住的地方，恰恰在下一步。

十、核心避坑：手动修改模型参数

这是最典型的坑点。

如果你使用的是 Custom Provider， OpenClaw 默认给模型配置的上下文窗口和最大 Tokens，往往偏小。

这会导致几个常见问题：

模型调用失败
输出内容不完整
请求直接报错
表面看配置没问题，实际上就是跑不起来

所以这里还有最后一个关键步骤：

手动调大 contextWindow 和 maxTokens。

十一、手动修改模型参数

这一段很关键，建议你直接照着做。

注意：

下面命令里的 custom-claude-chiddns-com 只是示例，你需要替换成你自己的 Endpoint ID。

先设置上下文窗口：

openclaw config set 'models.providers.custom-claude-chiddns-com.models[0].contextWindow' 400000

再设置最大输出 Tokens：

openclaw config set 'models.providers.custom-claude-chiddns-com.models[0].maxTokens' 128000

最后检查配置是否写入成功：

openclaw config get 'models.providers.custom-claude-chiddns-com.models[0]'

这三条命令分别对应：

设置上下文窗口
设置最大输出 Tokens
查看当前模型配置

如果这三步都执行成功，那你的模型配置基本就补齐了。

很多人不是 OpenClaw 装不上，而是装完以后没调这两个参数，导致后面一直调用失败。

十二、怎么验证自己到底装没装好

别光看“好像没报错”，最好自己检查一遍。

1）查看网关状态

openclaw gateway status

这个命令可以确认网关是否正在运行。

2）做一次诊断检查

openclaw doctor

这个命令很有用，它会帮你检查配置、权限、连接等问题。如果有异常，通常这里能看出来。

3）查看整体状态

openclaw status

这个命令适合做总览。

如果这几项都正常，基本说明环境没大问题。

十三、控制界面怎么打开？

根据你的环境不同，有两种常见方式。

1）终端环境

如果你是在服务器、远程终端，或者你本来就更习惯命令行，可以执行：

openclaw tui

这样就可以直接在终端里管理 OpenClaw。

2）桌面环境

如果你有图形界面，想打开 Web 控制台，可以执行：

openclaw dashboard

或者直接在浏览器访问：

http://127.0.0.1:18789/

如果打不开，优先检查网关是否正常运行。

十四、想排错，那就前台运行

如果你想直接看实时日志，最简单的方法就是前台启动网关：

openclaw gateway --port 18789

这样终端里会直接输出运行日志。一旦出问题，排查起来会方便很多。

十五、几个你迟早会用到的重要目录

安装完成后，OpenClaw 的常用文件基本都在 ~/.openclaw 下面。

重点记住这几个：

~/.openclaw/openclaw.json主配置文件，格式是 JSON5

~/.openclaw/workspaceAI 助手的工作空间

~/.openclaw/.env环境变量文件，通常存放 API Key 等敏感信息

以后无论你是改配置、做备份，还是排查问题，这几个路径都会经常碰到。

十六、基础配置怎么查看和修改？

平时最常用的两个命令是：

打开配置向导：

openclaw configure

查看当前配置：

openclaw config get

如果你只是想知道最基础的配置大概长什么样，可以参考这个最小示例：

{"agents": {"defaults": {"workspace": "~/.openclaw/workspace"        }    }}

十七、常用命令速查

后面你大概率会经常用到这些命令：

openclaw onboard：运行引导向导
openclaw gateway：启动网关
openclaw gateway status：查看网关运行状态
openclaw dashboard：打开 Web 控制台
openclaw doctor：执行诊断检查
openclaw status：查看整体状态
openclaw logs --follow：实时查看日志
openclaw channels login：登录聊天渠道
openclaw configure：修改配置
openclaw config get：查看当前配置
openclaw agents add：添加额外代理实例

十八、几个常见问题，提前说一下

Q1：启动时报 EADDRINUSE 怎么办？

说明端口被占用了。

可能是你已经开了一个网关实例，也可能是其他程序占用了默认端口。

可以换个端口启动：

openclaw gateway --port 18790

Q2：控制台打不开怎么办？

优先检查下面几项：

网关有没有正常运行
是否还没完成设备认证
是否修改过绑定地址或认证配置

你可以先执行：

openclaw gateway status

如果系统提示 device identity required，一般说明还需要继续完成认证流程。

Q3：升级后功能异常怎么办？

有时候升级之后，默认配置项会发生变化，导致旧配置和新版本之间出现兼容问题。

这时候可以先执行：

openclaw config getopenclaw gateway install --force

重新安装相关元数据，再看看问题是否解决。

Q4：OpenClaw 怎么更新？

最简单的方法，还是重新执行官方安装脚本：

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

十九、最后总结一下

如果你是第一次接触 OpenClaw，其实真正需要记住的就三步：

第一步：用官方脚本安装 OpenClaw

第二步：执行 openclaw onboard 完成模型配置

第三步：如果你用的是自定义提供商，一定记得手动调大 contextWindow 和 maxTokens

很多人不是不会装，而是装完以后卡在模型参数这一步。

只要这里处理好了，后面无论是接聊天渠道、配置技能，还是做自动化流程，都会顺很多。

如果这篇文章对你有帮助，建议先收藏。后面我也可以继续整理：

OpenClaw 如何接入聊天渠道
OpenClaw 如何配置技能
OpenClaw 常见报错怎么排查
OpenClaw 如何接入自定义中转模型

二十、参考资料

OpenClaw 官方文档
https://docs.openclaw.ai
OpenClaw GitHub 仓库
https://github.com/openclaw/openclaw
快速开始指南
https://docs.openclaw.ai/start/quickstart
引导向导说明
https://docs.openclaw.ai/start/wizard
配置文档
https://docs.openclaw.ai/gateway/configuration
故障排查
https://docs.openclaw.ai/gateway/troubleshooting

#AI #openclaw

如果你最近在折腾 AI 助手、自动化工作流，或者想把 AI 真正接进自己的聊天软件里，那你大概率已经听过 OpenClaw。