关于 OpenClaw
OpenClaw 是一个基于终端的 AI 智能体工具，支持在本地构建个性化的工作流。更多详情可查阅官方文档：https://docs.openclaw.ai/start/getting-started
一键安装
在 Ubuntu 24.04 终端中执行以下命令即可快速部署：
curl -fsSL https://openclaw.ai/install.sh | bash
安装过程会显示进度条，完成后提示 Installation Complete。
初始化配置
安装完成后，输入 openclaw onboard 进入配置向导。
按提示选择 Yes 和 QuickStart。如果之前配置过，系统会询问是否重置，可根据需要选择 Reset。
模型选择与注意事项
这里有个关键点：OpenClaw 对上下文长度有要求，默认最小需 16000 Token，否则后续安装可能报错。
若选择 Qwen 一直卡在 waiting，建议切换为自定义 Provider。例如使用 DeepSeek：
- BaseURL:
https://api.deepseek.com/v1 - API Key:
sk-****(填入你的密钥) - Model:
deepseek-coder
技能模块 (Skills)
根据实际需求勾选技能包，以下是推荐列表：
| Skills | 说明 | 推荐程度 |
|---|---|---|
1password | 安全读取密码、密钥等敏感信息 | ✅ 高安全需求 |
blucli | OpenClaw 技能市场核心 CLI 接口 | ✅ 必须安装 |
clawhub | 搜索、安装和管理公开技能包 | ✅ 强烈推荐 |
github | 与 GitHub API 交互（Issue、PR、仓库） | ✅ 开发者必备 |
nano-pdf | PDF 文档处理（提取、合并、转换） | ✅ 文档处理 |
obsidian | 集成 Obsidian 笔记软件 | ✅ 知识工作者 |
openai-whisper | 语音转文字 (STT) | ✅ 语音场景 |
summarize | 自动生成文章摘要 | ✅ 高效阅读 |
video-frames | 提取视频帧图像 | ✅ 视频处理 |
安装完成后，可通过 blucli skills list 确认已安装的技能。
钩子配置 (Hooks)
Hook 是轻量级自动化脚本，可在启动、命令执行前后触发。常用配置如下：
| Hook 名称 | 作用 | 推荐 |
|---|---|---|
boot-md | 启动时加载 Markdown 知识库 | ✅ 个性化助手 |
command-logger | 记录所有执行命令到日志 | ✅ 开发者必开 |
session-memory | 保存会话记忆与上下文 | ✅ 提升体验 |
不确定时可先选 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 上成功部署并可用。后续可根据具体业务场景进一步探索高级功能。
