这是一份真正从 0 到跑通的完整教程（含 sudo 安装 Ollama），一步一步照做一定能成功 👍

---

🚀 OpenClaw + Remote Ollama 完整部署教程（最终完整版）

---

🧠 一、整体架构（先理解）

本地电脑（OpenClaw）
        ↓ HTTP
远程服务器（Ollama + 模型）
        ↓ 推理
返回结果

👉 核心：

• OpenClaw = 控制 + Agent

• Ollama = 跑模型

---

🖥️ 二、远程服务器安装 Ollama（重点）

---

✅ 方法1

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

---

❗ 如果下载很慢（推荐替代）

👉 更快方式（直接二进制）：

curl -L https://ollama.com/download/ollama-linux-amd64 -o ollama
chmod +x ollama
sudo mv ollama /usr/local/bin/

---

✅ 验证安装

ollama --version

---

✅ 拉取模型

ollama pull llama3

---

🌐 三、开启远程访问（关键步骤）

---

✅ 启动 Ollama（允许远程）

OLLAMA_HOST=0.0.0.0 ollama serve

✅ 启动 Ollama使用Power Shell（允许远程）

输入Windows + X, 选择终端管理员,运行如下

setx OLLAMA_HOST "0.0.0.0:11434" /M

---

✅ 后台运行（推荐）

nohup OLLAMA_HOST=0.0.0.0 ollama serve > ollama.log 2>&1 &

---

✅ 开放端口

Ubuntu / Linux

sudo ufw allow 11434

---

✅ 测试远程是否成功

在你本地电脑执行：

curl http://远程IP:11434/api/tags

👉 返回模型列表 = 成功

---

🧱 四、本地安装 OpenClaw

---

✅ 1. 安装 Node.js

要求：

node -v
npm -v

---

✅ 2. 安装 OpenClaw

npm install -g openclaw

---

❗ 如果 npm 慢 / 报错

npm config set registry https://registry.npmmirror.com
npm install -g openclaw

---

✅ 3. 初始化

openclaw onboard --install-daemon

选择：

◇  I understand this is personal-by-default and shared/multi-user use requires lock-down. Continue?
│  Yes
│
◇  Setup mode
│  QuickStart
│
◇  Config handling
│  ● Use existing values
│
◇  Model/auth provider
│  Ollama
│
◇  Ollama base URL
│  http://127.0.0.1:11434
│
◇  Ollama mode
│  Local
│
◇  Default model
│  ollama/qwen2.5:14b
│
◇  Channel status
│  ● Skip for now 
│
◇  Config handling
│  ● Skip for now 
│
◇  Configure skills now? (recommended)
│  No
│
◇  Enable hooks?
│  ◼ Skip for now
│
◇  Gateway service already installed
│  ● Restart
│
◇  How do you want to hatch your bot?
│  ● Hatch in TUI (recommended)

---

⚙️ 五、配置 OpenClaw（连接远程 Ollama）

---

✅ 配置文件路径

~/.openclaw/config.yaml

---

✅ 修改为远程调用

gateway:
  mode: custom

providers:
  ollama:
    base_url: http://远程IP:11434
    model: llama3

✅ Linux一键配置

# 1️⃣ 设置远程 Ollama URL
export OLLAMA_HOST="http://192.168.1.68:11434"

# 2️⃣ 设置 Gateway token（与配置保持一致）
export OPENCLAW_GATEWAY_TOKEN="ollama"

# 3️⃣ 创建 agent（如果不存在）
openclaw agents add default --model deepseek-coder:latest --provider ollama

# 4️⃣ 确认 agent 已创建
openclaw agents list

# 5️⃣ 可选：绑定远程 Ollama URL
# 如果需要绑定到 agent 上，确保 agent config 使用远程 URL
openclaw config set gateway.remote.url http://192.168.1.68:11434

# 6️⃣ 测试 agent 发送消息
openclaw agent --agent default -m "Hello world"

或者使用一键脚本:

#!/bin/bash
# Ubuntu OpenClaw 配置远程 Ollama 完整脚本

