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

Ubuntu 24.04 安装与配置 OpenClaw 实战指南

本文详细记录了在 Ubuntu 24.04 环境下安装与配置 OpenClaw 的全过程。内容涵盖一键安装脚本、Onboard 初始化流程、模型参数调整(特别是 Context Token 限制)、常用技能模块筛选与验证、Hook 自动化脚本配置以及 TUI 与 Web UI 启动模式选择。重点解决了远程访问时的 SSH 端口映射问题,指导如何通过本地隧道安全连接服务器上的服务,并提供 Token 获取方法以确保正常登录。

星星泡饭发布于 2026/3/26更新于 2026/10/2596 浏览

OpenClaw 简介

OpenClaw 是一个基于终端的 AI Agent 工具,旨在通过命令行高效管理任务。官网文档提供了详细的入门指引。

环境安装

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

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

安装过程会自动处理依赖,完成后会提示成功。

初始化配置

安装完毕后,在终端输入 openclaw onboard 开始配置向导。

模型选择

系统会询问是否使用默认配置。这里有个关键点需要注意:OpenClaw 对上下文长度有要求,默认最小需 16000 Token,否则后续安装可能会报错。

如果默认模型(如 Qwen)一直卡在 waiting 状态,建议切换到 Custom Provider。例如使用 DeepSeek:

  • Base URL: https://api.deepseek.com/v1
  • API Key: 填入你的密钥
  • Model: deepseek-coder

技能模块 (Skills)

接下来根据实际需求勾选技能。以下是常用推荐项:

技能名称说明推荐度
blucli核心 CLI 接口,用于管理技能✅ 必须
github与 GitHub API 交互,开发者必备✅ 推荐
clawhub搜索和安装公开技能包✅ 强烈推荐
1password安全读取敏感信息✅ 高安全需求
nano-pdfPDF 文档处理✅ 推荐
obsidian笔记软件集成✅ 知识工作
summarize自动生成摘要✅ 高效阅读

确认安装后,可通过以下命令验证:

blucli skills list

Hook 钩子配置

Hook 是轻量级自动化脚本,可在特定事件触发。建议启用以下项以提升体验:

  • command-logger: 记录所有执行命令,便于调试审计。
  • session-memory: 保存会话记忆,避免重复提问。
  • boot-md: 启动时加载 Markdown 知识库,定义偏好规则。

若不确定,可先跳过,后续通过命令手动开启:

openclaw config set hooks.session-memory true

启动模式

安装最后一步可选择启动方式:

  1. Hatch in TUI (推荐):直接在终端运行,无需浏览器。适合开发者,实时显示日志和状态,支持快捷键。
  2. Open the Web UI:图形化界面,适合非技术用户或需要远程访问的场景。
  3. Do this later:稍后设置。

远程访问

官方默认监听 http://127.0.0.1:18789/。由于服务器本地无法直接外网访问,需要在本地电脑建立 SSH 隧道。

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

建立隧道

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

输入服务器密码登录后,保持该终端窗口开启。

获取 Token 并访问

在服务器上运行 openclaw dashboard 可查看完整的访问链接及 Token。

本地浏览器访问:

http://127.0.0.1:18789/?token=<GATEWAY_TOKEN>

带上 Token 后即可正常进入 Web 界面。至此,OpenClaw 已部署完成,后续可根据具体业务场景进行深度定制。

目录

  1. OpenClaw 简介
  2. 环境安装
  3. 初始化配置
  4. 模型选择
  5. 技能模块 (Skills)
  6. Hook 钩子配置
  7. 启动模式
  8. 远程访问
  9. 建立隧道
  10. 获取 Token 并访问

更多推荐文章

查看全部
  • 递归算法实战:汉诺塔与合并有序链表详解
  • 鸿蒙金融理财全栈项目:生态合作、用户运营与数据变现优化
  • AI 辅助构建高可用电商系统核心架构实战
  • 文心一言 4.5 开源模型深度解析:轻量化部署与中文场景优化
  • 前端地图开发基础:服务类型、坐标系与 SDK 简介
  • Spatial Joy 2025 AR&AI 大赛:开发者资源、玩法与避坑全解析
  • 动态规划:01 背包与完全背包详解及零钱兑换 II 解法
  • CoPaw 个人助理部署与定制实战:从零搭建专属 AI 数字搭档
  • Qwen3-VL 结合 LLaMA-Factory 实现 Grounding 任务 LoRA 微调
  • 前端三年成长记:从理想主义到工程实战的蜕变
  • C++ 哈希表封装实战:unordered_map/set 底层原理与完整实现
  • OpenClaw 对接飞书机器人:消息无响应与 Gateway 断开排查
  • Android WebView shouldInterceptRequest 异步加载
  • Android ApplicationInfo 元数据读取 getString 返回 null 问题排查
  • Qwen2.5 技术报告解析:18 万亿 Token 训练与性能表现
  • Android 开发工程师秋招面试真题汇总与备考经验
  • Llama-3.2-3B 部署:Ollama 镜像免配置及 Mac M1/M2 原生运行实测
  • AI 驱动的小程序开发:从 UI 设计到代码生成实战
  • MATLAB 实现基于天牛须搜索算法(BAS)的无人机三维路径规划
  • Pi0 机器人 VLA 大模型在昇腾 A2 平台上的测评

相关免费在线工具

  • 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