1. 项目概述
OpenClaw作为一款开源的本地化智能助理工具,近期在技术社区获得了不少关注。不同于云端AI服务,它最大的特点是完全运行在本地设备上,不需要联网就能使用。这对于注重隐私保护的用户来说是个不错的选择——你的所有对话记录、个人信息都不会上传到任何服务器。
我花了三天时间在自己的Linux工作站上折腾这个工具,期间踩了不少坑。从依赖缺失到中文乱码,从模型加载失败到插件配置错误,基本把所有能遇到的问题都经历了一遍。现在把完整的安装和汉化过程整理出来,希望能帮后来者节省时间。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 环境准备与基础安装
2.1 硬件与系统要求
OpenClaw对硬件有一定要求,特别是如果你打算使用较大的语言模型。实测下来:
- CPU:至少4核,推荐8核及以上
- 内存:16GB起步,32GB更佳
- 存储:需要20GB以上空间(模型文件很大)
- GPU:非必须但强烈推荐(至少4GB显存)
支持的操作系统包括:
- Ubuntu 20.04/22.04(最稳定)
- Debian 11+
- Arch Linux
- Windows WSL2(性能较差)
注意:Mac M系列芯片用户需要自行编译部分依赖,本文以Linux环境为例
2.2 依赖安装
首先安装基础依赖包:
bash复制sudo apt update
sudo apt install -y python3-pip python3-venv git cmake build-essential
创建虚拟环境(强烈建议):
bash复制python3 -m venv openclaw_env
source openclaw_env/bin/activate
3. 核心安装步骤
3.1 获取源代码
官方仓库有两个分支需要注意:
- main分支:稳定版
- dev分支:开发版(可能有新功能但不够稳定)
建议克隆稳定版:
bash复制git clone -b main https://github.com/openclaw/OpenClaw.git
cd OpenClaw
3.2 安装Python依赖
项目根目录下的requirements.txt可能不完整,我整理了一个更全面的版本:
bash复制
