OpenClaw 使用指南跑在你设备上的开源个人 AI 助手OpenClaw 是一个开源 AI 助手运行在你自己的电脑上走进你已经在用的聊天渠道Discord、iMessage、Slack、Teams、Telegram、WhatsApp 以及 20 更多渠道另有 macOS、iOS、Android、Windows、Linux 原生应用。状态、记忆和凭据都在你的硬件上——真正你的助手无附加条件。一、OpenClaw 是什么1.1 一句话定义OpenClaw是一个开源的个人 AI 助手框架一个 Gateway 网关注入你在用的所有聊天应用让 AI 以 WhatsApp、Telegram、Slack 等消息形式随时待命。它跑在你自己的设备上由OpenClaw Foundation独立 501©(3) 非营利组织管理没有付费层级、没有托管服务、没有 token。1.2 背景与治理为Molty一只太空龙虾 AI 助手而建由Peter Steinberger和社区开发GitHub 仓库github.com/openclaw/openclaw9 万 commits社区极其活跃治理OpenClaw Foundation 雇佣核心团队并签署发布版本OpenAI 是捐赠者不是所有者捐赠者包括密歇根大学、OpenAI、Amazon、Red Hat 等基础设施支持来自 GitHub、NVIDIA、Vercel、Blacksmith、Convex1.3 核心理念“Yours, with no catch”维度承诺数据归属状态、记忆、凭据全部存在于你的硬件模型自由模型和 agent 框架Claude、Codex、本地模型是插件可随时更换隐私默认只做每日版本检查匿名功能统计 opt-inupdate.checkOnStart: false可全部关闭架构原则可信网关trusted gateway、不可信执行untrusted execution、确定性策略deterministic policy二、架构概览┌─────────────────────────────────────────────┐ │ 渠道 Channels │ │ WhatsApp · Telegram · Slack · Discord │ │ iMessage · Signal · Teams · Google Chat... │ └────────────────────┬────────────────────────┘ ▼ ┌─────────────────────────────────────────────┐ │ Gateway 网关本地控制平面 │ │ 会话 · 工具 · 事件 · 渠道连接 │ │ 默认监听 127.0.0.1:18789 │ └──────┬──────────────────────┬───────────────┘ ▼ ▼ Control UI / CLI / TUI 模型提供商插件 Claude · Codex · 本地模型Gateway本地控制平面管理会话、工具、事件和渠道连接Control UI / CLI / TUI三种连接 Gateway 的界面Channels把助手带进 WhatsApp、Telegram、Slack 等消息服务Companion apps nodes语音、Canvas、相机、屏幕、设备本地操作一个 Gateway 既可以作为笔记本上的个人助手运行也可以作为共享的团队部署——区别只是配置。三、系统要求与安装3.1 系统要求Node.js22.22.3、24.15 或 25.9推荐默认 24一个模型提供商的API keyAnthropic、OpenAI、Google 等支持 macOS、Linux、Windows原生 Windows Hub 应用 PowerShell 安装程序 WSL2 Gateway3.2 一键安装macOS / Linux / WSL2curl-fsSLhttps://openclaw.ai/install.sh|bashWindowsPowerShelliwr-useb https://openclaw.ai/install.ps1|iex安装脚本会自动提供受支持的 Node.js 运行时。3.3 npm 安装已有 Node.jsnpminstall-gopenclawlatest --allow-scriptsopenclaw需要 Node 24.16 或 26.1推荐 26npm 11.15 及更早版本省略--allow-scriptsopenclaw其他方式Docker、Nix、从源码构建git clonepnpm installpnpm build四、快速开始约 5 分钟4.1 运行新手引导openclaw onboard --install-daemon向导会引导你选择 Gateway 模式配置 AI 模型选择提供商 输入 API key绑定聊天渠道安装守护进程daemon可以跳过可选步骤稍后用openclaw configure返回继续配置。openclaw onboard --classic打开经典分步向导。4.2 验证 Gatewayopenclaw gateway status应看到 Gateway 正在监听端口18789。4.3 打开仪表板openclaw dashboard在浏览器中打开 Control UI。页面能加载即一切正常。4.4 发送第一条消息在 Control UI 聊天中输入消息收到 AI 回复即成功。4.5 安装后台服务快速开始时 Gateway 在前台运行。按CtrlC停止后安装为后台服务openclaw gatewayinstall五、连接聊天渠道5.1 WhatsAppQR 扫码openclaw channels login终端显示 QR 码 → 手机 WhatsApp → 设置 → 已链接设备 → 扫描。建议使用专用电话号码。VoIP 号码容易出问题。5.2 Telegram最快设置只需一个 Bot 令牌在 Telegram 中给BotFather发/newbot设置名称如 “My OpenClaw Assistant”和以bot结尾的用户名复制 BotFather 生成的令牌配置到 OpenClaw向导可代写openclaw channels login telegram5.3 其他渠道渠道方式DiscordBot tokenSlackApp tokeniMessage本地桥接Microsoft TeamsApp 注册Signal本地桥接Google Chat / Matrix / Zalo / Feishu 等官方文档对应配置配对机制DM 类渠道默认对未知发送者启用配对——收到配对请求后用openclaw pairing approve channel code批准。六、模型配置6.1 托管模型提供商提供商说明AnthropicClaude推荐起点OpenAIGPT 系列GoogleGemini其他见官方 Models 文档6.2 本地模型支持通过 Ollama 等运行本地模型——模型提供商是可替换的插件换模型不影响其他配置。6.3 Agent 框架模型之外agent harnessClaude、Codex、本地模型同样即插即用。七、工具、技能与插件扩展类型说明Tools浏览器、Exec、Web 搜索等内置能力Skills自定义指令和知识库按需动态加载Plugins基于 plugin SDK 构建的新能力ClawHub插件市场分享和获取社区插件MCP可接入外部工具生态八、CLI 常用命令命令作用openclaw onboard新手引导向导openclaw configure返回修改配置openclaw gateway status检查 Gateway 状态openclaw gateway install安装后台服务openclaw gateway restart重启 Gatewayopenclaw dashboard打开 Control UIopenclaw channels login登录/配对聊天渠道openclaw pairing approve channel code批准配对请求环境变量变量作用OPENCLAW_HOME内部路径解析的主目录OPENCLAW_STATE_DIR覆盖状态目录OPENCLAW_CONFIG_PATH覆盖配置文件路径九、安全指南OpenClaw 的架构原则是可信网关 不可信执行但安全责任在你9.1 基本安全实践把入站消息视为不可信输入DM 渠道默认配对未知发送者——批准前确认对方身份默认 Gateway 只绑定127.0.0.1:18789仅本地访问安全工具默认在主会话的主机上运行——连接其他用户或远程暴露前务必配置沙箱9.2 连接外部前必读连接其他用户或把 Gateway 暴露到远程之前官方要求先读安全指南security guide暴露运行手册exposure runbook沙箱指南sandboxing guide9.3 默认隐私只做每日版本检查update.checkOnStart: false可关闭匿名功能统计 opt-in你的提示词只发给配置的模型提供商和聊天平台十、典型使用场景场景用法个人助理一个专用 WhatsApp 号码充当永远在线的 agent团队部署一个 Gateway 共享团队成员通过各自渠道使用多模型对比同一个 Gateway 切换 Claude / Codex / 本地模型语音交互Companion 应用提供语音、相机、屏幕能力自动化任务通过消息渠道触发浏览器、Exec、Web 搜索等工具私有部署状态、记忆、凭据全在本地无云端依赖十一、常见问题Q: OpenClaw 是免费的吗A: 是的。没有付费层级、没有托管服务、没有 token。由 OpenClaw Foundation501©(3) 非营利组织治理。Q: 我的数据会发给谁A: 状态、记忆、凭据在你的硬件上。提示词发给你配置的模型提供商和聊天平台。OpenClaw 本身默认只做每日版本检查匿名统计 opt-in。Q: 能连 WhatsApp 吗A: 能QR 扫码配对即可。建议使用专用电话号码VoIP 号码容易出问题。Q: 支持本地模型吗A: 支持。模型提供商是插件Claude、Codex、Ollama 本地模型等可随意切换不影响其他配置。Q: 需要 Node.js 吗A: 一键安装脚本会自动准备受支持的 Node.js 运行时也可以 npm 全局安装Node 24.16 / 26.1。Q: 有图形界面吗A: 有。openclaw dashboard打开浏览器 Control UI另有 macOS、iOS、Android、Windows、Linux 原生应用。Q: 安全吗A: 架构上采用可信网关 不可信执行。默认仅绑定本地 127.0.0.1DM 渠道默认配对。要连接他人或远程暴露前务必阅读官方安全文档并配置沙箱。参考资源GitHub 仓库https://github.com/openclaw/openclaw官方文档https://docs.openclaw.ai/中文入门指南https://docs.openclaw.ai/zh-CN/start/getting-started官网https://openclaw.ai个人助理设置指南https://openclaw-ai.com/en/docs/start/openclawOpenClaw 由 Peter Steinberger 发起、OpenClaw Foundation 治理本文基于 2026 年 9 月公开资料整理。安装与配置以官方最新文档为准。 OpenClaw 使用指南：跑在你设备上的开源个人 AI 助手
OpenClaw 使用指南跑在你设备上的开源个人 AI 助手OpenClaw 是一个开源 AI 助手运行在你自己的电脑上走进你已经在用的聊天渠道Discord、iMessage、Slack、Teams、Telegram、WhatsApp 以及 20 更多渠道另有 macOS、iOS、Android、Windows、Linux 原生应用。状态、记忆和凭据都在你的硬件上——真正你的助手无附加条件。一、OpenClaw 是什么1.1 一句话定义OpenClaw是一个开源的个人 AI 助手框架一个 Gateway 网关注入你在用的所有聊天应用让 AI 以 WhatsApp、Telegram、Slack 等消息形式随时待命。它跑在你自己的设备上由OpenClaw Foundation独立 501©(3) 非营利组织管理没有付费层级、没有托管服务、没有 token。1.2 背景与治理为Molty一只太空龙虾 AI 助手而建由Peter Steinberger和社区开发GitHub 仓库github.com/openclaw/openclaw9 万 commits社区极其活跃治理OpenClaw Foundation 雇佣核心团队并签署发布版本OpenAI 是捐赠者不是所有者捐赠者包括密歇根大学、OpenAI、Amazon、Red Hat 等基础设施支持来自 GitHub、NVIDIA、Vercel、Blacksmith、Convex1.3 核心理念“Yours, with no catch”维度承诺数据归属状态、记忆、凭据全部存在于你的硬件模型自由模型和 agent 框架Claude、Codex、本地模型是插件可随时更换隐私默认只做每日版本检查匿名功能统计 opt-inupdate.checkOnStart: false可全部关闭架构原则可信网关trusted gateway、不可信执行untrusted execution、确定性策略deterministic policy二、架构概览┌─────────────────────────────────────────────┐ │ 渠道 Channels │ │ WhatsApp · Telegram · Slack · Discord │ │ iMessage · Signal · Teams · Google Chat... │ └────────────────────┬────────────────────────┘ ▼ ┌─────────────────────────────────────────────┐ │ Gateway 网关本地控制平面 │ │ 会话 · 工具 · 事件 · 渠道连接 │ │ 默认监听 127.0.0.1:18789 │ └──────┬──────────────────────┬───────────────┘ ▼ ▼ Control UI / CLI / TUI 模型提供商插件 Claude · Codex · 本地模型Gateway本地控制平面管理会话、工具、事件和渠道连接Control UI / CLI / TUI三种连接 Gateway 的界面Channels把助手带进 WhatsApp、Telegram、Slack 等消息服务Companion apps nodes语音、Canvas、相机、屏幕、设备本地操作一个 Gateway 既可以作为笔记本上的个人助手运行也可以作为共享的团队部署——区别只是配置。三、系统要求与安装3.1 系统要求Node.js22.22.3、24.15 或 25.9推荐默认 24一个模型提供商的API keyAnthropic、OpenAI、Google 等支持 macOS、Linux、Windows原生 Windows Hub 应用 PowerShell 安装程序 WSL2 Gateway3.2 一键安装macOS / Linux / WSL2curl-fsSLhttps://openclaw.ai/install.sh|bashWindowsPowerShelliwr-useb https://openclaw.ai/install.ps1|iex安装脚本会自动提供受支持的 Node.js 运行时。3.3 npm 安装已有 Node.jsnpminstall-gopenclawlatest --allow-scriptsopenclaw需要 Node 24.16 或 26.1推荐 26npm 11.15 及更早版本省略--allow-scriptsopenclaw其他方式Docker、Nix、从源码构建git clonepnpm installpnpm build四、快速开始约 5 分钟4.1 运行新手引导openclaw onboard --install-daemon向导会引导你选择 Gateway 模式配置 AI 模型选择提供商 输入 API key绑定聊天渠道安装守护进程daemon可以跳过可选步骤稍后用openclaw configure返回继续配置。openclaw onboard --classic打开经典分步向导。4.2 验证 Gatewayopenclaw gateway status应看到 Gateway 正在监听端口18789。4.3 打开仪表板openclaw dashboard在浏览器中打开 Control UI。页面能加载即一切正常。4.4 发送第一条消息在 Control UI 聊天中输入消息收到 AI 回复即成功。4.5 安装后台服务快速开始时 Gateway 在前台运行。按CtrlC停止后安装为后台服务openclaw gatewayinstall五、连接聊天渠道5.1 WhatsAppQR 扫码openclaw channels login终端显示 QR 码 → 手机 WhatsApp → 设置 → 已链接设备 → 扫描。建议使用专用电话号码。VoIP 号码容易出问题。5.2 Telegram最快设置只需一个 Bot 令牌在 Telegram 中给BotFather发/newbot设置名称如 “My OpenClaw Assistant”和以bot结尾的用户名复制 BotFather 生成的令牌配置到 OpenClaw向导可代写openclaw channels login telegram5.3 其他渠道渠道方式DiscordBot tokenSlackApp tokeniMessage本地桥接Microsoft TeamsApp 注册Signal本地桥接Google Chat / Matrix / Zalo / Feishu 等官方文档对应配置配对机制DM 类渠道默认对未知发送者启用配对——收到配对请求后用openclaw pairing approve channel code批准。六、模型配置6.1 托管模型提供商提供商说明AnthropicClaude推荐起点OpenAIGPT 系列GoogleGemini其他见官方 Models 文档6.2 本地模型支持通过 Ollama 等运行本地模型——模型提供商是可替换的插件换模型不影响其他配置。6.3 Agent 框架模型之外agent harnessClaude、Codex、本地模型同样即插即用。七、工具、技能与插件扩展类型说明Tools浏览器、Exec、Web 搜索等内置能力Skills自定义指令和知识库按需动态加载Plugins基于 plugin SDK 构建的新能力ClawHub插件市场分享和获取社区插件MCP可接入外部工具生态八、CLI 常用命令命令作用openclaw onboard新手引导向导openclaw configure返回修改配置openclaw gateway status检查 Gateway 状态openclaw gateway install安装后台服务openclaw gateway restart重启 Gatewayopenclaw dashboard打开 Control UIopenclaw channels login登录/配对聊天渠道openclaw pairing approve channel code批准配对请求环境变量变量作用OPENCLAW_HOME内部路径解析的主目录OPENCLAW_STATE_DIR覆盖状态目录OPENCLAW_CONFIG_PATH覆盖配置文件路径九、安全指南OpenClaw 的架构原则是可信网关 不可信执行但安全责任在你9.1 基本安全实践把入站消息视为不可信输入DM 渠道默认配对未知发送者——批准前确认对方身份默认 Gateway 只绑定127.0.0.1:18789仅本地访问安全工具默认在主会话的主机上运行——连接其他用户或远程暴露前务必配置沙箱9.2 连接外部前必读连接其他用户或把 Gateway 暴露到远程之前官方要求先读安全指南security guide暴露运行手册exposure runbook沙箱指南sandboxing guide9.3 默认隐私只做每日版本检查update.checkOnStart: false可关闭匿名功能统计 opt-in你的提示词只发给配置的模型提供商和聊天平台十、典型使用场景场景用法个人助理一个专用 WhatsApp 号码充当永远在线的 agent团队部署一个 Gateway 共享团队成员通过各自渠道使用多模型对比同一个 Gateway 切换 Claude / Codex / 本地模型语音交互Companion 应用提供语音、相机、屏幕能力自动化任务通过消息渠道触发浏览器、Exec、Web 搜索等工具私有部署状态、记忆、凭据全在本地无云端依赖十一、常见问题Q: OpenClaw 是免费的吗A: 是的。没有付费层级、没有托管服务、没有 token。由 OpenClaw Foundation501©(3) 非营利组织治理。Q: 我的数据会发给谁A: 状态、记忆、凭据在你的硬件上。提示词发给你配置的模型提供商和聊天平台。OpenClaw 本身默认只做每日版本检查匿名统计 opt-in。Q: 能连 WhatsApp 吗A: 能QR 扫码配对即可。建议使用专用电话号码VoIP 号码容易出问题。Q: 支持本地模型吗A: 支持。模型提供商是插件Claude、Codex、Ollama 本地模型等可随意切换不影响其他配置。Q: 需要 Node.js 吗A: 一键安装脚本会自动准备受支持的 Node.js 运行时也可以 npm 全局安装Node 24.16 / 26.1。Q: 有图形界面吗A: 有。openclaw dashboard打开浏览器 Control UI另有 macOS、iOS、Android、Windows、Linux 原生应用。Q: 安全吗A: 架构上采用可信网关 不可信执行。默认仅绑定本地 127.0.0.1DM 渠道默认配对。要连接他人或远程暴露前务必阅读官方安全文档并配置沙箱。参考资源GitHub 仓库https://github.com/openclaw/openclaw官方文档https://docs.openclaw.ai/中文入门指南https://docs.openclaw.ai/zh-CN/start/getting-started官网https://openclaw.ai个人助理设置指南https://openclaw-ai.com/en/docs/start/openclawOpenClaw 由 Peter Steinberger 发起、OpenClaw Foundation 治理本文基于 2026 年 9 月公开资料整理。安装与配置以官方最新文档为准。