认识 OpenClaw
OpenClaw 是一个开源的 AI 智能体框架，旨在通过命令行和自动化技能提升开发效率。官方文档提供了详细的入门指引。
安装 OpenClaw
在 Ubuntu 24.04 终端中执行以下脚本进行安装：
curl -fsSL https://openclaw.ai/install.sh | bash
等待脚本自动下载并配置环境，直到看到安装完成的提示。
配置命令
安装完成后，运行初始化命令：
openclaw onboard
根据向导提示操作。首次运行会询问是否使用现有配置，若需重置可输入 Reset。接着选择模型服务，这里有个关键点：OpenClaw 对上下文长度有要求，默认最小需 16000 Token，否则后续安装可能报错。
模型选择
- Qwen: 选择后可能会长时间处于 waiting 状态，视网络情况而定。
- Custom Provider: 如需使用其他模型（如 DeepSeek），选择此项。
- baseURL 输入：
https://api.deepseek.com/v1 - API-KEY 输入你的密钥
- model 输入：
deepseek-coder
- baseURL 输入：
技能安装 (Skills)
接下来按需安装技能模块。以下是推荐清单：
| Skills | 说明 | 建议 |
|---|---|---|
1password | 安全读取密码/API 密钥 | ✅ 高安全需求 |
blucli | 技能市场核心 CLI 接口 | ✅ 必须安装 |
clawhub | 搜索管理公开技能包 | ✅ 强烈推荐 |
github | GitHub API 交互 | ✅ 开发者必备 |
nano-pdf | PDF 文档处理 | ✅ 推荐 |
obsidian | 笔记软件集成 | ✅ 知识工作者 |
openai-whisper | 语音转文字 | ✅ 语音场景 |
summarize | 自动生成摘要 | ✅ 高效阅读 |
验证安装状态：
blucli skills list
Hook 钩子配置
Hook 用于在特定事件（启动、命令执行前后）触发自动化脚本。推荐启用以下项以提升体验：
command-logger: 记录所有执行命令，便于调试审计。session-memory: 保存会话记忆，避免重复提问。boot-md: 加载 Markdown 知识库，让 AI 了解偏好。
若不确定，可选择 Skip，后续通过命令手动开启：
openclaw config set hooks.session-memory true
启动方式选择
- Hatch in TUI (recommended): 终端界面，适合开发者，实时日志，支持快捷键。
- Open the Web UI: 图形化界面，适合非技术用户或远程访问。
- Do this later: 稍后配置。
本地访问配置
OpenClaw 默认监听 http://127.0.0.1:18789/。由于服务器通常无法直接外网访问，需要在本地电脑上建立 SSH 隧道。
建立隧道
在本地终端执行（替换 <ECS 公网 IP 地址> 为实际 IP）：
ssh -L 18789:127.0.0.1:18789 -L 18792:127.0.0.1:18792 root@<ECS 公网 IP 地址>
输入服务器密码登录后保持连接。
获取 Token 并访问
登录成功后，在服务器上运行：
openclaw dashboard
查看界面上显示的完整访问链接及 Token。在本地浏览器打开：
http://127.0.0.1:18789/?token=<您的 GATEWAY_TOKEN>
即可正常进入控制台。安装完成后，可使用 openclaw status 或 openclaw --version 检查状态。
