Windows+Mac+Linux全覆盖!OpenClaw一站式安装配置教程,小白也能一次看懂

做自媒体久了，总需要高效的AI工具辅助内容创作、自动化运营，而OpenClaw作为全能型AI助手工具，能实现AI模型对接、多渠道接入、插件扩展等核心需求。但很多新手在Windows、Mac、Linux三大系统上安装配置时，总踩坑，要么步骤复杂，要么参数配置出错。

今天就给大家出一篇三项合一的保姆级教程，不管你用的是Windows PowerShell、macOS终端，还是Linux服务器，跟着这篇教程走，一步到位完成OpenClaw安装、Token配置、插件安装，全程复制粘贴即可，小白也能轻松上手！

一、核心前提：准备好你的AI模型Token

在开始安装前，先准备好你的AI模型API Key（以OpenAI为例，前缀为sk-xxxxxxx），以及你要使用的模型名（如gpt-3.5-turbo、gpt-4o）。如果是用自定义模型提供商（如阿里云百炼、字节火山引擎），还需提前准备好对应的BaseURL。

这一步是后续配置的核心，少了它，后续步骤都无法完成，提前准备好能节省大量时间！

二、Windows系统：PowerShell管理员一键安装

Windows用户打开PowerShell（管理员模式），按以下步骤依次执行，全程无需手动操作复杂参数。

1. 前置权限配置（首次安装必做）

执行以下命令，允许执行本地脚本，输入 Y 确认即可：

powershell    Set-ExecutionPolicy RemoteSigned -Scope CurrentUser

2. 一键安装OpenClaw

复制粘贴下方命令，等待安装完成：

powershell    iwr -useb https://openclaw.ai/install.ps1 | iex

3. 验证安装是否成功

安装完成后，关闭当前PowerShell，重新打开管理员模式，执行：

powershell    openclaw --version

若终端显示版本号，说明安装成功；若提示“不是内部或外部命令”，重启电脑后再试一次。

4. 初始化配置（onboard）

执行初始化命令，按提示选择对应参数，全程选默认或手动输入准备好的信息：

powershell    openclaw onboard

选择指引：

1. 安全提示：输入 Yes 

2. 模式：选择 QuickStart （快速启动模式，适合小白）

3. 模型提供商：选择 Custom Provider （自定义，适配多数模型）

4. BaseURL：输入

 https://api.openai.com/v1 

（OpenAI默认地址，自定义模型填对应地址）

5. API Key：粘贴你提前准备的AI模型密钥

6. 模型ID：输入 gpt-3.5-turbo （或你常用的模型名）

7. 渠道配置：输入 Skip for now （后续可单独配置Telegram/Discord）

8. 最后选择 Restart ，完成初始化

5. 核心Token配置

（1）配置AI模型API Token

powershell    openclaw models auth paste-token --provider openai

粘贴你的API Key，回车即可完成配置。

（2）生成Dashboard登录Token

powershell    openclaw token generate --admin

复制生成的Token，后续登录后台面板使用。

6. 安装常用插件（小白必装6件套）

powershell    clawhub install memoryclawhub install web-searchclawhub install file-systemclawhub install bashclawhub install agent-browserclawhub install ontology

7. 启动与后台运行

powershell    # 前台启动（测试用）openclaw gateway start# 后台运行（关闭终端不退出，推荐）nohup openclaw gateway start > $env:USERPROFILE\.openclaw\logs\gateway.log 2>&1 &

三、Mac系统：终端一站式配置，全程复制粘贴

Mac用户打开终端（Launchpad→其他→终端），步骤更简洁，无需复杂权限配置。

1. 一键安装OpenClaw

复制执行下方命令，等待安装完成：

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

2. 验证安装+初始化配置

安装完成后，关闭终端重新打开，先验证安装：

bash    openclaw --version

显示版本号即成功。接着执行初始化命令：

bash    openclaw onboard

选择指引与Windows一致，直接按提示输入 Yes 、 QuickStart ，再填入BaseURL、API Key、模型名即可。

3. Token配置（Mac专属）

（1）快速配置AI模型Token

