• 当前位置：首页 > 主机运维
主机运维

如何在Linux本地部署openclaw

时间：2026-05-15 16:40:02   作者：网际迅联   来源：   阅读：180  
内容摘要：在 Linux 本地部署OpenClaw（2026.2.13 版本）是一个轻量、灵活的 AI 智能体本地化运行方案，适用于个人开发者、小团队或私有 AI 助手场景。以下是基于官方推荐流程 + 实践验证的完整、可执行的本地部署指南（适配 Ubuntu/Debian/CentOS，以......

在 Linux 本地部署 OpenClaw（2026.2.13 版本） 是一个轻量、灵活的 AI 智能体本地化运行方案，适用于个人开发者、小团队或私有 AI 助手场景。以下是基于官方推荐流程 + 实践验证的完整、可执行的本地部署指南（适配 Ubuntu/Debian/CentOS，以 Ubuntu 22.04/24.04 为例）：

✅ 一、环境准备（关键前置步骤）

1. 系统要求（最低保障）

项目 推荐配置
OS Ubuntu 22.04+ / Debian 12+ / CentOS 8+（systemd 环境）
CPU ≥4 核（支持 AVX2 更佳）
内存 ≥8 GB（若启用本地大模型如 Ollama/Qwen2-7B，建议 ≥16 GB）
磁盘 ≥50 GB（含模型缓存与日志）
网络 可访问外网（用于首次拉取依赖、模型、飞书回调等）

? 提示：<extra-info>今天是2026-05-15</extra-info>，当前最新稳定版为 OpenClaw 2026.2.13（发布于 2026-02-26），所有命令与配置均以此版本为准。

2. 安装 Node.js 22（必需）

OpenClaw 主程序由 Node.js 驱动，仅支持 Node.js 20+，强烈推荐 v22.x：

# 使用 nvm（推荐，避免权限与版本冲突）
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash
source ~/.bashrc
nvm install 22
nvm use 22
nvm alias default 22
node --version  # 应输出 v22.x.x
npm --version   # 应输出 ≥10.5

3. 安装基础依赖

# Ubuntu/Debian
sudo apt update && sudo apt install -y git curl wget unzip build-essential python3-pip
# CentOS/RHEL（启用 EPEL）
sudo yum install -y epel-release && sudo yum update -y
sudo yum install -y git curl wget unzip gcc-c++ python3-pip

✅ 二、安装 OpenClaw（两种方式，推荐全局安装）

✅ 方式一：npm 全局安装（最简，适合快速验证）

npm install -g openclaw@2026.2.13
openclaw --version  # 输出 2026.2.13 即成功

⚠️ 注意：若报 EACCES 权限错误，请不要用 sudo npm install，而是修复 npm 权限：

mkdir ~/.npm-global
npm config set prefix '~/.npm-global'
echo 'export PATH=~/.npm-global/bin:$PATH' >> ~/.bashrc
source ~/.bashrc

✅ 方式二：Git 克隆源码（适合二次开发/调试）

git clone https://github.com/openclaw/openclaw.git
cd openclaw
git checkout v2026.2.13  # 切到稳定 tag
npm install
npm link  # 全局注册命令

✅ 三、初始化配置（核心！决定模型、渠道、安全行为）

运行交互式配置向导（会自动生成 ~/.openclaw/config.json）：

openclaw configure

将依次引导你配置以下关键项（按需选择）：

配置项 建议选项 说明
Model Provider ollama / antigravity / qwen / zhipu / custom 若本地跑模型，选 ollama；若用星火/千问等 API，选对应厂商；antigravity 是国产轻量本地代理（推荐新手）
Model Name qwen2:7b / llama3.2:3b / deepseek-coder:6.7b Ollama 中已 ollama pull 的模型名
Base URL http://localhost:11434（Ollama）
http://localhost:8000/v1（Antigravity）		 ❗注意：不能带 /v1 后缀（Ollama 不需要；Antigravity 需要）
Channel Integration feishu（飞书）、wechat（微信）、cli（命令行） 本地测试推荐先选 cli，避免飞书鉴权复杂化
Security Mode strict（默认） 启用沙箱、禁用危险命令（如 rm -rf /、eval）

✅ 配置完成后，可手动校验：

