🚀 龙虾新手指南

OpenClaw龙虾本地AI助手安装教程：支持Linux/macOS/Windows的开源多模态AI工具

发布时间：2026-04-17 分类：龙虾新手指南

摘要：龙虾新手指南：OpenClaw入门教程什么是“龙虾”“龙虾”是 OpenClaw 的代号，一个开源的本地 AI 助手。它不依赖云端服务，所有推理和处理都在你自己的机器上完成。名字取自龙虾——外壳坚硬（强调本地安全）、钳子灵活（支持多模态和插件扩展）、能适应不同环境（跨平台：Linux/macOS/Windows）。项目地址：https://github.com/yourusername/Op...

龙虾新手指南：OpenClaw入门教程

什么是“龙虾”

“龙虾”是 OpenClaw 的代号，一个开源的本地 AI 助手。它不依赖云端服务，所有推理和处理都在你自己的机器上完成。名字取自龙虾——外壳坚硬（强调本地安全）、钳子灵活（支持多模态和插件扩展）、能适应不同环境（跨平台：Linux/macOS/Windows）。

项目地址：https://github.com/yourusername/OpenClaw
（注：实际使用时请替换为真实仓库地址）

安装前确认

系统：Linux（Ubuntu 20.04+）、macOS（12+）、Windows 10/11
内存：最低 4GB，推荐 8GB+（尤其启用大模型时）
Python：3.8 或更高版本
Git：用于拉取代码

检查命令：

python3 --version  # 应输出 3.8.x 或更新
git --version        # 应输出 2.20+

如果缺失，从 python.org 和 git-scm.com 下载安装。

安装 OpenClaw

克隆代码并进入目录

git clone https://github.com/yourusername/OpenClaw.git
cd OpenClaw

创建并激活虚拟环境

python3 -m venv venv
# Linux/macOS：
source venv/bin/activate
# Windows：
venv\Scripts\activate

安装依赖

pip install -r requirements.txt

如果报错 torch 安装失败，先按 PyTorch 官网推荐方式安装对应 CUDA 版本的 torch（或 CPU 版），再重试。

运行配置脚本

python configure.py

它会提示你设置：

默认模型路径（可留空，用内置小模型快速启动）
本地知识库存储位置
是否启用多模态（需额外安装 transformers + Pillow）
API 密钥（仅限需要鉴权时；本地使用可跳过）

启动服务

python start_server.py

默认监听 http://localhost:5000。终端出现 INFO: Started server 即表示就绪。

验证是否跑通：

curl http://localhost:5000/api/v1/ping
# 返回：{"status": "pong", "version": "0.3.1"}

常用功能实操

文档摘要

传入一段文本，返回精炼摘要：

import requests

data = {"text": """
OpenClaw 是一个离线优先的 AI 助手框架。它支持文本理解、代码补全、图像描述等能力，
所有模型均可在消费级显卡或 CPU 上运行。设计目标是可控、可审计、不联网。
"""}

res = requests.post("http://localhost:5000/api/v1/summarize", json=data)
print(res.json()["summary"])
# 输出类似：OpenClaw 是离线优先的 AI 助手框架，支持文本、代码、图像处理，可在消费级硬件运行。

代码辅助

给一段不完整的函数，返回补全建议或优化提示：

import requests

data = {
    "code": "def calculate_tax(amount, rate):\n    return",
    "language": "python"
}

res = requests.post("http://localhost:5000/api/v1/code_assist", json=data)
print(res.json()["suggestions"][0])
# 输出类似：return amount * rate / 100

多模态指令（纯文本场景）

即使没图像，也能处理带上下文的自然语言指令：

import requests

data = {
    "input": "把下面这段 Markdown 转成 HTML：<h1>Hello</h1>",
    "type": "text"
}

res = requests.post("http://localhost:5000/api/v1/multimodal", json=data)
print(res.json()["response"])
# 输出：<h1>Hello</h1>

加载自定义插件

OpenClaw 的插件是标准 Python 模块，放在任意目录下，通过 --plugins 参数加载。

写一个简单插件

创建文件 plugins/weather.py：

def get_weather(city="Beijing"):
    # 实际项目中可对接本地天气 API 或 mock 数据
    return f"Weather in {city}: Sunny, 26°C"

启动时加载

python start_server.py --plugins plugins

插件函数会自动注册为 /api/v1/plugin/weather 端点，调用方式：

curl -X POST http://localhost:5000/api/v1/plugin/weather \
  -H "Content-Type: application/json" \
  -d '{"city": "Shanghai"}'

排查常见问题

现象	可能原因	解法
`pip install -r requirements.txt` 报 `torch` 缺失	系统未预装 PyTorch	先运行 `pip3 install torch torchvision torchaudio --index-url https://download.pytorch.org/whl/cpu`（CPU 版）或按官网选 CUDA 版
`start_server.py` 启动后立即退出	配置文件损坏或端口被占	查看终端最后一行错误；改端口：`python start_server.py --port 5001`；或 `lsof -i :5000`（macOS/Linux）/ `netstat -ano \	findstr :5000`（Windows）杀占用进程
插件调用返回 404	插件名含非法字符或未加 `.py` 后缀	插件文件名必须全小写、下划线分隔、以 `.py` 结尾（如 `my_tool.py` → `/api/v1/plugin/my_tool`）
摘要返回空或乱码	输入文本过短（<50 字）或含不可见控制符	用 `repr(text)` 检查输入，过滤 `\x00` 等二进制字符

下一步

API 文档在 http://localhost:5000/api/v1/docs（Swagger UI）
想换更大模型？把 models/ 目录替换成 GGUF 格式的 Llama 3 或 Qwen2 量化模型，再在 configure.py 中指定路径
想加图像理解？安装 pip install transformers Pillow，启用 --multimodal 启动参数，并传入 base64 编码图片

所有改动都不需要重新编译——OpenClaw 是纯 Python 实现，改完即生效。

返回首页