01 · 介绍
OpenClaw 是什么
OpenClaw 是一个开源的 AI 助手（MIT 许可证），你可以把它安装在自己的 Mac、Windows 或 Linux 电脑上。你可以在浏览器页面、桌面应用中与它对话，也可以通过手机上的聊天应用与它交流。它能real做事：读写文件、运行命令、浏览网页，并使用你添加的技能和插件。
它本身不附带 AI 模型，而是借用你已有的模型：Claude Code 或 Codex 的登录账号、API 密钥，或本地模型。
你会遇到的术语：
- Gateway（网关）：作为助手"大脑"的后台程序。它负责保存你的会话、工具和聊天连接，并在你电脑的 18789 端口上监听。
- Control UI（控制面板）：一个网页，你可以在这里与它聊天并查看其运行状态。
- Channel（渠道）：连接到它的聊天应用，例如 Telegram 或 Slack。目前支持 20 多种。
- Node（节点）：为智能体提供额外能力的设备，例如手机的摄像头或 Windows 电脑的屏幕。
你的记忆、设置和密钥都保存在你的电脑上。只有你的消息会发送给你选择的模型提供商和聊天应用。
02 · 适合什么场景
适用场景
- 装在口袋里的个人助手。 你外出时可以通过 Telegram 或 WhatsApp 给它发消息，它会在家里的电脑上工作。
- 日常琐事。 整理文件、起草回复、检查网页，或运行你原本需要手动执行的脚本。
- 一个助手对接多个聊天应用。 同一套记忆和工具，工作时在 Slack 里回答你，回家后在 Telegram 里回答你。
- 数据保存在家中。 没有任何内容存储在 OpenClaw 的服务器上。
请保持现实的预期：它会以真实的权限访问你的电脑，而且长时间无人值守的任务可能会悄无声息地失败。从你能够检查结果的小任务开始。
03 · 配置
如何设置
你需要一台 Mac、Windows 或 Linux 电脑，以及一个可正常使用的 AI 账号（Claude Code 或 Codex 登录，或 API 密钥）。你无需自己安装 Node.js，安装程序会自动处理。
**Windows：**下载 Windows Hub 安装程序（无需管理员权限），并选择本地安装；或者运行一条 PowerShell 命令：
iwr -useb https://openclaw.ai/install.ps1 | iex
**Mac：**如果你的系统是 macOS 26.2 或更新版本，请从 GitHub releases 页面下载 OpenClaw.app。如果是较旧的 Mac，请使用终端：
curl -fsSL https://openclaw.ai/install.sh | bash
随后，设置向导（onboarding）会帮你连接 AI 账号，并询问是否让它在后台持续运行。检查是否安装成功：
openclaw gateway status
openclaw dashboard
第二条命令会打开仪表盘。发送一条消息；如果它能正常回复，就说明你已经完成了。
04 · 使用说明
日常使用
- 在仪表盘中聊天（
openclaw dashboard）或在终端中聊天（openclaw）。 - 连接一个聊天应用。 Telegram 最快：只需要一个机器人令牌（bot token）。设置配对，使只有你能向它下达指令。
- 之后更改设置，使用
openclaw configure。 - 出了问题？
openclaw doctor会列出问题；openclaw triage会生成一份清晰的诊断报告，你可以交给 Claude Code 或 Codex。 - 更新，使用
openclaw update。
如果你还想试试 Hermes Agent，它可以导入 OpenClaw 的设置、记忆和技能，方便你并排对比两者。
05 · 注意事项
需要注意的事项
- 默认没有沙箱。 它的工具直接在你的电脑上运行。在授予过宽的权限之前，请先阅读安全指南。
- 锁定你的渠道。 使用配对和允许名单，防止陌生人给你的智能体发消息。
- 故障可能是静默的。 定时任务可能失败却不通知你。把固定且可重复的步骤写成脚本，并检查结果。
- Mac 应用需要 macOS 26.2 或更新版本。 较旧的 Mac 应使用终端安装方式。
- 变化很快。 新版本发布频繁（2026 年 11 月 5 日发布的 2026.11.1 版本），因此菜单和命令可能会变动。
06 · 资源