cat ~/.openclaw/config.json | jq '.'  # 需安装 jq：sudo apt install jq

✅ 四、启动服务（CLI 模式快速验证）

# 启动 OpenClaw 网关（默认监听 3000 端口）
openclaw gateway
# 或后台运行（生产可用）
nohup openclaw gateway > ~/.openclaw/logs/gateway.log 2>&1 &

看到类似日志即成功：

✅ Gateway server started on http://localhost:3000
? Loaded model provider: ollama (qwen2:7b)
? Channel: cli
? Ready to process requests!

然后在新终端中发送测试请求：

openclaw chat "你好，请用中文写一段关于 Linux 部署 OpenClaw 的总结"

✅ 若返回结构化响应（含 content 字段），说明本地链路完全打通！

✅ 五、（可选）进阶：对接 Ollama / Antigravity / 飞书

场景 操作要点
对接 Ollama sudo systemctl start ollama → ollama list → 确认模型存在 → config.json 中 baseUrl: "http://localhost:11434"
对接 Antigravity git clone https://github.com/antigravity-ai/antigravity → npm run dev → config.json 中 baseUrl: "http://localhost:8000/v1"
飞书集成 在 飞书开放平台 创建「自建应用」→ 开启「事件订阅」→ 必须选 WebSocket 模式 → config.json 填入 appId/appSecret/verificationToken → openclaw gateway --channel feishu

✅ 六、服务化管理（开机自启 & 日志监控）

创建 systemd 服务（推荐）：

sudo tee /etc/systemd/system/openclaw.service << 'EOF'
[Unit]
Description=OpenClaw AI Gateway
After=network.target
[Service]
Type=simple
User=$USER
WorkingDirectory=/home/$USER
ExecStart=/home/$USER/.npm-global/bin/openclaw gateway
Restart=always
RestartSec=10
StandardOutput=journal
StandardError=journal
[Install]
WantedBy=multi-user.target
EOF
sudo systemctl daemon-reload
sudo systemctl enable openclaw
sudo systemctl start openclaw
sudo journalctl -u openclaw -f  # 查看实时日志

? 常见问题速查（2026.2.13 版高频）

现象 解决方案
command not found: openclaw 检查 npm config get prefix，确认 bin 路径是否在 $PATH
Failed to connect to model provider 检查 config.json 中 baseUrl 是否可达（curl -v http://localhost:11434/health）
Permission denied: /dev/shm（Ollama 报错） sudo chmod 1777 /dev/shm
飞书消息无响应 确认飞书应用已「发布」、WebSocket 地址填写正确、防火墙放行 3000 端口
CLI 模式不输出回复 检查 config.json 中 "channel": "cli" 且未误设为 "feishu"

? 安全提醒（重要！）

  • OpenClaw 默认启用沙箱执行模式（禁用 shell、fs、process 等高危模块）；
  • 如需调用本地工具（如 ffmpeg、curl），须在 config.json 中显式启用 "tools": ["shell"] 并严格限制白名单；
  • 切勿在公网暴露 gateway 端口，如需远程访问请搭配 frp/ngrok 或反向代理（Nginx + Basic Auth）；
  • 生产环境建议使用 docker 部署（隔离性更强）——可提供 Docker Compose 示例（需告知）。

声明：
1.本站主要是为了记录工作学习中遇到的问题，可能由于本人技术有限，内容难免有纰漏，一切内容仅供参考。
2.本站部分内容来源互联网,如果有图片或者内容侵犯您的权益请联系我们删除！
3.本站所有原创作品，包括文字、资料、图片、网页格式，转载时请标注作者与来源。

------------------------------------------------------------------------------------------------


出处：网际迅联
网址1：https://www.wjxlkj.com

网址2：http://www.wjxlkj.cn


联系方式：

手机号码：13910758317

微信：13910758317

客服QQ：58053012


或下图二维码微信扫码或长按识别添加微信




分享到：微信新浪微博腾讯微博QQ空间腾讯朋友百度新首页
上一篇：Linux命令详解：从基础到进阶的完整指南
下一篇：kvm虚拟机安装
相关文章
本栏最新
本栏推荐
阅读排行
联系我们 - 支付方式 - 购买商业版 - 际迅联淘宝店 - 网站地图


  TCP/IP备案号：京ICP备15035957号-3