OpenClaw(AI小龙虾)到底是什么

OpenClaw最近非常火，啥意思，一头雾水，今天就抛砖引玉的简单聊聊。

OpenClaw（AI小龙虾）是本地优先、开源免费的AI执行助手，用自然语言指挥电脑干活，不泄露隐私。

一、先搞懂：OpenClaw 是什么

- 定位：AI执行网关，连接大模型与你的电脑，让AI真动手操作

- 能干啥：文件管理、浏览器自动化、系统命令、办公整理、批量处理

- 优势：本地运行、隐私安全、全平台兼容、零代码、可扩展

- 系统要求：macOS/Linux/Windows(WSL2)、Node.js≥22、内存≥8GB

二、环境准备（必做）

1. 安装 Node.js 22+（核心依赖）

Windows（WSL2推荐）# 安装nvm curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash source ~/.bashrc # 安装并使用Node.js 22 nvm install 22 nvm use 22 # 验证 node -v  # 输出v22.x.x

macOS# 用Homebrew brew install node@22 # 或nvm（推荐） curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash source ~/.zshrc nvm install 22 nvm use 22 node -v

2. 准备API密钥（二选一）

- 官方API（稳定）：OpenAI、Anthropic Claude、Kimi、Minimax、GLM等

- 本地模型（免费）：Ollama（Llama3、Qwen等），无需API Key

三、安装OpenClaw（2种方式）

方式1：一键脚本（小白首选）# macOS/Linux/WSL2 curl -fsSL https://openclaw.ai/install.sh | bash

- 自动装Node.js 22+、OpenClaw、依赖，全程无需干预

方式2：npm手动安装（推荐）# 全局安装 npm install -g openclaw@latest # 或pnpm（更快） pnpm add -g openclaw@latest # 验证安装 openclaw --version  # 输出版本号即成功

四、初始化配置（最关键）# 运行引导向导+安装后台服务（必加--install-daemon） openclaw onboard --install-daemon

向导步骤（跟着选）

1.风险确认：输入  yes  继续（法律声明）

2.配置模式：选  quickstart （新手推荐）

3.模型提供商：选你有Key的（如OpenAI、Claude、Ollama）

4.输入API密钥：粘贴你的Key（本地模型跳过） 

5.工作区：默认  ~/.openclaw/workspace  即可 

6.网关端口：默认  18789  即可 

7.消息渠道：新手先选  skip （后续再配）

8.守护进程：选  yes  开机自启

五、启动与验证

1. 检查服务状态# 查看网关状态 opencl gateway status # 健康检查 opencl health

- 显示 running  即正常

2. 访问Web控制面板（最友好）# 打开控制面板 opencl dashboard

- 浏览器自动打开：http://127.0.0.1:18789 

- 用向导生成的Token登录（或 opencl config get gateway.auth.token  获取）

- 发送：你好，介绍一下自己→ 正常回复即成功

六、基础使用（3种方式）

1. Web面板（推荐小白）

- 直接在聊天框发指令，可视化操作，无需记命令

2. 命令行（高效）# 基础对话 opencl agent --message "帮我整理桌面文件" # 指定模型 opencl agent --message "写Python代码" --model openai/gpt-4 # 深度思考（复杂任务） opencl agent --message "分析数据并生成报告" --thinking high

3. 聊天软件（远程控制）# 示例：Telegram opencl channels login telegram # 扫码登录后，直接发消息给机器人

支持：Telegram、Discord、WhatsApp、iMessage、飞书、钉钉等 

七、常用命令速查# 版本/状态 opencl --version opencl status opencl health  # 网关管理 opencl gateway start/stop/restart/status  # 会话/记忆 opencl sessions list opencl memory clear  # 技能管理 opencl skills list opencl skills install 技能名  # 配置 opencl config list opencl config set 配置项 值

八、实战案例（小白必试）

案例1：文件整理帮我把桌面所有PDF文件移动到~/Documents/PDF文件夹，并按日期重命名

案例2：浏览器自动化打开Chrome，搜索OpenClaw教程，打开前3个结果并保存为PDF

案例3：系统操作清理系统垃圾，关闭后台无用进程，优化电脑速度

案例4：办公辅助读取~/Downloads/报表.xlsx，汇总数据并生成图表，保存为图片

九、常见问题与排错

1. command not found

- 重启终端

- 检查npm全局路径：npm prefix -g ，将bin目录加入PATH

2. 安装失败

- 网络问题：换源或科学上网

- 权限问题：macOS/Linux加sudo，Windows用管理员终端

3. API Key无效

- 检查Key是否正确、是否有余额、是否开启对应模型权限

4. 本地模型（Ollama）配置# 安装Ollama curl -fsSL https://ollama.com/install.sh | sh # 拉取模型 ollama pull llama3 # OpenClaw中选择Ollama作为提供商

十、进阶玩法（后续学习）

- 技能开发：编写自定义技能，扩展OpenClaw能力

- 多智能体：创建多个Agent分工协作

- 远程访问：用Tailscale实现外网访问本地OpenClaw 

- 插件系统：安装第三方插件增强功能

十一、官方资源

- 中文文档：https://docs.openclaw.ai/zh-CN 

- 官方博客：https://openclaws.io/zh/blog 

- GitHub：https://github.com/openclaw/openclaw