Ubuntu_24.04 安装OpenClaw教程
认识OpenClaw
https://docs.openclaw.ai/start/getting-started

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




安装完成
配置命令
在终端输入:
openclaw onboard
选择Yes

选择QuickStart

因为前面配置过,所以提示是否用原来的配置信息,可以使用Reset进行重置

选择模型:
根据自己的需要进行选择, 这里要特别注意一个问题,openClaw对上下文有要求,默认最小是16000Token,要不然后面安装的时候会报下图的错误信息

选择Qwen一直在waiting

如果要使用其他的模型,选择Custom Provider
如果选择DeepSeek,baseURL输入:https://api.deepseek.com/v1
然后输入API-KEY:sk-*******
model输入:deepseek-coder
Skills根据需要进行安装

| skills | 说明 | 是否推荐安装 |
|---|---|---|
1password | 使用 1Password CLI 安全读取密码、API 密钥等敏感信息。适合企业用户保护凭证。 | ✅ 推荐(高安全需求) |
blogwatcher | 监控博客更新并自动通知(如 RSS 订阅)。适合内容创作者。 | ❌ 一般不需 |
blucli | BluOS CLI 工具,用于发现和管理 OpenClaw 技能。它是技能市场的核心命令行接口。 | ✅ 必须安装(建议勾选) |
camsnap | 从摄像头拍摄照片或视频流(如监控)。 | ❌ 除非你有摄像头需求 |
clawhub | 通过 ClawHub 搜索、安装和管理公开技能包。类似 npm 或 pip。 | ✅ 强烈推荐(获取更多技能) |
eightctl | 与 Eight (AI Agent 平台) 集成,可能用于调度或任务分发。 | ❌ 一般不用 |
gemini | 支持 Google Gemini 模型(如 gemini-1.5-pro),让 OpenClaw 能调用 Google AI。 | ✅ 如果你用 Google 生态 |
gifgrep | 在 GIF 图像中搜索文本或关键词(基于 OCR)。 | ❌ 小众用途 |
github | 与 GitHub API 交互:创建 Issue、PR、查看仓库、提交代码等。 | ✅ 推荐(开发者必备) |
gog | GOG 游戏平台集成(可能用于自动化游戏下载/更新)。 | ❌ 不相关 |
goplaces | 获取 Google Places 数据(地点、评分、评论等)。 | ❌ 除非做地图应用 |
himalaya | 可能是一个本地文件同步或备份工具(名称来自“喜马拉雅”)。 | ❌ 未知用途 |
mcporter | Minecraft 服务器端口转发或管理工具? | ❌ 不常用 |
nano-banana-pro | 名称搞笑,可能是实验性技能(如“香蕉”主题的自动化)。 | ❌ 可忽略 |
nano-pdf | 处理 PDF 文档(提取文本、合并、转换等)。 | ✅ 推荐(文档处理) |
obsidian | 与 Obsidian 笔记软件集成,实现笔记查询、标签管理、自动生成大纲等。 | ✅ 推荐(知识工作者) |
openai-whisper | 使用 OpenAI Whisper 模型进行语音转文字(STT)。 | ✅ 推荐(语音输入场景) |
openhue | 控制 Philips Hue 灯泡(智能家居)。 | ❌ 除非你有智能灯 |
oracle | 连接 Oracle 数据库(SQL 查询、数据导出)。 | ✅ 数据库管理员可用 |
ordercli | 订单管理系统 CLI(可能是电商或内部系统集成)。 | ❌ 业务定制 |
sag | 可能是 "Smart Assistant Gateway" 或某个私有项目缩写。 | ❌ 未知 |
songsee | 歌曲识别或音乐推荐工具? | ❌ 小众 |
sonoscli | 控制 Sonos 音响系统(播放音乐、调整音量)。 | ❌ 智能家居用户 |
summarize | 自动生成文章摘要(支持文本、网页、PDF)。 | ✅ 推荐(高效阅读) |
video-frames | 提取视频中的帧图像(用于分析或截图)。 | ✅ 视频处理者可用 |
wacli | WhatsApp 命令行客户端(发送消息、接收通知)。 | ✅ 如果你用 WhatsApp 工作 |
skills如何确认是否安装成功
列出所有已安装的技能
blucli skills list是否启用“Hooks”?
在 OpenClaw 中,Hook(钩子) 是一种轻量级的自动化脚本,会在以下事件发生时触发:
- 启动时
- 每次命令执行前/后
- 会话开始/结束
- 文件加载等
它们可以用来:
- 记录日志
- 加载额外文件
- 自动保存上下文
- 执行预设命令

| Hook 名称 | 作用说明 | 是否推荐启用 |
|---|---|---|
boot-md | 在启动时自动加载 Markdown 文件作为初始知识库(如 README.md、FAQ.md) → 你可以把常用指令、规则写进 .md 文件,让 AI 知道你的偏好 | ✅ 推荐(适合个性化助手) |
bootstrap-extra-files | 启动时自动加载指定目录下的额外文件(如 JSON 配置、CSV 数据表、API 文档) → 帮助 AI 快速了解你的项目结构 | ✅ 推荐(如果你有固定数据源) |
command-logger | 记录所有执行过的命令到日志文件中 → 便于调试、审计和复盘 AI 的行为 | ✅ 强烈推荐(开发者必开) |
session-memory | 为每次会话保存记忆(如上下文对话、变量状态) → 让 AI 能记住“我们之前说过了什么”,避免重复提问 | ✅ 强烈推荐(提升交互体验) |
说明:
- 这些 Hook 是可选的,不启用也不会影响基本功能。
- 如果你不确定,可以先选
Skip for now,之后通过命令行手动添加:
openclaw config set hooks.session-memory true选择界面方式

OpenClaw 在启动 AI 助手时的方式
Hatch in TUI (recommended):推荐!使用 终端用户界面(TUI) 启动 OpenClaw
优点:
- 直接在终端中运行,无需浏览器
- 实时显示日志、状态、命令执行过程
- 快速调试技能、查看错误信息
- 支持键盘快捷键(如 Ctrl+C 停止)
适合人群:
- 开发者
- 运维人员
- 喜欢命令行操作的用户
Open the Web UI:使用 Web 界面 启动 OpenClaw
优点:
- 图形化操作:拖拽技能、配置参数更直观
- 支持多设备访问(手机/平板)
- 可视化监控:会话历史、性能图表等
- 更适合非技术用户
适合人群:
- 非程序员
- 想快速上手的普通用户
- 需要远程访问的人
Do this later:跳过,稍微再设置
其他配置

等待安装完成



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

openclaw安装完成后的命令会有这些:

查看版本:openclaw --version
访问
官方推荐用http://127.0.0.1:18789/
我们本地不能直接访问,需要建立隧道才能访问,在本地电脑上执行下面的命令
说明:这里特别注意是是在本地电脑上执行如下命令,不是在云服务器执行。
(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)输入ECS服务器密码后,完成SSH登录。
(3)通过隧道登录
本地浏览器输入http://127.0.0.1:18789/?token=<;您的GATEWAY_TOKEN>即可正常通过隧道登录。
如果不记得token,如何获取token?
在服务器上输入openclaw dashboard,界面上会显示访问的完整的链接地址

直接访问http://127.0.0.1:18789的界面如下:

访问带有token的界面如下(正常界面):

具体的使用后续教程分享