Ubuntu 24.04 安装与配置 OpenClaw 实战指南

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

启动模式

安装最后一步可选择启动方式：

1. Hatch in TUI (推荐)：直接在终端运行，无需浏览器。适合开发者，实时显示日志和状态，支持快捷键。