AI人工智能 | 养龙虾必备的基础知识

木筏
0 阅读7分钟

本文主要介绍“养龙虾”入门的基础知识：大模型的定义、养龙虾的工具以及使用Docker从零搭建龙虾的全流程。

一、什么是“养龙虾”？

“养龙虾”这一比喻源于著名的AI代理项目 OpenClaw —— “Claw”意为“爪子”，而龙虾拥有两只大钳（爪），因此运行OpenClaw代理就被戏称为“养龙虾”。

简单来说，“养龙虾”就是利用特定工具（OpenClaw、ClawX等）和大模型，创建一个能够自主执行任务、调用工具、完成复杂操作的AI助手。

你就像养了一只电子宠物龙虾，它能帮你处理文件、搜索信息、调用API，甚至操作你的电脑。

二、基础认知：大模型是什么？有哪些？

大模型的定义

大模型（Large Language Model, LLM）是经过海量数据训练的人工神经网络，能够理解并生成自然语言，执行推理、翻译、总结等任务。它们是“龙虾”的大脑。

常见大模型

模型名称开发者特点
GPT‑5.2OpenAI多模态、强推理，商业授权
Claude Opus 4.7Anthropic长上下文（1M）、安全性高
DeepSeek-V4 Pro深度求索中文优秀，开源可商用
Llama 5Meta开源，适合本地部署，系统Ⅱ推理
Qwen3.6-Max-Preview阿里云多语言，支持工具调用

在“养龙虾”中，你需要为OpenClaw配置一个大模型API（如OpenAI或本地运行的开源模型）。

三、核心工具（一）：OpenClaw

OpenClaw 是一个开源的AI代理框架，你可以把它理解为“龙虾的身体与神经系统”。

它能够：

  • 接收用户自然语言指令
  • 调用大模型进行推理与规划
  • 执行代码、读写文件、控制浏览器、发送HTTP请求等

OpenClaw 支持插件机制和技能系统，是“养龙虾”的核心运行时。通常我们把它运行在Docker容器中，以保证环境隔离。

其他同类工具：CoPaw（阿里）与 QClaw（腾讯）：

  • CoPaw（阿里）：功能与 OpenClaw 对等的完整代理框架，自带图形化 Web 控制台，无需额外安装客户端（如 ClawX）
  • QClaw（腾讯）：基于 OpenClaw 深度改造并封装而成的本地 AI 助手，以普通软件形式一键安装，自带使用界面且打通微信

四、核心工具（二）：ClawX

ClawX 是OpenClaw 的官方桌面客户端，用于与OpenClaw代理进行交互。

它的作用类似于“遥控器”：

  • 通过命令行或图形界面发送指令给OpenClaw
  • 接收并展示代理的执行结果
  • 支持多种传输协议（如WebSocket、HTTP）

OpenClaw与ClawX的关系：

  • OpenClaw = 后端代理（运行在容器或远程服务器）
  • ClawX = 前端交互客户端（运行在宿主机或本地终端）

使用ClawX连接OpenClaw容器，你就可以在macOS等宿主机或终端里给你的AI下命令。

五、能力扩展：Skills

Skills 是OpenClaw生态中的“可复用能力模块”，你可以理解为给龙虾装配的各种“工具手”。

每个Skill是一个独立的脚本或配置文件，告诉代理如何完成特定任务。例如：

  • file_reader skill：读取指定文件内容
  • web_search skill：调用搜索引擎查询
  • send_email skill：通过SMTP发送邮件

作用：

  • 标准化复杂操作，降低重复编码
  • 社区共享，快速增强“龙虾”的能力
  • 用户可自定义专属Skills，满足个性化需求

在“养龙虾”过程中，你往往需要下载或编写几个基础Skills才能让龙虾真正干活。

六、必备工具清单与环境准备

在开始“养龙虾”之前，请确保你已准备好以下工具和环境：

工具/环境用途
Docker运行OpenClaw容器，隔离环境，避免影响主机系统。与虚拟机相比，轻量、体积小、秒启动
Linux系统作为OpenClaw运行的Linux基础系统
OpenClaw核心代理程序，在容器中运行
ClawX安装在宿主机（你的macOS），用于连接容器并下达指令
大模型API Key例如OpenAI API Key，或本地部署的模型服务地址

七、实战：从0到1搭建你的第一只“龙虾”

