OpenClaw小白安装教程来了!养成你的第一个龙虾��

最近 OpenClaw 太火了。

群聊里都在聊，文章都在发，但真正跑起来的没几个。

都倒在了安装这一步。

不是工具难。是没找对教程。这篇文章解决的就是这个问题。

一、OpenClaw 是什么？

OpenClaw 是一款开源个人 AI 智能体（Personal AI Agent）。核心优势：

• 本地部署：数据存在自己设备上，隐私零泄露

• 系统级执行：不只是聊天，真的能帮你干活

• 全渠道交互：支持飞书、Telegram、Discord、WhatsApp 等20+平台

能做什么？

• 整理文件、读论文写摘要、定时推送资讯

• 帮你查资料、筛邮件、管理日程

• 跨平台帮你处理各种事务

截至 2026 年 3 月：

• GitHub Star 突破 23 万+

• 支持 Windows/Mac/Linux/云服务器

二、前置要求

2.1 硬件配置

2.2 软件要求

2.3 系统要求

权限要求：Windows 需管理员 PowerShell，Mac/Linux 需 sudo 权限

2.4 关键凭证

你需要准备至少一个：AI 模型 API Key：

• 问问算力（推荐，国内可用、支持 Claude）

• MiniMax / Kimi / 智谱 GLM-4.5 / 通义千问（国产模型，国内直连）

• Claude / GPT-4（需代理）

聊天平台 Token：

• Telegram Bot Token（新手推荐）

• 飞书（国内推荐）

• WhatsApp / Discord / Slack（进阶用户）

三、准备工作：AI 模型

3.1 问问算力平台（强烈推荐）

这是破局同学自己的算力平台，支持 Claude，价格比官方便宜很多。注册地址：

https://breakout.wenwen-ai.com/console/token

开通步骤：

1. 注册登录 → 点击【令牌管理】→【添加令牌】

1. 设置名称，分组选择【特价分组】

1. 复制生成的令牌

配置代码：

{

"provider": "wenwen-ai-claude",

"base_url": "https://breakout.wenwen-ai.com",

"api": "anthropic-messages",

"api_key": "你的令牌",

"model": {

"id": "claude-sonnet-4-6",

"name": "Claude Sonnet 4.6"

}

}

3.2 其他模型平台

四、安装方式

方式一：云服务器部署（推荐新手）

如果你不想搞环境配置，只想快点用上，云服务器方式更适合你。

4.1.1 购买腾讯云服务器

Step 1：打开 

https://cloud.tencent.com/product/lighthouse

Step 2：选择【OpenClaw 龙虾】应用模板Step 3：选择地域（选最近的）和套餐

• 新手：35 元/月

• 老手：2 核 4G 以上

• 长期用建议买一年 188 元

Step 4：登录购买（需要实名认证）

4.1.2 配置飞书

Step 1：打开腾讯云后台 

https://console.cloud.tencent.com/lighthouse/instance/index

Step 2：进入服务器 → 应用管理Step 3：通道选择【飞书】→【快速配置】→【前往授权】Step 4：用飞书 App 扫二维码授权

方式二：Docker 部署（跨系统通用）

Docker 就像一个"打包箱"，把环境和依赖都装好，到哪都能跑。

4.2.1 环境准备

• 安装 Docker（验证：docker --version）

• Windows 用户需启用 WSL2：控制面板 → 程序 → 启用或关闭 Windows 功能 → 勾选"适用于 Linux 的 Windows 子系统"和"虚拟机平台"

4.2.2 拉取源码

git clone https://github.com/clawdbot/clawdbot.git

cd clawdbot

cp .env.example .env

4.2.3 配置

打开 .env文件，修改：

4.2.4 启动

docker-compose up -d --build

docker ps # 验证，显示"up"即成功

docker logs clawdbot # 查看日志排查报错

4.2.5 验证

打开浏览器访问http://localhost:8080，出现管理界面即成功。

方式三：一键脚本（Mac/Linux）

# 执行官方一键安装脚本

curl -fsSL https://clawd.bot/install.sh | bash

# 运行配置向导

clawdbot onboard --install-daemon

# 按向导提示完成：

# - 选择启动模式（推荐 QuickStart）

# - 输入 AI 模型 API Key

# - 选择聊天渠道并输入 Token

方式四：npm 安装（进阶用户）

# 1. 安装 Node.js 22+

nvm install 22

nvm use 22

# 2. 全局安装

npm install -g clawdbot@latest

# 或用 pnpm

pnpm add -g clawdbot@latest

# 3. 配置启动

clawdbot onboard

# 4. 启动网关

clawdbot gateway --port 18789 --verbose

五、聊天工具对接

5.1 Telegram 对接（最稳定）

Step 1：获取 Bot Token

1. 打开 Telegram，搜索 @BotFather

1. 发送 /newbot

1. 按提示输入机器人名称和用户名（需以 bot 结尾）

1. 收到 API 密钥，复制保存

Step 2：配置对接

编辑 .env（Docker）或 ~/.clawdbot/clawdbot.json（脚本安装）：

TELEGRAM_BOT_TOKEN="你的密钥"

Step 3：重启服务

# Docker 部署

docker-compose restart

# 脚本安装

clawdbot gateway restart

Step 4：验证Telegram 搜索你的机器人，发送 /start，收到欢迎语即成功。

5.2 飞书对接

Step 1：腾讯云后台 → 应用管理 → 飞书 → 快速配置Step 2：用飞书 App 扫二维码授权Step 3：自动配置成功

六、使用指南

6.1 常用指令示例

6.2 对接国产模型（智谱 GLM-4.5 为例）

Step 1：注册智谱 AI 平台，获取 API KeyStep 2：编辑配置文件 ~/.clawdbot/clawdbot.json：

{

"agents": {

"defaults": {

"model": { "primary": "glm/glm-4-plus" },

"models": { "glm-4-plus": { "alias":"智谱 GLM-4.5" } }

}

},

"models": {

"mode": "merge",

"providers": {

"glm": {

"baseUrl": "https://open.bigmodel.cn/api/paas/v4",

"apiKey":"你的智谱 API Key",

"api": "openai-completions",

"models": [

{

"id": "glm-4-plus",

"name": "GLM-4.5",

"contextWindow": 102400,

"maxTokens": 32000

}

]

}

}

}

}

Step 3：重启网关

clawdbot gateway restart

6.3 安装技能插件

Step 1：访问 

https://clawhub.com

下载插件Step 2：将插件文件放入 clawdbot/plugins目录Step 3：执行 clawdbot plugin install <插件名>激活

七、常见问题与解决方案

7.1 安装失败

7.2 功能异常

7.3 安全与稳定性

• 风险提示：OpenClaw 拥有系统级权限，禁止在主力电脑运行，建议使用闲置设备或云服务器

• 避免中断：设置电脑"永不睡眠"，WSL2 用户执行 wsl --shutdown避免后台耗电

• 成本优化：轻度使用选择国产模型（如 GLM-4.5），重度使用搭配 Claude Opus

八、下载路径汇总

四种安装方式：

根据你的情况选择。