��Linux 本地部署 OpenClaw(适配 GPT系列模型)最稳教程

# Debian/Ubuntu 系列sudo apt update && sudo apt upgrade -ysudo apt install -y curl git build-essential# CentOS/RHEL/Fedora 系列sudo dnf update -ysudo dnf install -y curl git gcc-c++ make

# 使用NodeSource官方源安装Node.js 22curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -sudo apt install -y nodejs  # Ubuntu/Debian# 验证安装node --version  # 应显示 v22.x.x 或更高npm --version   # 应显示 10.x.x 或更高

npm config set registry https://registry.npmmirror.com

# 使用官方安装脚本curl -fsSL https://ollama.com/install.sh | sh# 启动Ollama服务sudo systemctl enable --now ollama# 验证服务状态systemctl status ollama

# 选项1：gpt-oss:20b（推荐，16GB内存，性能均衡）ollama pull gpt-oss:20b# 选项2：gpt-oss:120b（需要64GB+内存，能力最强）ollama pull gpt-oss:120b

# 运行模型测试对话ollama run gpt-oss:20b "Hello, introduce yourself"# 输入 /bye 退出对话

# 检查API是否可用curl http://localhost:11434/v1/models

# 使用官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash# 或使用npm安装（备选）npm install -g openclaw@latest# 验证安装openclaw --version  # 应显示 2026.x.x 或更高[citation:2]

# 初始化工作空间[citation:2]openclaw init# 或者使用交互式向导（推荐新手）openclaw onboard --install-daemon

# 使用配置向导openclaw config wizard

# 编辑配置文件nano ~/.openclaw/config.json

{  "models": {    "providers": {      "ollama": {        "baseUrl": "http://localhost:11434",        "apiKey": "ollama",        "api": "openai-completions",        "models": [          {            "id": "gpt-oss:20b",            "name": "GPT-OSS 20B",            "contextWindow": 32768,            "maxTokens": 8192          }        ]      }    }  },  "agents": {    "defaults": {      "model": {        "primary": "ollama/gpt-oss:20b"      }    }  },  "port": 18789,  "token": "your-token-here"}

# 启动网关服务openclaw gateway start# 查看服务状态openclaw gateway status# 生成访问令牌（登录控制台用）openclaw token generate --admin

# 创建systemd服务文件[citation:2]sudo tee /etc/systemd/system/openclaw.service << EOF[Unit]Description=OpenClaw Gateway ServiceAfter=network.target[Service]Type=simpleUser=$USERExecStart=$(which openclaw) gateway startRestart=on-failureRestartSec=10Environment=NODE_ENV=production[Install]WantedBy=multi-user.targetEOF# 启用并启动服务sudo systemctl daemon-reloadsudo systemctl enable openclawsudo systemctl start openclaw

# 放行OpenClaw端口sudo ufw allow 18789/tcpsudo ufw reload

# 列出所有可用的技能[citation:1]openclaw skills list --eligible

# 网页浏览技能openclaw plugins install @openclaw/agent-browser# 文件系统操作技能openclaw plugins install @openclaw/agent-fs# 命令执行技能（谨慎使用）openclaw plugins install @openclaw/agent-exec# 网页搜索技能（需Tavily API）openclaw plugins install @openclaw/agent-search

openclaw plugins list

# 自动打开浏览器openclaw dashboard# 或手动访问：http://localhost:18789/?token=你的令牌

用agent-browser技能访问百度首页，总结一下主要内容。

# 查看状态openclaw gateway status# 查看实时日志openclaw logs follow# 重启服务openclaw gateway restart# 停止服务openclaw gateway stop# 更新OpenClaw[citation:4]openclaw update

# 测试API连接curl https://api.openai.com/v1/models \  -H "Authorization: Bearer 你的API密钥"

# 查看Ollama状态systemctl status ollama# 测试APIcurl http://localhost:11434/api/tags

# 定位文件find /usr/lib -name "provider-utils.js"# 编辑文件，移除"ollama"判断[citation:8]# 修改前：if(normalized === "ollama" || ...)# 修改后：移除ollama判断# 重启服务systemctl --user restart openclaw

# 查找占用进程sudo lsof -i :18789# 结束进程sudo kill -9 <PID>

# 修复npm权限sudo chown -R $(whoami) ~/.npm

# /etc/nginx/sites-available/openclawserver {    listen 80;    server_name your-domain.com;    location / {        proxy_pass http://localhost:18789;        proxy_set_header Host $host;        proxy_set_header X-Real-IP $remote_addr;        proxy_http_version 1.1;        proxy_set_header Upgrade $http_upgrade;        proxy_set_header Connection "upgrade";    }}

sudo apt install -y certbot python3-certbot-nginxsudo certbot --nginx -d your-domain.com

#!/bin/bash# /usr/local/bin/monitor-openclaw.shif ! systemctl is-active --quiet openclaw; then    echo "$(date): OpenClaw is down, restarting..." >> /var/log/openclaw-monitor.log    sudo systemctl restart openclawfi

*/5 * * * * /usr/local/bin/monitor-openclaw.sh