跳到主要内容
极客日志极客日志面向AI+效率的开发者社区
首页博客我的书AI学习GitHub 精选镜像AI工具UI配色美学关于
搜索内容 / 工具 / 仓库 / 镜像...⌘K搜索
注册
博客列表
Shell / BashAI

Ubuntu 24.04 部署 OpenClaw 本地 AI 助手指南

Ubuntu 24.04 环境下通过一键脚本快速部署 OpenClaw 本地 AI 助手。涵盖基础安装、模型配置(支持 DeepSeek 等)、技能模块选择及 Hook 钩子设置。重点说明如何通过 SSH 隧道在本地浏览器访问服务器端的 Web UI,并解决 Token 上下文限制导致的报错问题。提供常用命令查看状态及版本信息,适合开发者构建个性化终端 AI 工作流。

人间失格发布于 2026/3/15更新于 2026/10/25101 浏览
Ubuntu 24.04 部署 OpenClaw 本地 AI 助手指南

关于 OpenClaw

OpenClaw 是一个基于终端的 AI 智能体工具,支持在本地构建个性化的工作流。更多详情可查阅官方文档:https://docs.openclaw.ai/start/getting-started

文章配图

一键安装

在 Ubuntu 24.04 终端中执行以下命令即可快速部署:

curl -fsSL https://openclaw.ai/install.sh | bash

安装过程会显示进度条,完成后提示 Installation Complete。

文章配图 文章配图 文章配图 文章配图 文章配图

初始化配置

安装完成后,输入 openclaw onboard 进入配置向导。

文章配图

按提示选择 Yes 和 QuickStart。如果之前配置过,系统会询问是否重置,可根据需要选择 Reset。

文章配图 文章配图 文章配图

模型选择与注意事项

这里有个关键点:OpenClaw 对上下文长度有要求,默认最小需 16000 Token,否则后续安装可能报错。

文章配图

若选择 Qwen 一直卡在 waiting,建议切换为自定义 Provider。例如使用 DeepSeek:

  • BaseURL: https://api.deepseek.com/v1
  • API Key: sk-**** (填入你的密钥)
  • Model: deepseek-coder

技能模块 (Skills)

根据实际需求勾选技能包,以下是推荐列表:

Skills说明推荐程度
1password安全读取密码、密钥等敏感信息✅ 高安全需求
blucliOpenClaw 技能市场核心 CLI 接口✅ 必须安装
clawhub搜索、安装和管理公开技能包✅ 强烈推荐
github与 GitHub API 交互(Issue、PR、仓库)✅ 开发者必备
nano-pdfPDF 文档处理(提取、合并、转换)✅ 文档处理
obsidian集成 Obsidian 笔记软件✅ 知识工作者
openai-whisper语音转文字 (STT)✅ 语音场景
summarize自动生成文章摘要✅ 高效阅读
video-frames提取视频帧图像✅ 视频处理

安装完成后,可通过 blucli skills list 确认已安装的技能。

钩子配置 (Hooks)

Hook 是轻量级自动化脚本,可在启动、命令执行前后触发。常用配置如下:

Hook 名称作用推荐
boot-md启动时加载 Markdown 知识库✅ 个性化助手
command-logger记录所有执行命令到日志✅ 开发者必开
session-memory保存会话记忆与上下文✅ 提升体验

不确定时可先选 Skip for now,后续通过命令行手动开启:

openclaw config set hooks.session-memory true

启动方式选择

  • Hatch in TUI (推荐):直接在终端运行,实时查看日志与状态,适合开发者调试。
  • Open the Web UI:图形化界面,适合非技术用户或远程访问。
  • Do this later:稍后设置。

文章配图 文章配图

等待安装完成,可用 openclaw status 查看状态。

文章配图 文章配图 文章配图 文章配图

安装成功后,终端会列出可用命令,输入 openclaw --version 可查看版本。

文章配图

本地访问

