Ubuntu 24.04 部署 OpenClaw 实战指南

注意上下文限制： 系统默认最小上下文窗口为 16000 Token。如果选择的模型超出此限制，后续安装会报错。建议优先选择符合要求的模型，或者使用 Custom Provider 自定义接入。

若遇到 Qwen 模型一直 Waiting 的情况，可尝试切换至 Custom Provider。例如接入 DeepSeek 时，配置如下：

• BaseURL: https://api.deepseek.com/v1
• API Key: sk-**** (替换为你的真实密钥)
• Model: deepseek-coder

技能模块筛选

OpenClaw 提供丰富的技能插件，可根据实际需求按需安装。以下是常用推荐的技能列表：

验证技能是否安装成功，可列出所有已安装项：

blucli skills list

Hook 钩子配置

Hook 是一种轻量级自动化脚本，可在启动、命令执行前后或会话结束时触发。合理启用能显著提升体验。

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

openclaw config set hooks.session-memory true

启动模式选择

• Hatch in TUI (推荐)：直接在终端运行，实时显示日志与状态，适合开发者调试。
• Open the Web UI：图形化界面，支持多设备访问，适合非技术用户或远程监控。
• Do this later：稍后配置。

本地访问配置

服务默认监听在服务器本地端口 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

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

3. 浏览器访问

在本地浏览器打开：

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

未带 Token 的界面无法正常使用，带 Token 后可正常进入控制台。

检查状态

安装完成后，可通过以下命令查看版本及运行状态：

openclaw --version
openclaw status

至此，OpenClaw 环境已准备就绪，后续可根据具体业务场景扩展技能与自动化流程。