官方网站:http://openclaw.ai/ · 本站基于官网提供更快更易部署的中文教程与 GitHub 快装方案

Star FastOpenClaw
FastOpenClaw 快速一键安装OpenClaw官方教程百科

20 分钟拥有 24/7 AI 私人助理:OpenClaw 从零部署完全指南

2026-03-02

#OpenClaw#AI助手#自托管#Telegram Bot#部署教程

想象一下这个场景:

你在手机上给 Telegram 发一条消息:“帮我把今天的工作日志写一下,然后发到 Notion。”

30 秒后,你的 Mac mini 自动完成了以下操作:

  1. 读取了今天你改过的所有文件
  2. 生成了一份结构化的工作日志
  3. 推送到了 Notion 的指定页面
  4. 回复你:“日志已写好并推送到 Notion,链接在此。”

这不是 ChatGPT。这是 OpenClaw——一个运行在你自己电脑上的 AI 私人助理。


OpenClaw 是什么?

一句话:你自己托管的 AI 助手,通过聊天软件控制你的电脑。

特性说明
自托管运行在你的电脑/服务器上,数据不离开你的设备
多渠道Telegram、Discord、WhatsApp、Slack、微信、iMessage、Teams
多模型支持阿里通义千问、OpenAI、Claude、Gemini、本地 Ollama
可扩展3000+ 技能插件(ClawHub 市场)
24/7安装为系统服务后,开机自动运行

你可以用 Telegram 让它帮你写代码、搜索资料、管理文件、操作终端、发 Notion、写日报、做数据分析——任何你在电脑终端里能做的事


准备工作

在开始之前,你需要:

  • 一台常开的电脑(Mac / Linux / Windows,推荐 Mac mini)
  • Node.js 22 或更高版本
  • 一个 AI 模型的 API Key(推荐通义千问,免费额度大)
  • 一个 Telegram 账号(或其他聊天平台)

检查 Node.js 版本

node --version
# 需要 v22.0.0 或更高

如果没装或版本太低:

# macOS (Homebrew)
brew install node@22

# 或使用 nvm
nvm install 22
nvm use 22

获取 AI API Key

