OpenClaw（龙虾）本地部署指南：让你的聊天工具变成全能AI助手

你是不是也有过这种经历：想让AI帮你执行个命令、装个软件，结果它只会给你一堆文字说明，还得自己手动操作？

龙虾（OpenClaw）解决的就是这个问题——它不只是聊天，而是真的能操作你的电脑。装软件、跑命令、管理项目，它都能直接干。

更爽的是，你不需要专门下载什么App，微信、Telegram、Discord这些你已经在用的聊天工具，都能直接对接龙虾。随时随地发消息，它就帮你干活。

这篇教程带你从零开始，把龙虾部署到本地，体验真正的AI协作。

龙虾能干什么？

先说几个实际场景，你感受一下：

• 装依赖：跟它说"帮我在这个项目里装个Express"，它直接执行 npm install express，装完告诉你结果
• Git操作：说"把代码推到main分支"，它帮你 git add . && git commit && git push
• 文件管理：说"在桌面创建一个项目文件夹，初始化npm"，它照做
• 排查问题：代码报错了，把错误信息丢给它，它能直接看日志、改代码、重新跑

这些操作它都能在你的电脑上直接执行，不是给你教程让你自己来。

部署前的准备

在开始之前，确认你的环境满足这些条件：

• 操作系统：macOS、Linux 或 Windows（推荐 WSL2）
• Node.js：版本 18 或以上
• Git：需要安装 Git
• 一个聊天平台的账号：Telegram、Discord 或微信（任选一个）

检查一下 Node.js 版本：

node --version

如果版本低于 18，先升级：

# macOS（用 Homebrew）
brew upgrade node

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install -y nodejs

安装龙虾

龙虾提供了两种安装方式，选适合你的。

方式一：一键脚本（推荐新手）

一行命令搞定：

curl -fsSL https://get.openclaw.ai | bash

这个脚本会自动检测你的环境，下载最新版本，配置好基本设置。

为什么要用一键脚本？ 因为它帮你处理了依赖检查、路径配置这些容易出错的步骤。新手用这个最省心。

方式二：Git 克隆（适合想折腾的）

# 克隆仓库
git clone https://github.com/openclaw/openclaw.git

# 进入目录
cd openclaw

# 安装依赖
npm install

# 构建项目
npm run build

为什么用 Git 克隆？ 这样你可以随时拉取最新代码，也能自己修改源码。适合喜欢折腾、想深入了解内部原理的人。

初始化配置

安装完成后，运行初始化命令：

openclaw init

它会问你几个问题：

1. 选择 AI 模型：支持 Claude、GPT-4、本地模型等。先选一个你有 API Key 的
2. 配置 API Key：输入对应的密钥
3. 选择聊天平台：Telegram、Discord 或微信

以 Telegram 为例，你需要先去 @BotFather 创建一个 Bot，拿到 Token，然后填进去。

配置完成后，龙虾会在当前目录生成一个 .openclaw 配置文件夹。

启动龙虾

配置好了，直接启动：

openclaw start

看到类似这样的输出，说明启动成功：

🦞 OpenClaw v2.1.0 started
📡 Telegram bot connected
🖥️  Local executor ready
✅ Ready to serve!

现在打开你的 Telegram，找到你创建的 Bot，发一条消息试试：

帮我看看当前目录下有什么文件

龙虾会执行 ls -la，然后把结果发给你。

实际使用演示

场景一：快速初始化一个项目

你跟龙虾说：

在 ~/projects 目录下创建一个叫 my-app 的 React 项目，用 Vite

它会依次执行：

cd ~/projects
npm create vite@latest my-app -- --template react
cd my-app
npm install

然后回复你："项目创建好了，入口在 ~/projects/my-app，用 npm run dev 启动。"

场景二：Git 工作流

看看这个项目有没有未提交的改动，有的话提交一下，推到远程

龙虾执行：

git status
git add .
git commit -m "auto: save current changes"
git push origin main

每一步它都会告诉你执行结果。如果 push 失败（比如有冲突），它会把错误信息发给你，问你怎么处理。

场景三：排查问题

你的 Node.js 项目报错了，把错误信息发给龙虾：

运行 npm run dev 报这个错：Error: Cannot find module 'vite'

它会：

1. 检查 node_modules 是否存在
2. 如果没有，执行 npm install
3. 再跑一次 npm run dev 验证
4. 告诉你问题已解决

安全提醒

龙虾拥有你电脑的执行权限，这意味着它能做任何你能在终端里做的事。所以：

• 不要给它管理员权限运行，除非你明确知道在干什么
• 敏感操作要确认：在配置里开启"执行前确认"，这样删除文件、推送代码这类操作会让你先确认
• 别把 API Key 暴露出去：.openclaw 文件夹加到 .gitignore 里

在配置文件里可以设置安全级别：

{
  "security": {
    "confirmBeforeExecute": true,
    "blockedCommands": ["rm -rf /", "sudo"],
    "allowedDirectories": ["~/projects", "~/Desktop"]
  }
}

常见问题

Q：启动后 Telegram Bot 没反应？

检查 Bot Token 是否正确，网络是否能访问 Telegram API。国内用户可能需要配置代理：

export HTTPS_PROXY=http://127.0.0.1:7890
openclaw start

Q：执行命令时报权限错误？

可能是目录权限问题。不要用 sudo 启动龙虾，而是把工作目录的权限改对：

chmod -R 755 ~/projects

Q：想换一个 AI 模型怎么办？

重新运行初始化命令，或者直接改配置文件：

openclaw config set model gpt-4
openclaw config set apiKey sk-xxxxx

然后重启：

openclaw restart

Q：能同时连接多个聊天平台吗？

可以。在配置文件里添加多个平台的配置就行，龙虾会同时监听所有平台的消息。

下一步

部署完成后，你可以继续探索这些方向：

• 接入本地模型：用 Ollama 跑一个本地 LLM，这样就不用花钱调 API 了
• 自定义技能：教龙虾执行你常用的命令组合，比如一键部署、自动备份
• 团队协作：把龙虾部署到服务器上，团队成员都能通过聊天工具调用

龙虾的真正威力在于：它把"对话"和"执行"连起来了。你不再需要记住一堆命令，直接用人话告诉它要干什么就行。

有问题欢迎来龙虾官网 yitb.com 的社区提问，那里有一群热心的老哥等着帮你。