一、工具简介
openclaw 是一款开源个人 ai 智能体 (personal ai agent)，核心优势为本地部署+系统级执行+全渠道交互，可通过聊天工具 (telegram/whatsapp 等) 下达指令，自动完成文件整理、代码部署、日程同步等任务，所有数据本地存储，隐私零泄露。截至 2026 年 1 月，github 星标突破 4 万+，支持 windows/mac/linux/云服务器多平台。
二、前置要求(硬件+软件)
1. 硬件配置
| 配置项 | 最低要求 | 推荐配置 | 说明 |
|---|---|---|---|
| CPU | 4核64位处理器 | 6核及以上 | 支持 Intel i5/AMD Ryzen 5及更高 |
| 内存 | 8GB | 16GB | 本地运行大模型需 16GB+,仅基础调度 8GB 可满足 |
| 存储 | 10GB 可用空间 | 20GB+ | 存储依赖、模型文件及操作日志 |
| 网络 | 稳定互联网连接 | 100Mbps+ | 下载依赖、调用 AI 模型 API (国内需配置代理) |
2. 软件与权限准备
| 类别 | 必备组件 | 版本要求 | 获取路径 |
|---|---|---|---|
| 运行环境 | Node.js | ≥22.0.0 | Node.js 官网 |
| 版本管理 | NVM (可选) | 任意稳定版 | NVM GitHub |
| 部署工具 | Docker (推荐) | ≥20.10.0 | Docker 官网 |
| 源码工具 | Git | 任意稳定版 | Git 官网 |
| 系统要求 | Windows | 10 2004+/11 | 需启用 WSL2+Linux 子系统 (如 Ubuntu 22.04) |
| 系统要求 | Mac | macOS 12+ (Intel/Apple Silicon) | 原生支持,无需额外配置 |
| 系统要求 | Linux | Debian/Ubuntu 20.04+ | 兼容性最佳,推荐优先使用 |
| 权限要求 | 管理员权限 | Windows 需管理员 PowerShell, Mac/Linux 需 sudo 权限 |
3. 关键凭证 (必选其一)
- AI 模型 API Key: 支持 Claude/GPT-4 (需科学上网)、智谱 GLM-4.5、阿里云百炼、MiniMax 等国产模型 (国内可直接访问)
- 聊天平台 Token: Telegram Bot Token (新手推荐)、WhatsApp/ Discord/ Slack Token (进阶用户)
三、全网权威下载路径汇总
官方核心路径
| 资源类型 | 路径 | 说明 |
|---|---|---|
| 源码仓库 | GitHub | 官方开源仓库,支持克隆或下载压缩包 |
| 一键安装脚本 | Mac/Linux: curl -fsSL https://clawd.bot/install.sh
|
bash |
| 一键安装脚本 | Windows (PowerShell): iwr -useb https://clawd.bot/install.ps1
|
iex |
| 插件市场 | Clawdhub | 官方技能插件库 (文件处理、邮件管理等) |
| 官方文档 | GitHub Docs | 配置细则、API 对接指南 |
四、安装步骤 (三种主流方式)
方式一: Docker 部署 (跨系统通用,推荐新手)
1. 环境准备
- 安装 Docker 并启动 (验证: 终端输入
docker --version显示版本) - Windows 用户需先启用 WSL2: 控制面板→程序→启用或关闭 Windows 功能→勾选“适用于 Linux 的 Windows 子系统”和“虚拟机平台”，安装 Ubuntu 22.04 LTS
2. 拉取源码与配置
# 1. 克隆源码 (失败则直接下载压缩包解压) git clone https://github.com/clawdbot/clawdbot.git cd clawdbot # 2. 复制配置文件并修改 cp .env.example .env vim .env # 或用记事本打开 .env 文件
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 免费无限量使用 DeepSeek R1 模型☜☜☜
必改配置项:
-
CLAWS_BOT_NAME: 自定义 AI 名称 (如“MyOpenClaw”) -
CLAWS_SERVER_PORT: 本地端口 (默认 8080, 冲突可改 8081) -
CLAWS_DEFAULT_MODEL: AI 模型 (本地填“llama3:8b”，云端填 API Key) -
CLAWS_DATA_DIR: 数据存储路径 (建议改为绝对路径, 如 “/Users/xxx/clawdbot/data”)
3. 启动容器
# 构建镜像并后台运行 (首次需 5-10 分钟下载依赖) docker-compose up -d --build # 验证启动: 查看容器状态 (显示“up”即为成功) docker ps # 查看日志 (排查报错) docker logs clawdbot
4. 验证部署
打开浏览器访问 http://localhost:8080 (端口对应配置文件)，出现 OpenClaw 管理界面则部署成功。