推荐使用阿里云通义千问(国内访问稳定,免费额度充足):

  1. 访问 百炼控制台
  2. 创建 API Key(格式:sk-xxxxxxxx
  3. 记下来,等下要用

注意:这里要的是百炼 API Key,不是阿里云主账号 AccessKey!格式是 sk- 开头的。


步骤 1:安装 OpenClaw(2 分钟)

npm install -g openclaw@latest

验证安装:

openclaw --version
# 应显示 v2026.x.x

步骤 2:运行安装向导(5 分钟)

openclaw onboard --install-daemon

这个命令会启动一个交互式向导,引导你完成:

  1. 创建工作区:在 ~/.openclaw/ 下生成配置文件
  2. 选择 AI 模型:输入你的 API Key 和模型名
  3. 连接聊天渠道:扫码/Token 连接 Telegram 等
  4. 安装为系统服务:开机自动启动(macOS 用 launchd,Linux 用 systemd)

模型配置建议

场景推荐模型说明
日常对话qwen3.5-flash快速、便宜、够用
写代码qwen3-coder-plus代码专用,质量更高
深度分析qwen3.5-plus最强推理,适合复杂任务
离线/免费ollama/qwen3:8b本地运行,零成本

步骤 3:连接 Telegram(3 分钟)

创建 Telegram Bot

  1. 在 Telegram 搜索 @BotFather
  2. 发送 /newbot
  3. 给你的 Bot 取名(比如 “我的AI助手”)
  4. 获得 Bot Token(格式:123456:ABCdefGhIjKlMnO...

配置连接

在 OpenClaw 向导中选择 Telegram,粘贴 Bot Token。或手动编辑配置:

# 编辑配置文件
nano ~/.openclaw/openclaw.json

找到 Telegram 配置段,确保包含:

{
  "channels": {
    "telegram": {
      "enabled": true,
      "token": "你的Bot Token",
      "allowedUsers": ["你的Telegram用户ID"]
    }
  }
}

获取你的 Telegram 用户 ID:给 @userinfobot 发任意消息,它会回复你的 ID。


步骤 4:安装技能插件(5 分钟)

OpenClaw 的强大在于它的技能系统。ClawHub 市场有 3000+ 技能。

必装技能

# 搜索技能
openclaw skill search "搜索"

# 安装推荐技能
openclaw skill install multi-search-engine   # 17个搜索引擎
openclaw skill install notion-push           # Notion 推送
openclaw skill install summarize             # 内容摘要
openclaw skill install github                # GitHub 集成
openclaw skill install weather               # 天气查询

查看已安装技能

openclaw skill list

步骤 5:验证一切正常(2 分钟)

检查 Gateway 状态

openclaw status
# 应显示 "Gateway: running"

发送测试消息

打开 Telegram,给你的 Bot 发:

你好!请告诉我现在的时间和天气。

如果一切正常,Bot 会在几秒内回复。

常见问题快速排查

问题原因解决
Bot 不回复Gateway 没启动openclaw gateway start
API 401 错误API Key 错误检查 openclaw.json 中的 key
响应很慢模型选择太重换成 flash 模型
技能不工作未安装/未启用openclaw skill list 检查

日常使用:你可以让它做什么?

配置完成后,以下是一些实际使用场景:

🔍 智能搜索

搜索一下"2026年最好的静态网站生成器",给我前5名的对比

📝 写作助手

帮我写一份项目周报,重点说这周完成的3个功能和下周计划

💻 终端操作

帮我看看 ~/projects/ 下哪些 git 仓库有未提交的更改

📊 数据分析

读取 ~/data/sales.csv,分析上个月的销售趋势

🔔 定时任务

OpenClaw 支持 Cron 定时任务:

{
  "cron": {
    "daily-report": {
      "schedule": "0 23 * * *",
      "prompt": "总结今天的工作,生成日报并推送到 Notion"
    }
  }
}

每晚 11 点,AI 自动帮你写日报。


进阶:用 Claude Code / Codex 帮你部署

如果你觉得上面的手动步骤太麻烦,有一个更快的方式:

方法 A:让 Claude Code 帮你装

打开终端,运行 Claude Code,然后说:

帮我安装 OpenClaw。我要连接 Telegram,用阿里云通义千问的 API。
我的 API Key 是 sk-xxx,Telegram Bot Token 是 xxx。
帮我装好并配置成系统服务,开机自动启动。

Claude Code 会自动执行所有安装命令、编辑配置文件、启动服务。你只需要提供 Key 和 Token。

方法 B:让 Codex CLI 帮你装

codex "安装 OpenClaw,连接 Telegram bot token xxx,
使用阿里云 qwen3.5-flash 模型,API key sk-xxx,
安装为 launchd 服务"

方法 C:Docker 一键部署

如果你更喜欢 Docker:

# 下载 docker-compose 配置
curl -O https://raw.githubusercontent.com/openclaw/openclaw/main/docker-compose.yml

# 编辑环境变量
cp .env.example .env
nano .env  # 填入 API Key 和 Bot Token

# 启动
docker compose up -d

成本分析

项目月成本
OpenClaw 软件免费(开源)
通义千问 Flash大部分免费(每月 100 万 token 免费)
通义千问 Plus~¥10-30/月(按用量计费)
Telegram Bot免费
电费(Mac mini 24/7)~¥15-30/月
合计¥15-60/月

对比 ChatGPT Plus 的 $20/月(~¥145/月),OpenClaw 的方案便宜 3-10 倍,而且数据完全掌握在你手里。


写在最后

OpenClaw 的本质是:把你的电脑变成一个 AI 驱动的私人助理

你不需要打开网页,不需要切换应用,不需要记住复杂的命令。你只需要像跟朋友发消息一样,告诉它你需要什么。

它会帮你搜索、写作、编程、管文件、发通知、做分析、写日报——而且 24 小时待命。

开始安装:npm install -g openclaw@latest && openclaw onboard --install-daemon