做自媒体久了,总需要高效的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. 验证安装+初始化配置
安装完成后,关闭终端重新打开,先验证安装:
显示版本号即成功。接着执行初始化命令:
选择指引与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,访问
登录后台。
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系统?安