OpenClaw 是最近 AI 圈讨论度极高的开源项目,没有之一。它让你在自己的电脑上运行一个永不下线的 AI 助手,能收发消息、管理文件、执行命令,甚至替你刷邮件、管日历、写公众号等等。本文带你从零完成本地安装。
认识 OpenClaw:它不只是一个聊天机器人
OpenClaw(前身是 Clawdbot / Moltbot)是一个自托管的 AI Agent。
和 ChatGPT 这类工具不同,它不只是"回答问题"——它会真的去执行操作:打开终端跑命令、读写文件、调用 API、向你的 WhatsApp / Telegram / 飞书主动发消息。
它的架构分为两层:
- • Brain(大脑):负责推理、调用 LLM API、编排任务
- • Hands(手):执行层,负责运行 shell 命令、操作文件系统、管理浏览器任务
支持的模型完全灵活——Claude、GPT-4o、Gemini、KIMI或者本地的 Ollama 模型都可以接入。
⚠️ 安装前必读:安全提示
OpenClaw 是一个高权限工具,能读写文件、执行系统命令,务必注意:
-
- 不要装在你的主力个人电脑上,尤其是存有工作数据、个人隐私的机器
-
- 推荐装在虚拟机、VPS 、闲置设备或专用设备上面。
环境要求
| 项目 | 要求 |
|---|---|
| 操作系统 | macOS / Linux / Windows(推荐 WSL2) |
| Node.js | 22+(关键,低版本会报错) |
| 内存 | 建议 8GB+,最低 4GB |
| CPU | 建议双核以上 |
此外,确保你的电脑可以科学上网
一键安装脚本(最快,推荐新手)
macOS / Linux
打开终端,粘贴以下命令:
curl -fsSL https://openclaw.ai/install.sh | bash
脚本会自动检测你的操作系统、验证 Node.js 版本,并启动引导向导。
加上 --install-daemon 参数可以将 OpenClaw 注册为后台服务(Linux 用 systemd,macOS 用 launchd),这样重启后它也会自动运行:
curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-daemon
Windows
以管理员身份打开 PowerShell,先设置执行策略:
Set-ExecutionPolicy RemoteSigned
然后粘贴官方安装命令(一行)并等待完成。
安装后:引导配置(onboarding)
安装完成后,运行引导向导进行初始化配置——这一步不能跳过:
openclaw onboard
向导会引导你完成以下配置:
-
- 选择 LLM:输入 Claude / GPT / Gemini/KIMI 的 API Key,或配置 Ollama 本地模型地址,如果没有国外的账号,建议你使用国内大模型。
-
- 选择消息平台:Telegram、WhatsApp、Discord、Slack 等,按提示完成 Bot 绑定
基础配置文件(config.yaml)
配置文件位于 ~/.openclaw/config.yaml,以下是关键字段:
server: host: "127.0.0.1" # ⚠️ 务必绑定到 localhost,不要用 0.0.0.0 port: 18789ai: model: "claude-sonnet-4-6" # 或 gpt-4o、llama3 等 max_tokens: 2048 temperature: 0.7exec: ask: "on" # 命令执行前需要用户确认platforms: telegram: enabled: true token: "YOUR_BOT_TOKEN" discord: enabled: false
修改后重启网关生效:
openclaw gateway restart
验证安装是否成功
## 检查版本openclaw --version# 健康检查(会自动检测配置问题)openclaw doctor# 查看网关状态openclaw gateway status# 打开浏览器 Dashboardopenclaw dashboar…