OpenClaw龙虾安装教程

OpenClaw 是一款目前在 GitHub 上极为火爆的开源全能个人 AI 助手。它可以在本地运行，连接你的各类聊天工具（WhatsApp、Telegram、Slack、微信网页版等），并能自动化处理日程、邮件甚至终端指令。

⚠️ 极其重要的安全警告：
由于 OpenClaw 拥有极高权限（可读取文件、执行终端命令），且其社区插件市场（Claw Hub）近期曾被安全研究人员查出包含恶意插件，强烈建议：

1. 千万不要将其网关端口（默认 18789）直接暴露在公网。
2. 谨慎安装第三方未知技能（Skills/Plugins）。
3. 推荐将其安装在沙箱、虚拟机、Docker 或 WSL2 容器中，以实现系统隔离。

安装

以下是官方推荐的详细安装与配置教程：官方文档

---

环境准备 (前提条件)

1. 操作系统：macOS、Linux。如果你使用的是 Windows 系统，强烈建议通过 WSL2 (Windows Subsystem for Linux) 运行。
2. 运行环境：必须安装 Node.js ≥ 22。
3. 包管理器：推荐使用 npm 或 pnpm。

---

标准安装方法（官方推荐，最快捷）

如果你只是一名普通用户想要使用它，请遵循此步骤。

1. 全局安装 OpenClaw
打开终端（Mac/Linux Terminal 或 Windows WSL2），运行以下命令之一：

# 使用 npm 安装
npm install -g openclaw@latest

# 或使用 pnpm 安装
pnpm add -g openclaw@latest

启动/停止 Gateway

# 启动 Gateway（默认端口 18789）
openclaw gateway start

# 自定义端口启动
openclaw gateway start --port 19000

# 强制启动（杀死占用进程）
openclaw gateway start --force

# 停止 Gateway
openclaw gateway stop

# 重启 Gateway
openclaw gateway restart

# 查看运行状态
openclaw gateway status

# 重新配置
openclaw config

初始化

初始化向导

• 直接在本地打开图形化控制台界面：

-- 直接在本地打开图形化控制台界面
openclaw onboard

-- 添加 `--install-daemon` 参数可以将其注册为后台守护进程（Mac 下的 launchd 或 Linux 下的 systemd），确保它 24 小时随时待命：
openclaw onboard --install-daemon

• 第一步选择yes

• 第二步选择快速开始

• 第三步选择模型供应商：我这里选择MiniMax，由于OpenClaw比较消耗token，我们选择CodingPlan来进行对接（按次数计费，大家可以根据自己的需求购买），我目前选择的是MiniMax按月的Starte版本的先体验一下
  • MiniMax auth method选择：MiniMax OAuth
  • Select MiniMax endpoint选择：CN
  • 会跳转到MiniMax 网页授权页面：点击授权
  • Default model选择：Keep current (minimax-portal/MiniMax-M2.5)

• 第四步选择聊天工具：选择先跳过

• 第五步选择技能Skill工具：也选择先跳过，详见：Skills安装

• 最后选择： Open the Web UI

• 访问页面：打个招呼，如果能够正常回答，那么我们的初始化完成

调整Tool权限

• 让openclaw有调用所有工具的权限

---

基本原理

工作目录介绍

• 用户可以进行openclaw对应的文件夹：Mac电脑对应的是 ~/.openclaw/workspace

Skills安装

• Skills是技能包，能够让AI快速的掌握各种能力

从内置的技能安装

官方的skills市场clawhub

• OpenClaw官方市场访问地址：https://clawhub.ai/skills?sort=downloads clawhub目前有16000多skill，我们尽量选择star数量高的

• 直接对话输入安装：https://clawhub.ai/gpyAngyoujun/multi-search-engine 把这个skill安装一下，安装一下multi-search搜索功能,安装成功会提示

• github市场：awesome-claude-skills：https://github.com/ComposioHQ/awesome-claude-skills

安装完成！✅

**Multi Search Engine v2.0.1** 已安装到 `~/.nvm/versions/node/v25.8.0/lib/node_modules/openclaw/skills/multi-search`

这是一个多搜索引擎整合，包含：
- **国内 (8)：** 百度、Bing CN、360、搜狗、微信搜索、头条搜索、即时路透
- **国际 (9)：** Google、Google HK、DuckDuckGo、Yahoo、Startpage、Brave、Ecosia、Qwant、WolframAlpha

**特点：** 不需要 API key，直接用 `web_fetch` 调用搜索 URL。

不过需要注意：这个 skill 本质上是URL模板，搜索引擎可能有反爬措施，直接抓取可能效果不好。tavily-search 更适合 AI 搜索场景。

心跳机制

1. 读取HEARTBEAT.md中的任务清单，心跳机制（有完整上下文历史）
2. 逐项检查
3. 有需要通知你的事情就发送消息

简单使用

常用命令与交互方式

安装完毕后，你可以不依赖任何聊天软件，直接在终端里与它互动：

1. 派发日常任务 (Agent 模式)
可以直接在命令行让它做事，并指定模型的“思考深度”：

openclaw agent --message "帮我整理今天的行程清单，并检查我是否有未读的重要邮件" --thinking high

2. 通过网关发消息

openclaw message send --to +1234567890 --message "你好，这是来自 OpenClaw 的测试消息"

3. 安全与状态体检 (Doctor)
内置了安全排查和环境检查工具，随时运行此命令来排查报错或潜在的安全风险：

openclaw doctor

4. 版本升级
OpenClaw 迭代极快，随时保持最新以获取最新的安全补丁：

npm install -g openclaw@latest
openclaw update --channel stable

---

💡 萌新避坑指南

1. 文件访问权限：OpenClaw 会主动索引并“记忆”上下文。建议初次使用时专门给它建立一个工作文件夹，而不是直接将电脑的“根目录”或包含所有私钥的目录授权给它。
2. 警惕幻觉与不可控操作：由于 OpenClaw 是一个“行动派（Autonomous AI Agent）”，它会主动发消息和写文件。早期建议通过控制台观察它的决策过程（Reasoning Layer），不要一上来就让它接管你的主邮箱发送权限。