OpenClaw 安装指南：自托管 AI 网关安装、配置
打造您的私有数字副驾驶 | 支持 Telegram/Discord/飞书 + 国产大模型接入
1. 背景
在生成式人工智能从单纯的网页对话向能够执行复杂任务的Agent发展的浪潮下，很多项目都在涌现，包括被收购的Manus，不同于ChatGPT或Claude等依赖云端托管的SaaS服务，OpenClaw通过独特的Gateway-Node架构，将大模型的推理能力下沉至用户私有硬件，并通过标准化的协议连接至飞书、Telegram、Discord等主流即时通讯平台。
SaaS: Software as a Service（软件即服务）
OpenClaw提出了一种“自带设备（BYOD）”的运行模式，核心组件运行在用户控制的Mac Mini、Linux服务器或树莓派上，而将推理任务通过API外包给Claude Opus、GPT-4或本地开源模型。这种架构不仅确保了用户对记忆和数据的完全掌控，还赋予了AI深度访问本地文件系统、Shell和浏览器的能力，使其成为真正意义上的“数字副驾驶”。
1.1 名字变迁历史
Clawd诞生于2025年11月——这是“Claude”加上“爪子”的巧妙双关。一切都完美无缺，直到Anthropic的法务团队礼貌地要求我们重新考虑。好吧，这很合理。
Moltbot这个名字是接下来诞生的，它是在凌晨5点与社区成员在Discord上进行一场混乱的头脑风暴后选定的。蜕皮象征着成长——龙虾脱壳蜕皮，最终长成更大的生物。这个名字寓意深刻，但念起来却不太顺口。
OpenClaw 就是我们的最终归宿。这一次，我们做了充分的准备：商标检索结果清晰无误，域名已购买，迁移代码也已编写完成。这个名字恰如其分地概括了这个项目如今的面貌：
- 开放：开源，对所有人开放，社区驱动
- 龙虾爪：我们的龙虾传承，致敬我们的起源地
1.2 OpenClaw
OpenClaw 是一个开源的智能助手平台，它运行在您的计算机上，并可与您常用的聊天应用配合使用。无论您身在何处，WhatsApp、Telegram、Discord、Slack 还是 Teams，您的 AI 助手都会伴您左右。
与数据存储在他人服务器上的 SaaS 助手不同，OpenClaw 可以运行在您选择的任何地方——笔记本电脑、家庭实验室或 VPS。您的基础设施。您的密钥。您的数据。
1.3 OpenClaw能做什么？
- 跨平台通信网关
这是openclaw的底层，打破了AI助手的平台壁垒
- 飞书，电报，Discord，Slack，Teams，WhatsApp，Telegram，甚至您自己的自定义应用
- 统一的会话体验：无论你从哪个APP发送消息，openclaw都能维持在同一个会话上，记忆和身份保持一致，确保可跨平台交互的连贯性
- 媒体与语音支持：不仅支持文本，还可以接收和发送图片、文档、音频等多种媒体文；通过集成语音识别（如 Whisper）和语音合成（如 ElevenLabs）技术，你甚至可以直接与它进行语音对话。
- 主动提醒与定时任务
Cron Jobs：你可以用自然语言或直接配置 Cron 表达式来创建定时任务。例如，让它在每个工作日结束时自动提交代码，或在每周五生成周报草稿
外部触发器 (Webhooks)：OpenClaw 可以通过 Webhook 接收来自其他应用（如 GitHub， Zapier， IFTTT）的事件通知，并触发相应的自动化流程。例如，当 GitHub 有新的 PR 时，自动触发代码审查
- 完整的系统与浏览器访问能力
openclaw核心能力是能调用工具，授予了直接操作其所在设备的能力，从而能够真正完成工作
Shell 访问：OpenClaw 可以执行任意的 Shell 命令。这意味着它可以管理文件、运行脚本、安装软件、控制服
浏览器控制：通过与 Chrome/Chromium 浏览器的深度集成，OpenClaw 可以像人一样操作浏览器——访问网页、填写表单、点击按钮、抓取信息，甚至处理登录和支付流程。这使得网页自动化任务变得异常简单
文件系统读写：OpenClaw 对其工作区拥有完全的读写权限，可以创建、修改、分析本地文件，使其能够处理文档、管理项目、记录笔记
- 可扩展的技能与插件系统
和Claude Code一样，OpenClaw也支持插件和自定义技能，可以扩展其功能，实现更多复杂任务
社区驱动的能力市场 (OpenClawHub)：拥有一个活跃的社区技能市场，用户可以轻松安装如“日历管理”、“邮件收发”、“智能家居控制”、“Jira 任务跟踪”等数百种技能，即插即用
AI辅助的创建技能开发
多 Agent 协作：OpenClaw 支持配置多个具有不同角色、技能和权限的 Agent。你可以创建一个“代码专家” Agent，一个“日程管理” Agent，甚至让它们之间相互协作，将复杂任务分解执行
上述相关内容来自飞书网站
2. 安装
2.1 官网安装
运行引导式开箱向导（openclaw onboard）。它会引导您完成网关、工作区、频道和技能的设置。命令行向导是推荐的设置方式，可在 macOS、Linux 和 Windows 系统上运行（通过 WSL2；强烈推荐）
安装需要什么？Node 22+、您选择的提供商提供的 API 密钥，以及 5 分钟时间。
curl -fsSL https://openclaw.ai/install.sh | bash
npm i -g openclaw
openclaw onboard –install-daemon
curl -fsSL https://openclaw.ai/install.sh | bash -s – –install-method git
iwr -useb https://openclaw.ai/install.ps1 | iex
npm如果没有安装，可以参考brew install,尤其是国内的网络环境 但是用npm安装openclaw的时候还是需要稳定的网络，所以可以尝试国内版本
2.2 国内安装
有人把openclaw fork到国内，并做了很多优化，具体参考[https://clawd.org.cn/#install]
而且把openclaw做了汉化，加上了淘宝镜像源，可以使用下面的命令安装，如果你有稳定的网络条件还是建议安装原装
curl -fsSL https://clawd.org.cn/install.sh | bash -s – –registry https://registry.npmmirror.com
npm install -g openclaw-cn@latest –registry https://registry.npmmirror.com openclaw-cn onboard
2.3 启动设置
在安装好openclaw之后，需要启动openclaw的守护进程，守护进程既是基础的设置也是关键网关的设置
openclaw onboard --install-daemon- 阅读安全协议
▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄▄
██░▄▄▄░██░▄▄░██░▄▄▄██░▀██░██░▄▄▀██░████░▄▄▀██░███░██
██░███░██░▀▀░██░▄▄▄██░█░█░██░█████░████░▀▀░██░█░█░██
██░▀▀▀░██░█████░▀▀▀██░██▄░██░▀▀▄██░▀▀░█░██░██▄▀▄▀▄██
▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀▀
🦞 OPENCLAW 🦞
┌ OpenClaw onboarding
│
◇ Security ──────────────────────────────────────────────────────────────────────────────╮
│ openclaw security audit --deep │
│ openclaw security audit --fix │
│ │
│ Must read: https://docs.openclaw.ai/gateway/security │
│ │
├─────────────────────────────────────────────────────────────────────────────────────────╯
│
◆ I understand this is powerful and inherently risky. Continue?
│ ○ Yes / ● No
└- Onboarding Mode 新手引导模式
◆ Onboarding mode
│ ● QuickStart (Configure details later via openclaw configure.)
│ ○ Manual
└- 模式选择
自行选择合适的模式，上下键选择，Enter确定，需要自己确定模型
│
◆ Model/auth provider
│ ● OpenAI (Codex OAuth + API key)
│ ○ Anthropic
│ ○ MiniMax
│ ○ Moonshot AI
│ ○ Venice AI
│ ○ Skip for now
└选择合适的Model之后，输入Key API，会自动识别模型，自己确认模型的亚型即可
- 选择channel OpenClaw提供了多种app方式机器人
◆ Select channel (QuickStart)
│ ● Telegram (Bot API) (not configured)
│ ○ WhatsApp (QR link)
│ ○ Discord (Bot API)
│ ○ Google Chat (Chat API)
│ ○ Slack (Socket Mode)
│ ○ Signal (signal-cli)
│ ○ Skip for now
└选择Telgram作为主要app，按照提示操作即可
│
◇ Select channel (QuickStart)
│ Telegram (Bot API)
│
◇ Telegram bot token ───────────────────────────────────────────────────────────────────╮
│ │
│ 1) Open Telegram and chat with @BotFather │
│ 2) Run /newbot (or /mybots) │
│ 3) Copy the token (looks like 123456:ABC...) │
│ Tip: you can also set TELEGRAM_BOT_TOKEN in your env. │
│ Docs: https://docs.openclaw.ai/telegram │
│ Website: https://openclaw.ai │
│ - 在电报中搜索@BotFather
- 输入
/newbot命令 - 给机器人起个名字
- 得到API，复制输入行中即可
- 安装skills
◇ Preferred node manager for skill installs
│ npm
│
◆ Install missing skill dependencies
│ ◻ Skip for now (Continue without installing dependencies)
│ ◻ 🔐 1password
│ ◻ 📝 apple-notes
│ ◻ ⏰ apple-reminders
│ ◻ 🐻 bear-notes
自己选择合适的skills
- 等待网关的启动即可完成安装
2.4 入门指南
上述的安装过程，属于CLI新手引导向导(openclaw onboard),它会设置
- 模型/认证(推荐OAuth) 就是跳转到模型官网进行授权登录
- Gateway 网关设置
- 渠道(聊天软件等接入)
- 配对默认值(安全私信)
- 工作区引导+skills
- 可选的后台服务
沙箱注意事项：agents.defaults.sandbox.mode: “non-main” 使用 session.mainKey（默认 “main”），因此群组/渠道会话会被沙箱隔离。如果你想要主智能体始终在主机上运行，设置显式的每智能体覆盖：
{
"routing": {
"agents": {
"main": {
"workspace": "~/.openclaw/workspace",
"sandbox": { "mode": "off" }
}
}
}
}