手把手教你安装 OpenClaw：让 AI 助手住进你的终端

一只会写代码的 AI 龙虾，就此诞生 🦞

前言

最近折腾了一个很有意思的项目 ------ OpenClaw，一个可以本地运行的 AI 助手框架。它不像普通的聊天机器人那样只能回答问题，而是真正能"住"在你的系统里，帮你写代码、管理文件、定时任务，甚至还能通过 WhatsApp/Telegram 跟你聊天。

这篇文章记录一下我在 macOS 上的完整安装过程，给想折腾的朋友做个参考。

环境准备

我用的是一台 Mac mini，系统环境如下：

bash 复制代码

# Node.js 版本
node --version
# v22.22.1

# npm 版本
npm --version
# 10.9.4

强烈建议用 nvm 管理 Node.js 版本，避免权限问题：

bash 复制代码

# 安装 nvm（如果还没有）
brew install nvm

# 安装最新 LTS 版本的 Node.js
nvm install --lts
nvm use --lts

安装 OpenClaw

一步到位，全局安装：

bash 复制代码

npm install -g openclaw

安装完成后验证：

bash 复制代码

openclaw --version
# OpenClaw 2026.3.11 (29dc654)

初始化工作区

安装完成后，OpenClaw 会自动创建一个工作区目录：

bash 复制代码

# 工作区位置
ls ~/.openclaw/workspace

第一次启动时，会看到一堆初始化文件：

bash 复制代码

├── AGENTS.md          # 助手的行为准则
├── SOUL.md            # 助手的"人格"设定
├── USER.md            # 关于你的信息
├── IDENTITY.md        # 助手的身份信息
├── BOOTSTRAP.md       # 首次启动引导文件
├── TOOLS.md           # 本地工具配置
└── HEARTBEAT.md       # 定时任务配置

启动 Gateway

OpenClaw 的核心是一个 Gateway 服务，负责调度 AI 任务和定时任务：

bash 复制代码

# 启动服务
openclaw gateway start

# 查看状态
openclaw gateway status

配置你的 AI 助手

第一次对话时，你需要和助手一起定义它的"身份"。我的选择是：

IDENTITY.md

markdown 复制代码

- **Name:** 龙虾 (Lobster)
- **Creature:** 被 Sam 养的 AI 龙虾 🦞
- **Vibe:** 钳子锋利，代码更锋利
- **Emoji:** 🦞

是的，我养了一只 AI 龙虾。它可以用这个身份跟你聊天，帮你干活。

连接聊天平台（可选）

OpenClaw 支持连接多个聊天平台：

bash 复制代码

openclaw whatsapp connect

会显示一个二维码，用手机 WhatsApp 扫描即可绑定。

bash 复制代码

openclaw telegram setup

按照提示在 BotFather 创建机器人，然后填入 Token。

开始使用

安装完成后，你就可以开始跟助手对话了：

erlang 复制代码

你：帮我写个 Python 脚本，批量重命名文件
龙虾：🦞 好的，马上来...

它可以直接操作你的工作区文件，执行 shell 命令（会先征求你同意），还能定时提醒你做事。

一些实用配置

定时任务（Cron）

在 HEARTBEAT.md 里添加定时检查任务，或者用 openclaw cron 命令创建更复杂的定时任务。

技能扩展

OpenClaw 支持技能系统，可以扩展各种功能：

bash 复制代码

# 查看可用技能
openclaw skills list

常见的技能包括天气查询、健康检查、技能创作等。

遇到的问题

❌ 错误 1：npm 安装时报 git 权限错误

错误信息：

perl 复制代码

npm ERR! code 128
npm ERR! An unknown git error occurred
npm ERR! command git --no-replace-objects ls-remote ssh://git@github.com/whiskeysockets/libsignal-node.git
npm ERR! git@github.com: Permission denied (publickey).
npm ERR! fatal: Could not read from remote repository.

原因：

使用了 sudo npm install -g openclaw
npm 在拉取某些依赖时尝试用 SSH 方式访问 GitHub，但你的机器没有配置 GitHub SSH Key

解决方案（三选一）：

方案 A：不要用 sudo（推荐）

bash 复制代码

# 如果你用 nvm 安装的 Node.js，不需要 sudo
npm install -g openclaw

方案 B：配置 npm 使用 HTTPS 而不是 SSH

bash 复制代码

# 临时解决（针对当前安装）
npm config set git-url "https://github.com/"

# 或者永久配置
echo 'git-url=https://github.com/' >> ~/.npmrc

# 然后重新安装
npm install -g openclaw

方案 C：配置 GitHub SSH Key

bash 复制代码

# 生成 SSH Key（如果还没有）
ssh-keygen -t ed25519 -C "your_email@example.com"

# 添加到 GitHub
cat ~/.ssh/id_ed25519.pub
# 复制输出内容，到 GitHub Settings → SSH and GPG keys → New SSH key

# 测试连接
ssh -T git@github.com

❌ 错误 2：权限问题

如果用系统自带的 Node.js 可能会有权限问题，需要 sudo 才能全局安装包。

解决方案： 用 nvm 管理 Node.js，避免权限问题。

❌ 错误 3：端口占用

Gateway 默认占用某个端口，如果冲突会启动失败。

解决方案： 修改配置文件中的端口设置。

❌ 错误 4：网络问题

某些功能需要访问外网 API（如天气查询、模型调用等）。

解决方案： 确保网络通畅，必要时配置代理。

总结

整个安装过程其实就几步：

bash 复制代码

# 1. 确保有 Node.js（推荐 nvm）
# 2. 全局安装
npm install -g openclaw

# 3. 启动 Gateway
openclaw gateway start

# 4. 开始聊天

OpenClaw 最有意思的地方在于它不是那种"用完即走"的工具，而是真的像一个住在你系统里的小助手。它有记忆、有身份、能主动提醒你事情，甚至还能跟你闲聊。

如果你也喜欢折腾这种本地 AI 助手，强烈推荐试试。养一只属于自己的 AI 宠物，让它帮你干活，这种感觉还挺奇妙的。

相关链接：

OpenClaw 官方文档：docs.openclaw.ai
GitHub: github.com/openclaw/op...
社区 Discord: discord.com/invite/claw...

本文基于 OpenClaw 2026.3.11 版本，后续版本可能有变化。