下面带你在 Ubuntu 22.04 桌面版上，从零把 OpenClaw（小龙虾）装起来，并完成一个最小可用小项目：命令行对话 + 执行简单 Shell 命令。全程用官方推荐方式，尽量少踩坑。

一、先搞懂：OpenClaw 是什么

一句话：自托管、可执行任务的 AI Agent 网关。

  • 不是聊天机器人，是能干活的助理：执行命令、读写文件、操作浏览器、发消息等。
  • 数据完全本地 / 自托管，隐私可控。
  • 支持接入：微信 / 飞书 / Telegram / 网页 / 命令行等。
  • 支持模型：DeepSeek、Qwen、GPT、Claude、本地模型等。

    • 我们先做最最简单的：本地命令行聊天 + 让它执行 ls/date 这类命令。

    二、Ubuntu 22.04 准备依赖

    打开终端（Ctrl+Alt+T）：

    如果无法打开终端，安装中文之后终端可以打开了

    无法双向复制黏贴：安培增强功能

    bash

    运行

    更新系统sudo apt update

    sudo apt upgrade -y

    安装基础工具sudo apt install -y curl git build-essential

    安装 Node.js 22（必须，官方要求）

    bash

    运行

    curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -

    sudo apt install -y nodejs

    验证node -v # 应输出 v22.x.xnpm -v

    三、安装 OpenClaw（官方一键脚本，最稳）

    bash

    运行

    curl -fsSL https://openclaw.ai/install.sh | bash

  • 脚本会自动装：openclaw 命令、网关、依赖。
  • 全程回车即可，遇到 sudo 输密码。

    • 验证安装：

    bash

    运行

    which openclaw

    openclaw --version

    [图片]

    四、初始化配置（onboarding，关键一步）

    bash

    运行

    openclaw onboard

    会进入交互式向导，按下面选（新手最简配置）：

  • 安全提示：选 Yes, I understand
  • Quick Start：选 Quick Start（推荐）
  • 模型选择：
  • 选 Qwen（通义千问，免费有额度） 或 DeepSeek
  • 接下来会让你填 API Key（去对应官网注册获取）

    • [图片]

  • Channel（通道）：选 Skip for now（先不用微信 / 飞书）
  • Search Provider：Skip for now
  • Skills（技能）：
  • 先开 Shell（执行命令）、File（读写文件）
  • 其他先关，避免复杂

    • [图片]

  • 安装网关：选 Install & Start Gateway

    • [图片]

    等待几分钟，自动下载网关并启动。

    五、启动服务 & 测试（小项目核心）

  • 启动网关（后台服务）

    • bash

    运行

    openclaw gateway start

    查看状态

    openclaw gateway status

    显示 running 就正常。

  • 命令行聊天（直接用）

    • bash

    运行

    openclaw chat

    现在可以对话了，比如：

    plaintext

    你好

    现在几点了？

    列出当前目录文件

    创建一个 test.txt 文件，内容是 hello openclaw

    它会直接执行 Shell 命令并返回结果，这就是我们的小项目目标！

  • 简单测试技能
  • 问：帮我查一下今天日期 → 调用 date
  • 问：创建文件夹 myproject → 调用 mkdir
  • 问：读取 test.txt 内容 → 调用 cat

    • 六、小项目：做一个 “本地文件助理”

    目标

    用自然语言管理本地文件：创建、删除、查看、搜索。

  • 启用必要技能

    • bash

    运行

    openclaw skills enable shell

    openclaw skills enable file

  • 示例对话（直接在 openclaw chat 里输）

    • plaintext

  • 在 ~/myfiles 下创建 3 个文件：a.txt, b.md, c.json
  • 列出 ~/myfiles 所有文件
  • 把 a.txt 内容改成 "Hello from OpenClaw"
  • 读取 a.txt 内容
  • 删除 b.md
  • 退出聊天

    • 输入 exit 回车。

    七、常用命令（记这几个就够）

    bash

    运行

    openclaw --help # 帮助

    openclaw gateway status # 查看网关状态

    openclaw gateway stop # 停止网关

    openclaw chat # 进入命令行聊天

    openclaw skills list # 查看已启用技能

    openclaw skills enable X # 启用技能X

    openclaw onboard --install-daemon重新配置

    xdg-open ~/.openclaw/workspace打开主目录

    virtualbox实现双向复制，需安装增强功能，超级管理员运行

    curl -fsSL https://open-claw.org.cn/install-cn.sh | bash 国内一条安装

    https://hermes-agent.org/zh/#quickstart hermes安装

    hermes安装 curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

    删除hermes:

    sudo rm -rf ~/.hermes

    sudo pip uninstall -y hermes-agent

    sudo apt clean

    sudo apt autoremove -y

    修复证书：

    sudo apt update

    sudo apt install --reinstall ca-certificates curl git -y

    图片