Ubuntu 24.04 安装 OpenClaw 实战指南

如果之前配置过，系统会询问是否使用旧配置或重置（Reset），按需选择即可。

模型选择与注意事项

这里有个关键点：OpenClaw 对上下文长度有要求，默认最小是 16000 Token。如果选择的模型不支持，后续安装可能会报错。

如果你选择 Qwen 但一直卡在 waiting，建议切换到 Custom Provider 模式。例如使用 DeepSeek：

• baseURL: https://api.deepseek.com/v1
• API-KEY: sk-******
• model: deepseek-coder

技能 (Skills) 管理

OpenClaw 支持丰富的插件生态，你可以根据实际需求安装。以下是常用技能的推荐清单：

如何确认安装成功？列出所有已安装的技能：

blucli skills list

Hooks 钩子配置

Hook 是一种轻量级自动化脚本，可在启动、命令执行前后触发。它能帮你记录日志、保存上下文或加载额外文件。

这些 Hook 可选，若不确定可先选 Skip for now，之后通过命令手动开启：

openclaw config set hooks.session-memory true

启动方式选择

安装向导会让你选择启动界面：

1. Hatch in TUI (recommended)：终端用户界面。适合开发者，实时显示日志，支持快捷键，无需浏览器。
2. Open the Web UI：Web 图形界面。适合非技术用户，可视化监控，支持多设备访问。
3. Do this later：跳过设置，稍后手动配置。

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

安装成功后，终端会生成一系列可用命令，包括 openclaw --version 查看版本。

本地访问配置

官方推荐的 Web UI 地址是 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

输入服务器密码完成 SSH 登录。如果忘记 Token，可以在服务器上运行：

openclaw dashboard

界面上会显示完整的访问链接。

3. 访问界面

在本地浏览器输入以下地址（替换 <你的 GATEWAY_TOKEN> 为实际值）：

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

不带 Token 的界面可能无法正常使用，带 Token 后即可正常进入。

至此，OpenClaw 环境已部署完毕，后续可根据具体业务场景探索更多功能。