OpenClaw 本地部署详细教程（Linux / Mac / Windows 通用）

一、OpenClaw 是什么

OpenClaw 是一个 本地优先的 AI Agent 自动化平台，你可以理解为：

本地版「可执行任务的 ChatGPT + 自动化助手」

它支持：

• 本地 LLM（Ollama）
• OpenAI / Claude / Gemini
• 文件操作
• Shell 执行
• Web 自动化
• Slack / Telegram / Discord
• 定时任务
• 多 Agent 协作

特别适合你这种做：

• 本地知识库
• 自动代码生成
• 文档处理
• 爬虫调度
• 运维自动化
• OCR / 合同流转

的场景。(TechRadar)

二、部署方式推荐（最稳）

对于本地部署，我建议你直接用：

官方 install-cli 本地前缀安装

优点：

• 不污染系统 Node
• 所有文件都在 ~/.openclaw
• 好迁移
• 好备份
• 适合服务器长期运行

官方推荐命令：(OpenClaw)

curl -fsSL https://openclaw.ai/install-cli.sh | bash

三、服务器配置建议

最低配置

2 Core CPU
4GB RAM
20GB SSD

推荐配置（本地模型）

8 Core CPU
16GB RAM
100GB SSD
RTX 3060+

如果你准备接 Ollama 本地模型：

建议：

32GB RAM + 12GB VRAM

四、Linux 本地部署（推荐 Ubuntu）

1）安装

curl -fsSL https://openclaw.ai/install-cli.sh | bash

默认目录：

~/.openclaw

目录结构一般如下：

~/.openclaw/
├── bin/
├── config/
├── data/
├── logs/
├── tools/
└── runtime/

2）验证安装

~/.openclaw/bin/openclaw --version

或者加入环境变量：

echo 'export PATH="$HOME/.openclaw/bin:$PATH"' >> ~/.bashrc
source ~/.bashrc

然后：

openclaw --version

3）初始化服务

openclaw onboard --install-daemon

这一步会自动：

• 初始化配置
• 安装守护进程
• 创建用户服务
• 启动 Gateway

官方推荐这样做。(OpenClaw)

五、接入本地 Ollama（重点）

这个是本地部署最关键的一步。

1）安装 Ollama

curl -fsSL https://ollama.com/install.sh | sh

2）拉取模型

推荐你先用：

ollama pull qwen2.5:7b

或者：

ollama pull llama3.1:8b

3）验证模型

ollama run qwen2.5:7b

4）OpenClaw 配置模型

编辑：

~/.openclaw/config/models.json

写入：

{
  "providers": {
    "ollama": {
      "base_url": "http://127.0.0.1:11434",
      "model": "qwen2.5:7b"
    }
  }
}

社区大量本地部署都这么配。(reddit.com)

六、Docker 部署（更适合服务器）

如果你服务器主要跑 Docker，推荐这个。

docker-compose.yml

version: "3.9"

services:
  openclaw:
    image: node:24
    container_name: openclaw
    restart: always
    ports:
      - "3000:3000"
    volumes:
      - /data/openclaw:/root/.openclaw
    command: >
      sh -c "
      npm install -g openclaw@latest &&
      openclaw onboard --install-daemon &&
      tail -f /dev/null
      "

启动：

docker compose up -d

七、常用运维命令

查看状态

openclaw gateway status

查看健康检查

openclaw doctor

查看日志

tail -f ~/.openclaw/logs/gateway.log

重启

openclaw gateway restart

停止

openclaw gateway stop

八、Nginx 反向代理（生产推荐）

你经常做部署，这块对你很重要。

server {
    listen 80;
    server_name claw.yourdomain.com;

    location / {
        proxy_pass http://127.0.0.1:3000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

九、安全配置（非常重要）

OpenClaw 默认权限很高，一定要做权限收敛。研究显示其工具链调用存在较大攻击面。(arXiv)

建议：

禁止高危工具

进入配置：

Config -> Tools -> Deny

建议先禁用：

• shell
• browser
• gateway
• sessions
• web_search

尤其你本地模型推理能力有限时，禁掉很多工具反而更稳。(reddit.com)

绑定本地

127.0.0.1:3000

不要直接公网裸露。

配合 Nginx + Basic Auth

auth_basic "OpenClaw";
auth_basic_user_file /etc/nginx/.htpasswd;

十、和你技术栈最搭的玩法（推荐）

结合你的方向，我建议你这样用：

1）本地代码 Agent

• Vue 自动生成页面
• Python 数据脚本
• Shell 自动部署
• Elasticsearch DSL 自动生成

2）文档自动化

• 合同 OCR
• DOCX 解析
• PDF 分类
• 自动标签抽取

3）RAG 自动化

• 本地知识库索引
• 自动 chunk
• 自动 embedding
• 自动 ES 入库

十一、故障排查（高频）

问题1：找不到命令

openclaw: command not found

修复：(OpenClaw)

export PATH="$HOME/.openclaw/bin:$PATH"

问题2：本地模型无响应

检查：

curl http://127.0.0.1:11434/api/tags

问题3：服务没启动

openclaw gateway status
openclaw doctor

十二、最适合你的生产级架构（推荐）

Nginx
   ↓
OpenClaw
   ↓
Ollama(Qwen2.5)
   ↓
Elasticsearch
   ↓
MinIO
   ↓
Your OCR / Contract System

这套特别适合：

• OCR合同系统
• 版权咨询平台
• Elasticsearch检索
• 自动化工作流