0. 前言 OpenClaw给是一个开源、可自托管的AI助手平台,原生支持Ollama本地模型和DeepSeek等云端API,让你在隐私与性能之间自由切换。本文记录了我在Ubuntu上从零部署OpenClaw的全过程踩过的坑、优
0. 前言OpenClaw 给是一个开源、可自托管的 AI 助手平台,原生支持 Ollama 本地模型和 DeepSeek 等云端 API,让你在隐私与性能之间自由切换。本文记录了我在 Ubuntu 上从零部署 OpenClaw 的全过程——踩过的坑、优化后的配置,一并进行分享。 1. 什么是 OpenClaw?OpenClaw (俗称龙虾)是一个开源的智能助手平台,可以运行在个人电脑或树莓派等设备上。它最大的特点是支持多种模型后端——可以用本地部署的开源模型保护隐私,也可以接入 DeepSeek、OpenAI 等云端大模型获得更强能力。它的核心功能包括:
本文将从零开始,在 Ubuntu 上完成 OpenClaw 的安装,并同时配置本地模(通过 Ollama) 和云端模型 (DeepSeek API) 两种后端,让你在不同场景自由切换。 2. 环境准备硬件要求如下表所示:
软件要求:Ubuntu 22.04 或 Ubuntu 24.04 3. 安装 OpenClaw3.1 执行安装命令OpenClaw 需要 Node.js 22+,推荐使用 NodeSource 官方源安装。 (1) 添加 NodeSource 仓库:
(2) 安装 Node.js:
(3) 安装完成后,验证是否成功安装,如果没有问题可以在命令行中看到打印出 Node.js 版本号:
(4) 修改配置文件,添加 npm bin 目录到 PATH 中:
(5) 通过 npm 安装 OpenClaw:
3.2 完成初始化引导安装成功后,执行以下命令进入引导程序,需要根据提示完成以下核心设置:
3.3 官方一键脚本部署除了以上方法外,我们也可以使用官方一键脚本部署,这种方式最简单,脚本会自动帮我们处理 Node.js 环境、依赖安装等步骤。 (1) 首先下载官方一键脚本部署:
(2) 在命令行中执行以下命令,脚本会自动开始工作,完成安装后,会自动进入初始化引导,设置方法与上一小节相同:
4. 配置本地模型 (Ollama)Ollama 是一个便捷的本地模型运行工具,能让 OpenClaw 调用我们下载的开源模型。 4.1 安装与配置 Ollama(1) wget 下载 Ollama 安装脚本:
(2) 在终端执行以下命令安装 Ollama:
(3) 启动 Ollama 服务:
4.2 选择并下载模型根据显存大小选择合适的模型:
使用以下命令下载选中的模型,以 qwen3.5:4b 为例:
下载完成后,可以用 ollama list 命令查看已安装的模型列表进行确认:
4.3 将 Ollama 模型接入 OpenClaw现在,我们需要告诉 OpenClaw 如何找到刚下载的本地模型,主要是在配置文件 ~/.openclaw/openclaw.json 中添加 ollama 供应商信息。 (1) 在修改配置文件前,需要首先停止网关:
(2) 编辑配置文件 ~/.openclaw/openclaw.json,在文件中添加或修改以下内容:
(3) 配置完成后,重启一下 OpenClaw 网关让配置生效:
(4) 使用以下命令查看模型列表,可以看到以 ollama/ 为前缀的本地模型:
(5) 为方便使用,可以将本地模型设为默认:
5. 配置云端模型 (DeepSeek)5.1 获取 DeepSeek API Key(1) 访问 DeepSeek 开放平台 (2) 登录后,在「API Keys」页面创建新的 API Key (3) 复制保存(形如 sk-xxxxxxxx) 5.2 DeepSeek 配置首次安装完成后,如果使用云端模型,可以通过使用 openclaw onboard 命令进行配置;已经安装过 OpenClaw 的用户可以通过 openclaw onboard --install-daemon 命令进入配置阶段。
6. 开始使用 OpenClaw6.1 启动对话我们可以通过以下三种方式与 OpenClaw 进行对话。 (1) 打开 Web UI,在 Chat 页面进行交互,使用以下命令:
(2) 在终端中打开 TUI,使用以下命令:
(3) 在终端中与 Openclaw 对话,使用以下命令:
6.2 安装技能扩展通过 Agent 对话安装是最符合 Agent 范式的方式。在 OpenClaw、Claude Code 等 Agent 的对话框中,我们只需用自然语言说一句话,Agent 会自动完成整个安装流程,其中 xx_skill 是我们要安装的 Skill:
Agent 收到指令后,会遵循技能安装的最佳实践,分步执行: 自主发现与验证:Agent 会先浏览技能主页 ClawHub 页面,获取最新的安装说明和元数据,而不是凭“记忆”操作 执行具体安装命令:确认无误后,Agent 会调用对应的 CLI 命令静默安装
环境自检与初始化:安装后,Agent 会立即检查核心工具是否准备就绪,帮我们运行 xx_skill version 验证 整个过程无需手动敲任何命令,Agent 成了我们的“部署工程师”。如果更倾向于自主控制,也可以通过 ClawHub 安装技能:
小结通过本文的配置,我们现在拥有一个双引擎的 AI 助手系统:
OpenClaw 的网关架构让这一切切换变得非常简单,一条命令即可完成。加上日益丰富的技能生态,它正在成为个人 AI 助手的绝佳选择。开始你的 OpenClaw 之旅吧! |
2026-06-02
2026-06-01
2026-06-25
2026-06-24
2026-05-31