方式一一键安装脚本推荐macOS / Linux / WSL2curl-fsSLhttps://openclaw.ai/install.sh|bashWindows PowerShelliwr-usebhttps://openclaw.ai/install.ps1|iex如果只想安装、不立即进入向导curl-fsSLhttps://openclaw.ai/install.sh|bash-s-- --no-onboard方式二npm 手动安装确保 Node.js 22node--version全局安装 OpenClawnpminstall-gopenclawlatest# 运行配置向导同时安装守护进程openclaw onboard --install-daemon方式三Docker 部署dockerpull openclaw/openclaw:latestdockerrun-d\--nameopenclaw\-p18789:18789\-v~/.openclaw:/root/.openclaw\-eANTHROPIC_API_KEYsk-ant-xxx\openclaw/openclaw:latest安装后验证openclaw--versionopenclaw doctor openclaw gateway status openclaw dashboard一个对照表格展示每个选项支持的厂商选项支持的厂商/模型OpenAIOpenAIGPT-4、GPT-3.5 等系列模型AnthropicAnthropicClaude 系列模型Chutes需要查询具体文档MiniMaxMiniMaxABAB 系列模型、语音模型等Moonshot AI (Kimi K2.5)月之暗面Kimi 系列模型GoogleGoogleGemini、PaLM 等模型xAI (Grok)xAIGrok 系列模型Mistral AIMistral AIMistral、Mixtral 等模型Volcano Engine字节跳动火山引擎豆包系列模型BytePlus字节跳动 BytePlusAI 服务套件OpenRouterOpenRouter聚合多厂商模型接口Kilo Gateway需要查询具体文档Qwen阿里云通义千问系列模型Z.AI知乎知海图 AI 模型Qianfan百度智能云千帆平台文心一言等模型Alibaba Cloud Model Studio阿里云模型服务平台含通义千问等CopilotGitHub Copilot / Microsoft Copilot 相关服务Vercel AI GatewayVercel AI Gateway聚合多厂商模型接口OpenCode需要查询具体文档Xiaomi小米MiLM 小爱同学系列模型Synthetic需要查询具体文档Together AITogether AI聚合多种开源模型Hugging FaceHugging FaceHugging Face Hub 上的模型Venice AIVenice AI隐私优先的 AI 服务LiteLLMLiteLLM聚合多厂商模型接口Cloudflare AI Gateway聚合多厂商OpenAI、Anthropic、Google、Azure OpenAI、Amazon Bedrock、Cohere、DeepSeek、Groq、Hugging Face、Mistral AI、OpenRouter、Perplexity、Replicate、xAI、ElevenLabs、Cerebras、Workers AI、Cartesia 等Custom Provider用户自定义的任意 AI 服务商OllamaOllama本地运行的开源模型SGLangSGLang支持多种开源模型的高效推理框架vLLMvLLM支持多种开源模型的高吞吐推理框架Skip for now跳过此步骤需要特别说明的是Cloudflare AI Gateway是一个统一的代理和管控平台本身不生产模型而是支持连接上述所有主流 AI 厂商的 APIOpenRouter、Vercel AI Gateway、LiteLLM等也属于聚合类平台支持对接多家厂商标记为 “需要查询具体文档” 的选项可能需要进一步查阅官方文档了解具体支持范围按空格选中他自己就会跳到这个页面将 OpenClaw 接入 Telegram核心分为三步创建 Telegram Bot、配置 OpenClaw 模型和频道、完成最终配对。整个过程可以根据你的部署环境如云服务器或本地选择最顺畅的路径。 方案一通过配置向导快速接入推荐新手这是最标准、最简单的流程无论你是在腾讯云、阿里云还是本地部署的 OpenClaw都可以通过内置的openclaw onboard命令来启动配置向导一步步完成设置。1. 前期准备创建你的 Telegram 机器人在开始配置 OpenClaw 之前你需要先拥有一个 Telegram 机器人的“通行证”Token。找到 BotFather在 Telegram 中搜索BotFather这是官方机器人用于创建和管理其他机器人。创建新机器人向 BotFather 发送/newbot命令。设置名称和用户名根据提示为你的机器人设置一个显示名称例如我的AI助理和一个唯一的用户名必须以_bot结尾例如MyAIAssistant_bot。保存Token创建成功后BotFather 会返回一条包含HTTP API的 Token 信息格式类似7234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw。请务必复制并妥善保存这个 Token它就是连接你 OpenClaw 和 Telegram 的“钥匙”。2. ⚙️ 运行配置向导登录到你的 OpenClaw 所在服务器在终端执行以下命令启动交互式配置向导openclaw onboard3. 在向导中按步骤操作启动后你会看到一个基于文本的菜单需要用键盘方向键和回车键进行选择和确认。关键步骤如下同意免责声明选择Yes。选择配置模式选择QuickStart快速入门。配置AI模型这是让OpenClaw具备理解能力的关键。选择你的模型提供商例如阿里云百炼、MiniMax、腾讯混元等。输入对应的API Key。如果你之前已在云控制台配置过此处可选择跳过。配置频道当进入Select channel步骤时用方向键选中Telegram (Bot API)并回车。输入Bot Token将你在第一步保存的 Telegram Bot Token 粘贴到这里并回车。其他配置Skills技能包新手建议选No避免因执行系统命令等高级功能带来的安全风险。Hooks如果出现此步骤建议只选择session-memory以确保安全。完成上述步骤后等待向导自动退出Telegram 频道的基础配置就完成了。4. 最终配对在Telegram中激活机器人这是最后一步用于将你的 Telegram 账号与 OpenClaw 实例绑定。获取配对码在 Telegram 中打开你刚刚创建的机器人点击START按钮。机器人会自动回复一条消息其中包含一个Pairing Code配对码。在服务器上确认回到服务器的终端执行以下命令将你的配对码替换为 Telegram 中收到的数字或字母组合。openclaw pairing approve telegram你的配对码成功命令执行成功后你的 Telegram 机器人和 OpenClaw 就正式连接了。现在你可以在 Telegram 中向机器人发送消息它将会以 AI 助手的身份与你对话。 方案二通过命令行手动配置适合进阶用户如果你更喜欢直接修改配置或者需要在脚本中自动化部署也可以使用命令行进行手动设置。1. 前期准备与方案一相同你需要先通过 BotFather 创建好机器人并获取Bot Token。此外建议通过 userinfobot 获取你的个人Telegram 用户ID一串数字用于设置权限。2. ⚙️ 执行配置命令通过 SSH 登录到你的 OpenClaw 服务器执行以下一组命令来配置 Telegram 频道部分命令可能需要先进入 OpenClaw 的容器环境docker exec -it openclaw-core /bin/bash。# 1. 设置 Telegram Bot Tokenopenclaw configsetchannels.telegram.botToken你的BotToken# 2. (可选但推荐) 设置允许访问的用户ID提高安全性openclaw configsetchannels.telegram.allowedChatIds你的用户ID# 3. 启用 Telegram 频道openclaw configsetchannels.telegram.enabledtrue# 4. (可选) 配置为 Webhook 模式通常更稳定# 将 你的公网IP 替换为服务器的公网IP地址openclaw configsetchannels.telegram.modewebhookopenclaw configsetchannels.telegram.webhookUrlhttp://你的公网IP:18789/telegram/webhook# 5. 重启 OpenClaw 服务使配置生效openclaw gateway restart手动设置完配置后仍需执行方案一中的“最终配对”步骤在 Telegram 中获取配对码并在服务器上运行openclaw pairing approve telegram 配对码来完成绑定。 核心要点与避坑指南部署环境为了让 Telegram 能稳定访问你的 OpenClaw建议将 OpenClaw 部署在海外地域的云服务器上如腾讯云轻量应用服务器、阿里云轻量应用服务器以避免网络问题。AI模型依赖OpenClaw 本身不具备 AI 能力必须配置第三方模型 API Key如阿里云百炼、MiniMax、OpenAI等才能实现自然语言对话。安全性Bot Token 和 API Key 是核心凭证请务必妥善保管切勿泄露。泄露可能导致服务被滥用产生不必要的费用。
通过npm 手动安装、Docker 部署 OpenClaw小龙虾
方式一一键安装脚本推荐macOS / Linux / WSL2curl-fsSLhttps://openclaw.ai/install.sh|bashWindows PowerShelliwr-usebhttps://openclaw.ai/install.ps1|iex如果只想安装、不立即进入向导curl-fsSLhttps://openclaw.ai/install.sh|bash-s-- --no-onboard方式二npm 手动安装确保 Node.js 22node--version全局安装 OpenClawnpminstall-gopenclawlatest# 运行配置向导同时安装守护进程openclaw onboard --install-daemon方式三Docker 部署dockerpull openclaw/openclaw:latestdockerrun-d\--nameopenclaw\-p18789:18789\-v~/.openclaw:/root/.openclaw\-eANTHROPIC_API_KEYsk-ant-xxx\openclaw/openclaw:latest安装后验证openclaw--versionopenclaw doctor openclaw gateway status openclaw dashboard一个对照表格展示每个选项支持的厂商选项支持的厂商/模型OpenAIOpenAIGPT-4、GPT-3.5 等系列模型AnthropicAnthropicClaude 系列模型Chutes需要查询具体文档MiniMaxMiniMaxABAB 系列模型、语音模型等Moonshot AI (Kimi K2.5)月之暗面Kimi 系列模型GoogleGoogleGemini、PaLM 等模型xAI (Grok)xAIGrok 系列模型Mistral AIMistral AIMistral、Mixtral 等模型Volcano Engine字节跳动火山引擎豆包系列模型BytePlus字节跳动 BytePlusAI 服务套件OpenRouterOpenRouter聚合多厂商模型接口Kilo Gateway需要查询具体文档Qwen阿里云通义千问系列模型Z.AI知乎知海图 AI 模型Qianfan百度智能云千帆平台文心一言等模型Alibaba Cloud Model Studio阿里云模型服务平台含通义千问等CopilotGitHub Copilot / Microsoft Copilot 相关服务Vercel AI GatewayVercel AI Gateway聚合多厂商模型接口OpenCode需要查询具体文档Xiaomi小米MiLM 小爱同学系列模型Synthetic需要查询具体文档Together AITogether AI聚合多种开源模型Hugging FaceHugging FaceHugging Face Hub 上的模型Venice AIVenice AI隐私优先的 AI 服务LiteLLMLiteLLM聚合多厂商模型接口Cloudflare AI Gateway聚合多厂商OpenAI、Anthropic、Google、Azure OpenAI、Amazon Bedrock、Cohere、DeepSeek、Groq、Hugging Face、Mistral AI、OpenRouter、Perplexity、Replicate、xAI、ElevenLabs、Cerebras、Workers AI、Cartesia 等Custom Provider用户自定义的任意 AI 服务商OllamaOllama本地运行的开源模型SGLangSGLang支持多种开源模型的高效推理框架vLLMvLLM支持多种开源模型的高吞吐推理框架Skip for now跳过此步骤需要特别说明的是Cloudflare AI Gateway是一个统一的代理和管控平台本身不生产模型而是支持连接上述所有主流 AI 厂商的 APIOpenRouter、Vercel AI Gateway、LiteLLM等也属于聚合类平台支持对接多家厂商标记为 “需要查询具体文档” 的选项可能需要进一步查阅官方文档了解具体支持范围按空格选中他自己就会跳到这个页面将 OpenClaw 接入 Telegram核心分为三步创建 Telegram Bot、配置 OpenClaw 模型和频道、完成最终配对。整个过程可以根据你的部署环境如云服务器或本地选择最顺畅的路径。 方案一通过配置向导快速接入推荐新手这是最标准、最简单的流程无论你是在腾讯云、阿里云还是本地部署的 OpenClaw都可以通过内置的openclaw onboard命令来启动配置向导一步步完成设置。1. 前期准备创建你的 Telegram 机器人在开始配置 OpenClaw 之前你需要先拥有一个 Telegram 机器人的“通行证”Token。找到 BotFather在 Telegram 中搜索BotFather这是官方机器人用于创建和管理其他机器人。创建新机器人向 BotFather 发送/newbot命令。设置名称和用户名根据提示为你的机器人设置一个显示名称例如我的AI助理和一个唯一的用户名必须以_bot结尾例如MyAIAssistant_bot。保存Token创建成功后BotFather 会返回一条包含HTTP API的 Token 信息格式类似7234567890:AAHdqTcvCH1vGWJxfSeofSAs0K5PALDsaw。请务必复制并妥善保存这个 Token它就是连接你 OpenClaw 和 Telegram 的“钥匙”。2. ⚙️ 运行配置向导登录到你的 OpenClaw 所在服务器在终端执行以下命令启动交互式配置向导openclaw onboard3. 在向导中按步骤操作启动后你会看到一个基于文本的菜单需要用键盘方向键和回车键进行选择和确认。关键步骤如下同意免责声明选择Yes。选择配置模式选择QuickStart快速入门。配置AI模型这是让OpenClaw具备理解能力的关键。选择你的模型提供商例如阿里云百炼、MiniMax、腾讯混元等。输入对应的API Key。如果你之前已在云控制台配置过此处可选择跳过。配置频道当进入Select channel步骤时用方向键选中Telegram (Bot API)并回车。输入Bot Token将你在第一步保存的 Telegram Bot Token 粘贴到这里并回车。其他配置Skills技能包新手建议选No避免因执行系统命令等高级功能带来的安全风险。Hooks如果出现此步骤建议只选择session-memory以确保安全。完成上述步骤后等待向导自动退出Telegram 频道的基础配置就完成了。4. 最终配对在Telegram中激活机器人这是最后一步用于将你的 Telegram 账号与 OpenClaw 实例绑定。获取配对码在 Telegram 中打开你刚刚创建的机器人点击START按钮。机器人会自动回复一条消息其中包含一个Pairing Code配对码。在服务器上确认回到服务器的终端执行以下命令将你的配对码替换为 Telegram 中收到的数字或字母组合。openclaw pairing approve telegram你的配对码成功命令执行成功后你的 Telegram 机器人和 OpenClaw 就正式连接了。现在你可以在 Telegram 中向机器人发送消息它将会以 AI 助手的身份与你对话。 方案二通过命令行手动配置适合进阶用户如果你更喜欢直接修改配置或者需要在脚本中自动化部署也可以使用命令行进行手动设置。1. 前期准备与方案一相同你需要先通过 BotFather 创建好机器人并获取Bot Token。此外建议通过 userinfobot 获取你的个人Telegram 用户ID一串数字用于设置权限。2. ⚙️ 执行配置命令通过 SSH 登录到你的 OpenClaw 服务器执行以下一组命令来配置 Telegram 频道部分命令可能需要先进入 OpenClaw 的容器环境docker exec -it openclaw-core /bin/bash。# 1. 设置 Telegram Bot Tokenopenclaw configsetchannels.telegram.botToken你的BotToken# 2. (可选但推荐) 设置允许访问的用户ID提高安全性openclaw configsetchannels.telegram.allowedChatIds你的用户ID# 3. 启用 Telegram 频道openclaw configsetchannels.telegram.enabledtrue# 4. (可选) 配置为 Webhook 模式通常更稳定# 将 你的公网IP 替换为服务器的公网IP地址openclaw configsetchannels.telegram.modewebhookopenclaw configsetchannels.telegram.webhookUrlhttp://你的公网IP:18789/telegram/webhook# 5. 重启 OpenClaw 服务使配置生效openclaw gateway restart手动设置完配置后仍需执行方案一中的“最终配对”步骤在 Telegram 中获取配对码并在服务器上运行openclaw pairing approve telegram 配对码来完成绑定。 核心要点与避坑指南部署环境为了让 Telegram 能稳定访问你的 OpenClaw建议将 OpenClaw 部署在海外地域的云服务器上如腾讯云轻量应用服务器、阿里云轻量应用服务器以避免网络问题。AI模型依赖OpenClaw 本身不具备 AI 能力必须配置第三方模型 API Key如阿里云百炼、MiniMax、OpenAI等才能实现自然语言对话。安全性Bot Token 和 API Key 是核心凭证请务必妥善保管切勿泄露。泄露可能导致服务被滥用产生不必要的费用。