# --------------------------
# 1️⃣ 删除旧 agent（如果存在）
# --------------------------
echo "[1/5] 删除旧 agent（default）"
openclaw agents delete default 2>/dev/null || echo "没有旧 agent，跳过删除"

# --------------------------
# 2️⃣ 创建新 agent 并指定模型
# --------------------------
echo "[2/5] 创建新 agent: deepseek-coder:latest"
openclaw agents add default --model deepseek-coder:latest

# --------------------------
# 3️⃣ 设置远程 Ollama URL
# --------------------------
echo "[3/5] 设置远程 Ollama URL"
export OLLAMA_HOST="http://192.168.1.68:11434"
openclaw config set gateway.remote.url "$OLLAMA_HOST"

# --------------------------
# 4️⃣ 设置 Gateway token
# --------------------------
echo "[4/5] 设置 OpenClaw Gateway token"
export OPENCLAW_GATEWAY_TOKEN="ollama"

# --------------------------
# 5️⃣ 允许非加密 WS（仅局域网测试）
# --------------------------
echo "[5/5] 允许非加密 WebSocket（局域网测试用）"
export OPENCLAW_ALLOW_INSECURE_PRIVATE_WS=1

# --------------------------
# ✅ 测试 agent
# --------------------------
echo "测试 agent 是否可以发送消息..."
openclaw agent --agent default -m "Hello world"

echo "脚本执行完成，如果有报错请检查 Windows Ollama 是否已用 --host 0.0.0.0 启动并允许 11434 端口访问"

---

▶️ 六、启动并测试

---

openclaw chat

输入：

hello

👉 有回复 = 成功 🎉

Linux测试:

openclaw agent --message "Hello" --session-id terminal

测试成功时返回如下:

Hey. Good to meet you.

I'm still waking up — this is our first real conversation, so I don't have your details yet.

**Who am I?** I'm your assistant here in this workspace. I can help you with files, commands, browsing, communicating, and keeping things organized. I don't have a fancy name or backstory — I'm just here to be genuinely helpful.

**Who are you?** What should I call you? And if you want, I can help you figure out:
- A name you'd like to use for me (or just keep calling me "you")
- Your timezone (so I know when you're likely busy/sleeping)
- What matters to you most — what projects are you working on? What kind of things do you need help with?

Don't overthink it. Just... talk. I'll figure out the rest from there.

使用TUI命令行操作

 openclaw tui

---

🚨 七、常见问题（必看）

---

❌ 1. connection refused

👉 检查：

• Ollama 是否运行

• IP 是否正确

• 端口是否开放

---

❌ 2. command not found: openclaw

npm config get prefix

把 /bin 加入 PATH

---

❌ 3. 模型不存在

ollama pull llama3

---

❌ 4. 响应很慢

👉 原因：

• CPU 推理

• 网络延迟

👉 解决：

• 用 GPU 服务器

• 换小模型：

  • mistral

  • phi

---

🔥 八、进阶（强烈推荐）

---

🚀 1. GPU 远程推理

👉 最佳组合：

本地轻量电脑 + 远程 RTX 服务器

---

🚀 2. 多模型切换

model: deepseek-coder

---

🚀 3. 自动代码审查（你之前就在做）

openclaw review ./project

---

🔐 九、安全建议（非常重要）

⚠️ Ollama 默认没有认证

---

✅ 推荐方案

1. 只在内网用（最安全）

---

2. Nginx 加认证

location / {
    proxy_pass http://localhost:11434;
    auth_basic "Restricted";
}

---

🎯 最终总结（超简版）

---

👉 五步跑通：

1️⃣ 远程安装 Ollama

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

---

2️⃣ 拉模型

ollama pull llama3

---

3️⃣ 开远程

OLLAMA_HOST=0.0.0.0 ollama serve

---

4️⃣ 本地安装 OpenClaw

npm install -g openclaw

---

5️⃣ 修改配置

base_url: http://远程IP:11434

---

6️⃣ 启动

openclaw chat

---