bash    openclaw models auth paste-token --provider openai

粘贴API Key，一键完成。

（2）手动修改配置文件（可选）

若需手动调整参数，执行：

bash    open ~/.openclaw/openclaw.json

找到 "apiKey": "sk-xxxxxxx" 字段，修改后保存即可（Mac自带文本编辑，无需额外工具）。

（3）生成Dashboard Token

bash    openclaw token generate --admin

复制Token，访问 

http://localhost:21865

 登录后台。

4. 安装常用插件+启动服务

bash    # 安装必装插件clawhub install memoryclawhub install web-searchclawhub install file-systemclawhub install bashclawhub install agent-browserclawhub install scheduler# 启动服务openclaw gateway start

# 后台运行（推荐）nohup openclaw gateway start > ~/.openclaw/gateway.log 2>&1 &

四、Linux服务器：适配Ubuntu/Debian/CentOS，稳定运行

Linux用户多为服务器部署，重点关注后台运行和防火墙配置，以下是通用版教程，适配主流发行版。

1. 一键安装+环境加载

打开终端，执行安装命令：

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

加载环境变量（适配bash/zsh终端）：

bash    # bash用户source ~/.bashrc# zsh用户source ~/.zshrc

2. 验证安装+初始化

bash    openclaw --version# 初始化openclaw onboard

选择指引与前两者一致，快速完成基础配置。

3. 核心配置+插件安装

（1）配置AI模型Token

bash    openclaw models auth paste-token --provider openai

粘贴API Key，完成配置。

（2）生成Dashboard Token（服务器专属）

bash    openclaw token generate --admin

复制Token，后续通过 http://服务器IP:21865登录。

（3）开放防火墙端口（关键！）

若外部无法访问后台面板，执行对应命令：

bash    # Ubuntu/Debianufw allow 21865/tcp# CentOS/RHELfirewall-cmd --add-port=21865/tcp --permanentfirewall-cmd --reload（4）安装常用插件bash    clawhub install memoryclawhub install web-searchclawhub install file-systemclawhub install bashclawhub install agent-browserclawhub install scheduler

4. 服务启动与管理（服务器核心）

bash    # 前台启动（测试）openclaw gateway start# 后台守护运行（推荐，关闭终端不退出）nohup openclaw gateway start > ~/.openclaw/gateway.log 2>&1 &# 常用管理命令openclaw gateway restart  # 重启openclaw gateway stop     # 停止

五、三项合一：通用插件管理+常见问题排查

1. 通用插件管理命令（三大系统通用）

无论你用哪个系统，插件管理命令完全一致，直接复制使用：

bash    clawhub list --installed  # 查看已安装插件clawhub enable 插件名     # 启用插件（如clawhub enable web-search）clawhub disable 插件名    # 禁用插件clawhub uninstall 插件名  # 卸载插件

2. 高频问题排查（新手必看）

1. Token报错：检查API Key是否正确（必须以sk-开头）、是否过期、是否有模型访问权限；自定义模型需确认BaseURL是否可访问。

2. 启动失败：查看日志文件

（Windows： $env:USERPROFILE\.openclaw\logs\gateway.log ；Mac/Linux： ~/.openclaw/gateway.log ）

根据日志提示修正。

3. Dashboard无法访问：Windows/Mac检查本地防火墙是否拦截21865端口；Linux服务器确认防火墙已开放端口，且服务器安全组放行21865。

4. 插件安装失败：执行 clawhub update 更新插件仓库，再重新安装。

六、写在最后

OpenClaw的核心优势，在于跨平台兼容+插件生态丰富，不管是日常写文案、做自媒体自动化运营，还是对接多AI模型、接入Telegram/Discord等渠道，都能一站式满足。

这篇Windows+Mac+Linux三项合一教程，把三大系统的核心步骤整合到一起，就是为了让大家少走弯路，快速完成部署。

后续我还会给大家出OpenClaw进阶教程，比如Telegram/Discord渠道配置、自定义插件开发、AI模型多供应商对接等内容，帮你把OpenClaw的功能发挥到极致，彻底解放双手！

你现在用的是Windows、Mac还是Linux系统？安