📋 第一部分：准备工作
1. 两种接入方式
• OpenAI官方API：直接连接OpenAI的GPT-4.5/5.4等模型，适用于追求最强性能、有付费预算的场景• 本地开源模型：通过Ollama运行GPT-OSS等开源模型，适用于隐私优先、希望完全免费的场景2. 硬件要求
• OpenAI API：内存要求≥2GB，只需运行OpenClaw本身• 本地GPT-OSS:20B：内存要求≥16GB，推荐配置，性能均衡• 本地GPT-OSS:120B：内存要求≥64GB，最强能力，适合高性能服务器3. 软件要求
⚙️ 第二部分：安装核心环境
步骤 1：打开终端
大多数Linux发行版快捷键为 Ctrl + Alt + T。
步骤 2：更新系统并安装基础依赖
# 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
步骤 3：安装 Node.js 22+
OpenClaw需要Node.js 22或更高版本：
# 使用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 或更高
步骤 4：配置npm国内镜像（可选，加速下载）
npm config set registry https://registry.npmmirror.com
🤖 第三部分：选择GPT接入方式
选项A：使用OpenAI官方API（推荐，性能最强）
3A.1 获取OpenAI API Key
访问 OpenAI Platform
注册/登录账号
进入API Keys页面，点击"Create new secret key"
复制生成的密钥（以 sk- 开头）
3A.2 支持的GPT模型版本
OpenClaw最新版本已适配GPT系列模型：
• GPT-5.4：最新版，拥有75%的桌面操作准确率和100万Token上下文，适用于复杂任务和企业级应用• GPT-4.5：性能均衡，幻觉率低，适用于通用场景• GPT-4o：具备多模态能力，适用于需要图像识别的场景• GPT-4 Turbo：响应速度快，适用于实时对话选项B：使用本地开源GPT模型（完全免费、离线可用）
3B.1 安装Ollama
# 使用官方安装脚本curl -fsSL https://ollama.com/install.sh | sh# 启动Ollama服务sudo systemctl enable --now ollama# 验证服务状态systemctl status ollama
3B.2 下载GPT-OSS开源模型
OpenClaw官方推荐的本地模型包括GPT-OSS系列：
# 选项1：gpt-oss:20b（推荐，16GB内存，性能均衡）ollama pull gpt-oss:20b# 选项2：gpt-oss:120b（需要64GB+内存，能力最强）ollama pull gpt-oss:120b
3B.3 测试模型是否可用
# 运行模型测试对话ollama run gpt-oss:20b "Hello, introduce yourself"# 输入 /bye 退出对话
3B.4 验证Ollama API端点
# 检查API是否可用curl http://localhost:11434/v1/models
🚀 第四部分：安装与配置 OpenClaw
步骤 1：安装 OpenClaw
# 使用官方安装脚本curl -fsSL https://openclaw.ai/install.sh | bash# 或使用npm安装（备选）npm install -g openclaw@latest# 验证安装openclaw --version # 应显示 2026.x.x 或更高[citation:2]
步骤 2：初始化配置
# 初始化工作空间[citation:2]openclaw init# 或者使用交互式向导（推荐新手）openclaw onboard --install-daemon
步骤 3：配置GPT模型连接
场景1：配置OpenAI官方API
# 使用配置向导openclaw config wizard
在交互式配置中按以下指引操作：
风险提示：输入 Yes 回车
模型提供商：选择 OpenAI
API Key：输入你的OpenAI API密钥（以sk-开头）
模型选择：选择你想要的GPT版本，例如：
gpt-5.4（最新版）
gpt-4.5-turbo
gpt-4o
其他选项：按默认配置跳过
场景2：配置本地GPT-OSS模型
如果使用本地Ollama，需要手动编辑配置文件：
# 编辑配置文件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"}
步骤 4：启动OpenClaw服务
# 启动网关服务openclaw gateway start# 查看服务状态openclaw gateway status# 生成访问令牌（登录控制台用）openclaw token generate --admin
步骤 5：配置systemd服务（推荐生产环境）
# 创建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
步骤 6：防火墙配置（服务器部署）
# 放行OpenClaw端口sudo ufw allow 18789/tcpsudo ufw reload
🛠️ 第五部分：安装技能（Skills）
OpenClaw通过技能实现具体功能：
1. 查看可用技能
# 列出所有可用的技能[citation:1]openclaw skills list --eligible
2. 安装核心技能
# 网页浏览技能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
3. 查看已安装技能
🖥️ 第六部分：访问与使用
1. 打开Web控制台
# 自动打开浏览器openclaw dashboard# 或手动访问：http://localhost:18789/?token=你的令牌
2. 测试对话
在聊天框中输入：
用agent-browser技能访问百度首页，总结一下主要内容。
如果GPT模型开始"思考"并执行操作，说明部署成功！3. 常用运维命令
# 查看状态openclaw gateway status# 查看实时日志openclaw logs follow# 重启服务openclaw gateway restart# 停止服务openclaw gateway stop# 更新OpenClaw[citation:4]openclaw update
📊 第七部分：模型性能对比
• GPT-5.4 (API)：内存需求2GB以上，支持100万tokens上下文，采用付费模式，拥有最强性能，操作准确率达75%• GPT-4.5 (API)：内存需求2GB以上，支持128K tokens上下文，采用付费模式，性能均衡• GPT-OSS:20B：内存需求16GB以上，支持32K tokens上下文，完全免费，可本地运行，保障隐私安全• GPT-OSS:120B：内存需求64GB以上，支持64K tokens上下文，完全免费，能力最强但资源要求高🔧 第八部分：常见问题排查
问题1：OpenAI API连接失败
解决：检查API Key和网络
# 测试API连接curl https://api.openai.com/v1/models \ -H "Authorization: Bearer 你的API密钥"
问题2：本地模型连接失败
解决：检查Ollama服务状态
# 查看Ollama状态systemctl status ollama# 测试APIcurl http://localhost:11434/api/tags
问题3：持续返回"NO OUTPUT"（仅限本地Ollama）
现象：首次提问无输出，重启后能看到上次回复
# 定位文件find /usr/lib -name "provider-utils.js"# 编辑文件，移除"ollama"判断[citation:8]# 修改前：if(normalized === "ollama" || ...)# 修改后：移除ollama判断# 重启服务systemctl --user restart openclaw
问题4：端口被占用
# 查找占用进程sudo lsof -i :18789# 结束进程sudo kill -9 <PID>
问题5：权限不足
# 修复npm权限sudo chown -R $(whoami) ~/.npm
📝 第九部分：生产环境部署建议
1. Nginx反向代理（如需域名访问）
# /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"; }}
2. 配置SSL证书
sudo apt install -y certbot python3-certbot-nginxsudo certbot --nginx -d your-domain.com
3. 监控脚本
#!/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
🎉 第十部分：完成！
恭喜！你现在已经在Linux上成功部署了由GPT驱动的OpenClaw智能助手。
访问信息汇总
常用命令速查
• openclaw dashboard：打开控制台• openclaw gateway status：查看服务状态• openclaw logs follow：查看实时日志• openclaw plugins list：列出已安装技能• sudo systemctl status openclaw：查看系统服务状态安全建议
API Key安全：妥善保管，不要提交到代码仓库
防火墙配置：仅放行必要端口
定期更新：openclaw update 或 npm update -g openclaw
备份配置：cp -r ~/.openclaw ~/.openclaw.backup
现在，开始享受由GPT驱动的AI智能体吧！ 🚀
10个月宝宝每天需要喝多少奶粉？
