Harness 与 Agent 工程 · AI研发与测试工程 · 2026-02-26

OpenClaw 本地安装完全指南,并打通Telegram

OpenClaw 本地安装指南:打造你的专属AI助手,轻松打通Telegram,实现自动化办公与生活管理。

核心内容:

  1. OpenClaw 的核心功能与架构解析
  2. 详细安装步骤与环境要求
  3. 安全使用建议与初始化配置

OpenClaw 是最近 AI 圈讨论度极高的开源项目,没有之一。它让你在自己的电脑上运行一个永不下线的 AI 助手,能收发消息、管理文件、执行命令,甚至替你刷邮件、管日历、写公众号等等。本文带你从零完成本地安装。

认识 OpenClaw:它不只是一个聊天机器人

OpenClaw(前身是 Clawdbot / Moltbot)是一个自托管的 AI Agent。

和 ChatGPT 这类工具不同,它不只是"回答问题"——它会真的去执行操作:打开终端跑命令、读写文件、调用 API、向你的 WhatsApp / Telegram / 飞书主动发消息。

它的架构分为两层:

支持的模型完全灵活——Claude、GPT-4o、Gemini、KIMI或者本地的 Ollama 模型都可以接入。

⚠️ 安装前必读:安全提示

OpenClaw 是一个高权限工具,能读写文件、执行系统命令,务必注意:

    1. 不要装在你的主力个人电脑上,尤其是存有工作数据、个人隐私的机器
    1. 推荐装在虚拟机、VPS 、闲置设备或专用设备上面。

环境要求

项目 要求
操作系统 macOS / Linux / Windows(推荐 WSL2)
Node.js 22+(关键,低版本会报错)
内存 建议 8GB+,最低 4GB
CPU 建议双核以上

此外,确保你的电脑可以科学上网

一键安装脚本(最快,推荐新手)

macOS / Linux

打开终端,粘贴以下命令:

curl -fsSL https://openclaw.ai/install.sh | bash

脚本会自动检测你的操作系统、验证 Node.js 版本,并启动引导向导。

加上 --install-daemon 参数可以将 OpenClaw 注册为后台服务(Linux 用 systemd,macOS 用 launchd),这样重启后它也会自动运行:

curl -fsSL https://openclaw.ai/install.sh | bash -s -- --install-daemon

Windows

以管理员身份打开 PowerShell,先设置执行策略:

Set-ExecutionPolicy RemoteSigned

然后粘贴官方安装命令(一行)并等待完成。

安装后:引导配置(onboarding)

安装完成后,运行引导向导进行初始化配置——这一步不能跳过:

openclaw onboard

向导会引导你完成以下配置:

    1. 选择 LLM:输入 Claude / GPT / Gemini/KIMI 的 API Key,或配置 Ollama 本地模型地址,如果没有国外的账号,建议你使用国内大模型。
    1. 选择消息平台:Telegram、WhatsApp、Discord、Slack 等,按提示完成 Bot 绑定

基础配置文件(config.yaml)

配置文件位于 ~/.openclaw/config.yaml,以下是关键字段:

server: host: "127.0.0.1" # ⚠️ 务必绑定到 localhost,不要用 0.0.0.0 port: 18789ai: model: "claude-sonnet-4-6" # 或 gpt-4o、llama3 等 max_tokens: 2048 temperature: 0.7exec: ask: "on" # 命令执行前需要用户确认platforms: telegram: enabled: true token: "YOUR_BOT_TOKEN" discord: enabled: false

修改后重启网关生效:

openclaw gateway restart

验证安装是否成功

## 检查版本openclaw --version# 健康检查(会自动检测配置问题)openclaw doctor# 查看网关状态openclaw gateway status# 打开浏览器 Dashboardopenclaw dashboar…
— 以上为试看内容(约 40%),开通会员后阅读全文 —

原文出处:https://www.53ai.com/news/Openclaw/2026022641693.html