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

模型选择与注意事项

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

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

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

技能模块 (Skills)

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

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

钩子配置 (Hooks)

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

不确定时可先选 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 上成功部署并可用。后续可根据具体业务场景进一步探索高级功能。