OpenClaw(小龙虾)本地部署安装和使用教程
作者:厦门大学大数据教学团队
联系人:厦门大学计算机系林子雨副教授 ziyulin@xmu.edu.cn
适用对象:本教程适合具备计算机专业知识的群体,不适合普通社会大众。
一、OpenClaw介绍
OpenClaw(社区俗称“小龙虾”)是一款本地优先、开源、跨平台的AI智能体执行框架,核心是让大模型从“聊天建议”升级为能在电脑端自主完成系统级任务的“数字员工”。它打通了大模型与本地系统/外部工具的壁垒,实现“指令→决策→执行→反馈”的完整闭环。
1. 项目背景与定位
•创始人:奥地利资深程序员 Peter Steinberger(知名PDF工具PSPDFKit创始人)。
•发展历程:
○2024年初:以 Clawdbot 为名启动。
○2025年11月:更名为 Moltbot 并在GitHub首发。
○2026年1月30日:正式定名 OpenClaw。
•开源协议:MIT,完全免费、可自托管、可二次开发。
核心定位:模型无关的AI执行中枢,连接大模型与本地系统/外部工具,实现自主任务执行。
2. 核心理念与核心特性
核心理念
•本地优先(Local-First):引擎、数据、日志均存储于自有设备,敏感数据不出内网,隐私与合规性极强。
•模型无关(Model-Agnostic):兼容GPT、Claude、Llama、Kimi、Ollama等几乎所有主流大模型,自由切换、灵活组合。
•行动优先(Action-Oriented):从“给建议”到“替你干”,直接操作电脑、执行命令、完成真实任务。
•高度可扩展(Highly Extensible):通过技能(Skills)插件系统无限扩展能力,社区共建生态。
核心特性
•本地部署,隐私可控:自托管运行,数据完全自主掌控。
•持续运行,后台值守:24/7后台执行,可在用户离线时处理任务。
•多渠道交互:支持WhatsApp、Telegram、Slack、飞书、钉钉、微信等50+通讯平台,“聊天即操作”。
•强大执行能力:支持文件读写、脚本执行、浏览器自动化、API调用、多步骤任务链编排,深度操作系统。
•视觉理解能力:具备截图、OCR、屏幕理解能力,可操作任何图形界面应用,打破“API孤岛”。
•持久记忆系统:拥有长期记忆与偏好学习能力,越用越懂你。
SOUL.md人格系统:可自定义AI的性格、语气、行为准则。
3. 技术架构(三层核心)
OpenClaw采用中心辐射式架构,解耦交互、推理与执行,稳定性与扩展性极强。
•Gateway(网关层)
消息路由中枢,统一对接所有交互入口(IM、WebUI、CLI、API)。
负责指令接收、分发、结果返回与多平台消息格式转换。
•Agent(智能体大脑)
核心决策引擎,基于大模型将自然语言指令拆解为可执行步骤。
负责任务规划、异常处理、上下文管理与记忆调用。
支持多模型自动切换与负载均衡。
•Skills(技能执行层)
执行“抓手”,所有实际操作均由技能插件完成。
社区已贡献5700+技能,涵盖文件管理、邮件自动化、PPT生成、网页爬虫、智能家居控制等。
用户可一键安装或用Markdown自定义开发。
4. 核心能力与应用场景
•个人效率提升
文件与系统管理:自动整理下载目录、批量重命名、备份文件、执行Shell命令、安装软件。
浏览器自动化:自动登录、填写表单、抓取数据、监控价格、总结网页内容。
文档处理:撰写/修改文档、生成摘要、从PDF/Excel提取并分析数据。
生活助理:制定计划、整理笔记、查询资料、生成复习提纲。
•团队协作与办公自动化
智能客服:在群聊中自动回答FAQ,复杂问题转接人工。
流程自动化:定时抓取业务数据生成报表并邮件发送、自动审核简单审批单。
会议助手:自动整理会议纪要、生成周报、同步群聊关键信息至文档。
•开发者与DevOps
代码辅助:自动生成代码、运行测试、部署项目、监控服务器状态。
运维自动化:日志分析、故障排查、定时任务、服务器巡检。
5. 与传统AI助手的核心区别
| 特性 | 传统对话AI(如ChatGPT) | OpenClaw |
|---|---|---|
| 核心能力 | 生成文本、提供建议 | 理解指令、自主执行、完成任务 |
| 运行环境 | 云端 | 本地/私有云,数据可控 |
| 交互方式 | 专用客户端/网页 | 日常IM工具(聊天即操作) |
| 系统操作 | 无法直接操作电脑 | 深度控制文件、终端、浏览器、GUI |
| 扩展性 | 有限API集成 | 无限技能插件,社区共建 |
| 隐私性 | 数据上传云端 | 数据本地存储,隐私安全 |
6. 生态与社区
•GitHub:星标数24.7万+(截至2026年3月),活跃度极高。
•ClawHub:官方技能市场,海量社区贡献的开箱即用技能。
•社区:全球开发者活跃,文档、教程、插件丰富,支持快速落地。
OpenClaw是AI从“对话”走向“行动”的里程碑式工具。它以本地优先、模型无关、行动驱动为核心,为个人和企业提供了一个完全自主可控、能力无限扩展的AI数字员工平台,正在重新定义AI的生产力边界。
二、OpenClaw安装
部分云厂商(比如腾讯云、阿里云)提供了云端一键部署小龙虾服务,帮你一键安装部署小龙虾,则你不需要参考本教程。本教程假设你租赁了云服务器,只安装了Linux系统,还没有安装小龙虾。
1. 安装Linux系统
这里使用云端的远程服务器,采用“全量安装到宿主机(Host)” 这一方式,具体操作方法详见:OpenClaw Linux 部署教程(Host 版)2026.03.12(教程网址https://my.feishu.cn/wiki/AJzRwAWbfiH2XvkoUqncdykgndd),视频教程链接:https://www.bilibili.com/video/BV1t9fLBBEGc/?spm_id_from=333.1391.0.0&vd_source=125e5c2d72fdfa36ea9c352fd5cf8161
云端的Linux系统部署完成以后,需要执行如下命令激活OpenClaw:

2. 安装基础工具
2.1 安装 curl、git

2.2 安装 nvm

2.3 安装 node

2.4 安装 openclaw

三、注册飞书机器人
3.1 端到端使用(一键部署,限时免费)
1.打开网页飞书(飞书官网)直接推送
2.点击创建,当前有免费token额度。

3.2 自行注册使用
1.进入飞书开发者后台
2.点击【创建企业自建应用】按钮
3.根据想要的类型自行创建

4.进入openclaw官网复制 可以一键导入权限的代码(JSON),并按照其要求导入到【开发配置 > 权限管理】

5.点击左侧菜单【基础信息 > 凭证与基础信息】,在页面的右侧可以看见 应用凭证 ,包括 App ID 和 App Secret。
6.需要获得相应key(前往openrouter 官网,邮箱注册即可获得),建议先使用飞书的限时免费版本。
7.根据模版填写信息,在终端上运行。
mkdir -p ~/.openclaw && cat > ~/.openclaw/openclaw.json << 'EOF'
{
"env": {
"OPENROUTER_API_KEY": "请你将本教程 3.3节 步骤2 的 openrouter 的 Your new key 复制到这里"
},
"auth": {
"profiles": {
"openrouter:default": {
"provider": "openrouter",
"mode": "api_key"
}
}
},
"agents": {
"defaults": {
"model": {
"primary": "openrouter/openrouter/free"
}
}
},
"channels": {
"feishu": {
"enabled": true,
"accounts": {
"main": {
"appId": "请你将本教程 3.2节 步骤9 的 飞书 的 APP ID 复制到这里",
"appSecret": "请你将本教程 3.2节 步骤9 的 飞书 的 App Secret 复制到这里"
}
}
}
},
"plugins": {
"entries": {
"feishu": {
"enabled": true
}
}
},
"gateway": {
"mode": "local"
}
}
EOF
openclaw doctor --fix
openclaw gateway stop
看到以下信息时openclaw启动完成,接下来继续注册机器人。

8.点击【开发配置 > 事件与回调】,【添加事件】按钮,

9.点击【应用发布 > 版本管理与发布】,点击页面右侧【创建
版本】

10.创建完成后,在终端执行:
openclaw pairing list feishu
openclaw pairing approve feishu 你的授权码

至此完成,可以直接和龙虾交互。
四、应用
在手机端直接同龙虾交流协作

