目录
OpenClaw 是一个 本地 AI Agent 框架，可以调用 LLM、自动执行任务、访问文件等。它可以在 Linux 上直接运行。(OpenClaw)
一、系统要求
建议配置：
Ubuntu 24.04 / 22.04
4GB+ RAM
Node.js ≥ 22
Git
curl
OpenClaw 官方 Linux 支持 Ubuntu 20.04+。(OpenClaw)
二、更新系统
先更新 Ubuntu：
代码块
Shell
自动换行
复制代码
sudo apt update
sudo apt upgrade -y
复制成功
安装基础工具：
代码块
Shell
自动换行
复制代码
sudo apt install -y curl git build-essential
复制成功
三、安装 Node.js 22
OpenClaw要求 Node ≥22。(OpenClaw)
推荐用 NodeSource：
代码块
Shell
自动换行
复制代码
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt install -y nodejs
复制成功
验证：
代码块
Shell
自动换行
复制代码
node -v
npm -v
复制成功
应该看到：
代码块
PlainText
自动换行
复制代码
v22.x.x
复制成功
四、安装 OpenClaw（推荐一键脚本）
官方推荐一条命令安装。(OpenClaw)
代码块
Shell
自动换行
复制代码
curl -fsSL https://openclaw.ai/install.sh | bash
复制成功
这个脚本会自动：
检查 Node 版本
安装 OpenClaw CLI
下载依赖
创建配置目录
安装目录默认：
代码块
PlainText
自动换行
复制代码
~/.openclaw/
复制成功
五、初始化 OpenClaw
安装完成后运行：
代码块
Shell
自动换行
复制代码
openclaw onboard
复制成功
会启动 配置向导。
需要配置：
LLM provider
API Key
模型
Gateway
例如：
常见模型配置
OpenAI
代码块
PlainText
自动换行
复制代码
provider: openai
model: gpt-4o
api_key: sk-xxxxx
复制成功
OpenRouter
代码块
PlainText
自动换行
复制代码
provider: openrouter
model: openrouter/auto
api_key: sk-xxxxx
复制成功
本地模型（ollama）
先安装：
代码块
Shell
自动换行
复制代码
curl -fsSL https://ollama.com/install.sh | sh
复制成功
运行模型：
代码块
Shell
自动换行
复制代码
ollama run qwen2.5
复制成功
然后在 openclaw 里配置：
代码块
PlainText
自动换行
复制代码
provider: ollama
model: qwen2.5
endpoint: http://localhost:11434
复制成功
六、启动 OpenClaw
初始化后运行：
代码块
Shell
自动换行
复制代码
openclaw gateway start
复制成功
默认端口：
代码块
PlainText
自动换行
复制代码
http://localhost:3000
复制成功
浏览器访问：
代码块
PlainText
自动换行
复制代码
http://127.0.0.1:3000
复制成功
即可看到 OpenClaw Web UI。
七、设置后台服务（推荐）
Linux 可以用 systemd。(OpenClaw)
安装服务：
代码块
Shell
自动换行
复制代码
sudo openclaw gateway install-service
复制成功
启动：
代码块
Shell
自动换行
复制代码
sudo systemctl start openclaw-gateway
复制成功
开机自启：
代码块
Shell
自动换行
复制代码
sudo systemctl enable openclaw-gateway
复制成功
查看状态：
代码块
Shell
自动换行
复制代码
systemctl status openclaw-gateway
复制成功
八、Docker部署（服务器推荐）
如果是服务器更推荐 Docker：
1 安装 Docker
代码块
Shell
自动换行
复制代码
sudo apt install docker.io docker-compose -y
复制成功
2 拉取 OpenClaw
代码块
Shell
自动换行
复制代码
git clone https://github.com/openclaw/openclaw
cd openclaw
复制成功
3 启动
代码块
Shell
自动换行
复制代码
docker-compose up -d
复制成功
访问：
代码块
PlainText
自动换行
复制代码
http://localhost:3000
复制成功
九、常见问题
1 openclaw command not found
刷新 PATH：
代码块
Shell
自动换行
复制代码
source ~/.bashrc
复制成功
或者重新登录。
2 Node版本过低
重新安装：
代码块
Shell
自动换行
复制代码
sudo apt remove nodejs
复制成功
再安装 Node22。
3 端口被占用
修改配置：
代码块
PlainText
自动换行
复制代码
~/.openclaw/config.yaml
复制成功
例如：
代码块
PlainText
自动换行
复制代码
gateway:
port: 3100
复制成功
十、安全提醒（非常重要）
OpenClaw 的插件（skills）有 安全风险：
有恶意插件会窃取 API key 或文件
因为 agent 可以执行 shell 命令
最近已经发现恶意扩展。(The Verge)
建议：
不要随便安装 skill
检查代码
不要给 root 权限
十一、推荐的完整架构（最稳定）
建议的部署架构：
代码块
PlainText
自动换行
复制代码
Ubuntu 24
├─ Docker
│
├─ OpenClaw
│
├─ Ollama
│ ├─ qwen2.5
│ ├─ deepseek
│
└─ Nginx
└─ https访问
复制成功
这样可以做一个 本地 AI agent server。