下面将在 Docker 中通过官方 Docker Compose 方式部署 OpenClaw，并在 macOS 宿主机上安装 ClawX 客户端与其连接。

步骤1：安装Docker

  1. 访问 docker.com 下载并安装 Docker Desktop for Mac
  2. 启动Docker，检查是否安装成功docker --version
  3. Docker Desktop 中文汉化（可选）

提示：

  • 当前macOS Ventura 13.x最高可装 Docker Desktop 4.43.0；4.44.0+ 不再支持 Ventura，按芯片（Intel Mac/Apple Silicon（M1/M2/M3））选择对应的安装包。附历史版本下载链接：docs.docker.com/desktop/rel…
  • 无法通过Docker Desktop设置中文时，可通过汉化包进行汉化。根据Docker版本按芯片选择汉化包：github.com/asxez/Docke…

步骤2：克隆 OpenClaw 仓库

#（macOS终端执行）
# 克隆 OpenClaw 仓库
git clone https://github.com/openclaw/openclaw.git

步骤3：自动引导设置脚本

#（macOS终端执行）
# 自动引导配置 API Key、生成访问令牌
# 在macOS用户目录下自动创建 ~/.openclaw 文件夹，用于存储 OpenClaw 的所有配置和数据。
# 同时默认的 Docker Compose 配置会将 macOS 的 ~/openclaw/workspace 目录挂载到容器内的工作目录
cd openclaw
bash scripts/docker/setup.sh

# bash docker-setup.sh这一条命令可以用下面这两条命令替换
# 区别是：前者是依赖文件的执行权限，安全性较低；后者是手动指定用bash解释器来运行脚本
# 第一步：添加可执行权限chmod +x docker-setup.sh
# 第二步：运行脚本./docker-setup.sh

步骤4：启动 OpenClaw 服务

#（macOS终端执行）
## 执行前，需确保 Docker 桌面软件（Docker Desktop）是运行状态

## 根据当前目录下的 docker-compose.yml 配置文件，在后台创建并启动所有定义的服务容器

# docker compose：Docker 的多容器管理工具（旧版命令为 docker-compose，带连字符）
# up：创建并启动服务
# -d：后台运行（detached mode）
docker compose up -d

步骤5：下载并安装 ClawX 客户端（macOS）

访问 ClawX 页面，根据 Mac 芯片类型下载对应版本（ClawX v0.4.3），双击运行进行安装

步骤6：在 ClawX 中连接 OpenClaw 服务

  1. 打开ClawX客户端，点击【设置】，鼠标向下滑动至【网关】：
  2. 关闭自动启动网关，并开启开发者模式；

  1. 点击左侧菜单栏设置下方的【_OpenClaw页面】，浏览器自动打开http://127.0.0.1:18789/页面，首次打开会报错：gateway connect failed: GatewayClientRequestError: unauthorized: gateway token mismatch (set gateway.remote.token to match gateway.auth.token)，是因为ClawX连接 Docker 里的 OpenClaw Gateway 服务被拒绝：
#（macOS终端执行）

docker compose exec openclaw-gateway openclaw devices approve --latest

步骤7：配置大模型API key

打开ClawX客户端，点击【模型】，选择AI提供商，这里以DeepSeek为例

步骤8：验证连接与测试对话

打开ClawX客户端，点击【新对话】，建立聊天对话窗口，输出文字，首次输入后会报错：

Agent failed before reply: Requested agent harness "codex" is not registered.Logs: openclaw logs --follow，是因为请求的智能体引擎 "codex" 未注册 / 未启用：

#（macOS终端执行）
# 将命令中的 openclaw-openclaw-gateway-1 替换为实际 OpenClaw 网关容器的名称或ID，可以通过 docker ps 命令查看
# -it：以交互模式打开容器（提供一个终端）
## 如果插件安装过程要你输入 yes 确认，或者要你输入密码，-it 能让它弹出一个输入框让你打字。
## 没有 -it 的话，程序会直接出错，因为它不知道去哪找你“说话”

docker exec -it openclaw-openclaw-gateway-1 openclaw plugins install npm:@openclaw/codex
docker compose restart

步骤9：关闭 OpenClaw 服务

在macOS终端输入docker compose down关闭服务，这时打开 Docker 客户端，openclaw-gateway服务和openclaw-gateway-cli服务已被停止。

avatar
文章
阅读
粉丝