OpenClaw是一款开源的AI智能体执行引擎,能直接执行文件管理、日程安排、自动化工作流等任务,区别于传统仅提供建议的AI聊天工具。以下从安装、基础操作、进阶应用全流程详解,覆盖Windows与macOS系统。

一、安装前准备
系统与硬件要求
- Windows:Windows 10/11 64位,推荐WSL2环境;内存≥1GB(建议2GB+)
- macOS:macOS 12.0+(Monterey及以上),Intel/M系列芯片通用;内存≥8GB(建议16GB+)
- 通用依赖:Node.js 22.0+(推荐24 LTS) ,AI模型API Key(OpenAI/Claude等)
二、Windows系统安装(2种方式)
方式1:官方一键脚本(新手首选)
1. 以管理员身份打开PowerShell(Win+X→终端(管理员))
2. (可选)解除执行策略限制:
plaintext
Set-ExecutionPolicy Bypass -Scope Process -Force
3. 执行安装命令(二选一):
plaintext
# 官方原版
iwr -useb https://openclaw.ai/install.ps1 | iex
# 国内镜像(网络慢时用)
iwr -useb https://clawd.org.cn/install.ps1 | iex
4. 等待脚本自动安装Node.js与OpenClaw,按提示完成初始化
方式2:npm手动安装(适合开发者)
1. 安装Node.js(官网下载LTS版,勾选Add to PATH)
2. 管理员PowerShell执行:
plaintext
npm install -g openclaw@latest
3. 验证安装: openclaw --version ,输出版本号即成功

三、macOS系统安装(2种方式)
方式1:官方一键脚本(推荐)
1. 打开终端(Command+空格→搜索Terminal)
2. 执行安装命令(二选一):
plaintext
# 官方原版
curl -fsSL https://openclaw.ai/install.sh | bash
# 国内加速版
curl -fsSL https://open-claw.org.cn/install-cn.sh | bash
3. 输入Mac开机密码(输入不显示),等待安装完成
4. 加载环境变量:
plaintext
# Zsh(默认)
source ~/.zshrc
# Bash(老系统)
source ~/.bash_profile
5. 验证: openclaw --version
方式2:Homebrew+npm安装
1. 安装Homebrew(若未安装):
plaintext
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/homebrew/install/head/install.sh)"
2. 安装Node.js: brew install node@22
3. 全局安装OpenClaw:
plaintext
sudo npm install -g openclaw@latest
macOS专属权限配置(必做)
1. 打开系统设置→隐私与安全性
2. 开启以下权限:- 辅助功能(鼠标键盘模拟)
- 屏幕录制(视觉识别)
- 文件与文件夹→完全磁盘访问权限
3. 重启终端/OpenClaw服务使权限生效
四、初始化与启动(全系统通用)
1. 运行初始化向导:
plaintext
openclaw onboard --install-daemon
2. 按提示配置:- 选择AI模型提供商(OpenAI/Claude/Ollama)
- 粘贴API Key
- 选择消息渠道(Telegram/Discord等,可跳过)
- 安装守护进程(开机自启)
3. 启动服务:
plaintext
openclaw start
4. 验证状态: openclaw gateway status ,显示 running 即成功
5. 打开Web控制面板: openclaw dashboard (自动打开浏览器)
五、基础操作步骤
1. 聊天与指令执行
- 打开控制面板聊天框,直接输入自然语言指令 - 例: 整理桌面文件 、 创建明天14点的会议日程
- 斜杠命令(快捷操作):- /exit :退出会话
- /status :查看服务状态
- /skills :查看已安装技能
2. 服务管理命令
plaintext
openclaw start # 启动
openclaw stop # 停止
openclaw restart # 重启
openclaw status # 查看状态
3. 技能管理(扩展能力)
- 查看内置技能: openclaw skills list
- 安装新技能(从ClawHub):
plaintext
openclaw skills install 技能名
- 卸载技能: openclaw skills uninstall 技能名
4. 文件与记忆配置
- 核心配置目录: ~/openclaw-workspace - SOUL.md :设置AI性格与行为准则
- IDENTITY.md :设置AI名称与身份
- MEMORY.md :长期记忆存储
- 手动修改后重启服务生效
六、进阶应用(精通)
1. 自动化任务- 配置Cron定时任务: openclaw cron add "0 9 * * *" "发送每日工作汇报"
- 工作流自动化:连接多工具完成复杂任务(如:下载文件→解析数据→生成报表→发送邮件)
2. 多平台接入- 接入飞书/企微/钉钉:在 auth-profiles.json 配置对应平台凭证
- 移动设备使用:配置Telegram/Discord Bot,随时随地发指令
3. 本地模型部署(Ollama)- 安装Ollama: curl -fsSL https://ollama.com/install.sh | sh
- 下载本地模型: ollama pull llama3
- OpenClaw配置本地模型: openclaw config set model ollama/llama3
七、常见问题
- Windows安装失败:关闭杀毒软件,确保PowerShell管理员权限,改用WSL2环境
- macOS权限不足:按前文步骤完整配置隐私与安全性权限
- AI无响应:检查API Key有效性,执行 openclaw restart 重启服务
- 命令找不到:确认Node.js全局路径已加入系统PATH

夜雨聆风