OpenClaw 简介
OpenClaw 是一个基于终端的 AI Agent 工具,旨在通过命令行高效管理任务。官网文档提供了详细的入门指引。
环境安装
在 Ubuntu 24.04 终端中执行以下命令即可快速安装:
curl -fsSL https://openclaw.ai/install.sh | bash
安装过程会自动处理依赖,完成后会提示成功。
初始化配置
安装完毕后,在终端输入 openclaw onboard 开始配置向导。
模型选择
系统会询问是否使用默认配置。这里有个关键点需要注意:OpenClaw 对上下文长度有要求,默认最小需 16000 Token,否则后续安装可能会报错。
如果默认模型(如 Qwen)一直卡在 waiting 状态,建议切换到 Custom Provider。例如使用 DeepSeek:
- Base URL:
https://api.deepseek.com/v1 - API Key: 填入你的密钥
- Model:
deepseek-coder
技能模块 (Skills)
接下来根据实际需求勾选技能。以下是常用推荐项:
| 技能名称 | 说明 | 推荐度 |
|---|---|---|
blucli | 核心 CLI 接口,用于管理技能 | ✅ 必须 |
github | 与 GitHub API 交互,开发者必备 | ✅ 推荐 |
clawhub | 搜索和安装公开技能包 | ✅ 强烈推荐 |
1password | 安全读取敏感信息 | ✅ 高安全需求 |
nano-pdf | PDF 文档处理 | ✅ 推荐 |
obsidian | 笔记软件集成 | ✅ 知识工作 |
summarize | 自动生成摘要 | ✅ 高效阅读 |
确认安装后,可通过以下命令验证:
blucli skills list
Hook 钩子配置
Hook 是轻量级自动化脚本,可在特定事件触发。建议启用以下项以提升体验:
command-logger: 记录所有执行命令,便于调试审计。session-memory: 保存会话记忆,避免重复提问。boot-md: 启动时加载 Markdown 知识库,定义偏好规则。
若不确定,可先跳过,后续通过命令手动开启:
openclaw config set hooks.session-memory true
启动模式
安装最后一步可选择启动方式:
- Hatch in TUI (推荐):直接在终端运行,无需浏览器。适合开发者,实时显示日志和状态,支持快捷键。
- Open the Web UI:图形化界面,适合非技术用户或需要远程访问的场景。
- Do this later:稍后设置。
远程访问
官方默认监听 http://127.0.0.1:18789/。由于服务器本地无法直接外网访问,需要在本地电脑建立 SSH 隧道。
注意:隧道命令必须在本地电脑执行,而非云服务器。
建立隧道
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>
带上 Token 后即可正常进入 Web 界面。至此,OpenClaw 已部署完成,后续可根据具体业务场景进行深度定制。