官方推荐访问地址为 http://127.0.0.1:18789/。由于服务运行在服务器端,需在本地电脑建立 SSH 隧道才能访问。

⚠️ 注意:隧道命令请在本地电脑执行,而非云服务器。

1. 建立隧道

ssh -L 18789:127.0.0.1:18789 -L 18792:127.0.0.1:18792 root@<ECS 公网 IP 地址>

例如:

ssh -L 18789:127.0.0.1:18789 -L 18792:127.0.0.1:18792 [email protected]

2. 获取 Token

登录成功后,在服务器上输入 openclaw dashboard,界面上会显示完整的访问链接及 Token。

文章配图

3. 浏览器访问

在本地浏览器打开:

http://127.0.0.1:18789/?token=YOUR_GATEWAY_TOKEN

未带 Token 的界面无法正常使用,带 Token 后可正常操作。

文章配图 文章配图

至此,OpenClaw 已在 Ubuntu 24.04 上成功部署并可用。后续可根据具体业务场景进一步探索高级功能。

目录

  1. 关于 OpenClaw
  2. 一键安装
  3. 初始化配置
  4. 模型选择与注意事项
  5. 技能模块 (Skills)
  6. 钩子配置 (Hooks)
  7. 启动方式选择
  8. 本地访问
  9. 1. 建立隧道
  10. 2. 获取 Token
  11. 3. 浏览器访问

更多推荐文章

查看全部
  • DeepSeek 时代,前端开发的变革与实战路径
  • 数据结构核心:链表详解与实现
  • 解决复杂查询难题:通过 Self-querying Prompting 优化 RAG 系统效率
  • 无人机红外照片处理中的温度校准与精度优化策略
  • 轻小说机翻机器人:日语小说自动翻译工具
  • 基于改进 YOLOv8 的美食图像分割系统实战
  • 数据结构:常见时间复杂度与空间复杂度
  • AIGC 产品经理转行指南:核心技能与实战项目解析
  • OpenClaw 飞书机器人权限配置与安全指南
  • 多模态模型开发实战:文本、图像与语音的融合应用
  • Python 入门基础知识:新手必备核心类型与内置方法
  • C++ STL list 模拟实现:双向链表与迭代器封装
  • 算法实战:LeetCode 1419 数青蛙(模拟法)
  • 大模型面试核心知识点整理:基础、微调、推理与评测
  • 前端面试高频题库整理(JavaScript/React/Vue/工程化等)
  • Trae AI IDEA 插件实战指南:Java 开发效率提升
  • AI 驱动的前端开发新范式:从工具辅助到智能重构
  • JavaScript 数组方法:find 与 findIndex 用法详解
  • Kubernetes: 使用 kubectl 插件 ketall 查看所有 API 对象资源
  • 基于 SpringBoot 的超市会员积分管理系统

相关免费在线工具

  • RSA密钥对生成器

    生成新的随机RSA私钥和公钥pem证书。 在线工具,RSA密钥对生成器在线工具,online

  • Mermaid 预览与可视化编辑

    基于 Mermaid.js 实时预览流程图、时序图等图表,支持源码编辑与即时渲染。 在线工具,Mermaid 预览与可视化编辑在线工具,online

  • 随机西班牙地址生成器

    随机生成西班牙地址(支持马德里、加泰罗尼亚、安达卢西亚、瓦伦西亚筛选),支持数量快捷选择、显示全部与下载。 在线工具,随机西班牙地址生成器在线工具,online

  • Base64 字符串编码/解码

    将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具,Base64 字符串编码/解码在线工具,online

  • Base64 文件转换器

    将字符串、文件或图像转换为其 Base64 表示形式。 在线工具,Base64 文件转换器在线工具,online

  • Markdown转HTML

    将 Markdown(GFM)转为 HTML 片段,浏览器内 marked 解析;与 HTML转Markdown 互为补充。 在线工具,Markdown转HTML在线工具,online