OpenClaw 使用教程：16 步从安装到沙盒（2026）

从零到网关跑起来

1. 1

   用 npm 全局安装

   唯一的门槛是 Node 22 或更高版本——课程页面在动手前先跑了 `node -v`。一条全局安装命令就能把 `openclaw` 挂到 PATH 里：`npm install -g openclaw@latest`。同一页还预告了下一步要跑的 `openclaw onboard --install-daemon`。

   

2. 2

   带 daemon 参数跑引导向导

   `openclaw onboard --install-daemon` 会把网关装成后台服务——macOS 上是 launchd，Linux 上是 systemd——开机自启，不需要一直开着终端窗口。向导开头是一段值得逐字读完的安全警告：OpenClaw 还处在测试阶段，而你正把终端权限交给它。确认「理解其强大与风险」之后才能继续。

   

3. 3

   选模型服务商

   服务商列表里有 OpenAI、Anthropic、Google Gemini、OpenRouter、Qwen、Z.AI GLM 4.7 等。课程选了 Anthropic——它支持 Claude setup token：在另一个终端跑 `claude setup-token`，把生成的令牌粘贴回来。想零成本先试试，主讲人指向 Google Gemini——截至 2026 年 10 月，每天约有 20 次免费请求。

   

4. 4

   把网关绑定在 loopback

   绑定选项把主讲人问住了，他的办法是克隆 OpenClaw 仓库、让 Claude Code 直接读源码。给出的答案：选 Loopback（127.0.0.1）——网关只接受本机连接，是单机部署里最安全的选择。LAN、Tailscale、Auto 留给远程访问，之后随时可以用 `openclaw config` 改回来。

   

首次启动：身份、体检与记忆文件

1. 5

   打开 boot.md 钩子

   钩子（hooks）会在命令触发时自动执行动作。向导提供三个：boot-md 每次网关启动时跑一遍启动脚本；command-logger 把所有命令写进审计日志；session-memory 在你发 /new 时保存会话上下文。课程启用了 boot-md 和 session-memory，之后可用 `openclaw hooks list` 管理，或用 `openclaw hooks disable boot-md` 关掉。

   

2. 6

   启动 TUI，让它自己取名

   选 Launch in TUI 后，它替你发出了第一条消息："Wake up, my friend!"。智能体回复说自己没有记忆、没有名字，反问你是谁。报上名字、让它自己挑——课程里的智能体给自己取名 Nova，还写好了身份设定。留意状态栏：光这一句问候就烧掉了约 14,000 tokens。

   

3. 7

   体检：audit 与 doctor

   两条命令值得在首跑后各来一遍。`openclaw security audit --deep` 会对着活跃网关探测配置，课程机器上的结果是 0 critical、1 warn、1 info；`--fix` 能自动收紧。`openclaw doctor` 给网关做健康检查并顺手修复——画面里它补建了缺失的 credentials 目录。`openclaw status` 则随时显示渠道健康和最近会话。

   

4. 8

   认识记忆文件

   OpenClaw 对你的全部了解都放在 ~/.openclaw 下的纯文本 markdown 里。AGENTS.md 是操作手册——它甚至指示智能体在首跑后删掉自己的引导文件。IDENTITY.md 记录它对自己的设定；USER.md 记你的名字和时区；HEARTBEAT.md 留空就跳过周期唤醒，想让它定期检查的事就写在里面。官方文档还建议把整个文件夹备份成私有 git 仓库。

   

装进口袋：WhatsApp 与 Discord

1. 9

   扫码配对 WhatsApp

   `openclaw channels login` 会把配对二维码直接打进终端——课程机器上先要启用 WhatsApp 插件并重启网关。用手机 WhatsApp 的「已关联的设备」扫码，和登录 WhatsApp Web 完全一样。控制台停在 "Waiting for WhatsApp connection..."，直到关联设备签到。

   

2. 10

   把你的手机号加进白名单

   文档页写得直白：一定设置 channels.whatsapp.allowFrom，永远别在个人 Mac 上对全世界开放。课程在 ~/.openclaw/openclaw.json 的 WhatsApp 渠道下加了一个白名单号码。同一页还有两条护身建议：能给智能体配专用号码最好；信任它之前先把 agents.defaults.heartbeat.every 设为 0m。另外别把它拉进群聊——群里任何人都能哄它在你的电脑上跑命令。

   

3. 11

   用 WhatsApp 派一个真任务

   只有一个号码时对话会有点混——智能体的回复和你自己的消息挤在同一线程——但确实能用。课程发去：「看看我 ~/Developer 文件夹里还有哪些没处理的 pull request？」几秒后收到格式化回复：一个仓库 5 个未处理 PR，2 个 open、3 个 draft，其余仓库全干净。给 bot 配第二个专用号码，线程就清爽了。

   

4. 12

   接入 Discord bot（需要 @提及）

   直接问智能体怎么办，它会带你走完 Discord 开发者后台：建应用、重置 bot token、开启 message-content intent，再把 token、服务器 ID 和频道 ID 交给它。bot 要加入一个私人服务器——这也顺带解决了 DM 问题，因为 bot 必须住在服务器里。在服务器频道里，它只响应 @提及；课程 bot 的自我介绍是：「Nova 在此——OpenClaw 大使，刚刚出生」。WhatsApp 的警告在这里同样成立：服务器里的任何人都能和这个有终端权限的东西对话。

   

技能、第二个智能体与沙盒

1. 13

   读一遍自带的技能

   技能就是一个文件夹加一份 SKILL.md——YAML 头信息加说明书，教智能体用一样工具。工作区自带不少：himalaya 管终端邮件（IMAP/SMTP）、bird 管 Twitter、apple-notes、画图的 nano-banana、github 等等。智能体专属技能放在各自工作区的 skills 文件夹；~/.openclaw/skills 里的则对整机所有智能体可见。每条技能约占 24 tokens 系统提示；社区技能市场 ClawHub（clawhub.com）用法类似 pip——文档提醒：第三方技能先当不可信，启用前先读一遍。

   

2. 14

   写一个自定义技能：给自己发邮件

   为了证明上手有多快，主讲人直接让 OpenClaw 用简单的 Python 写个发邮件的技能。智能体要两个环境变量——SMTP_EMAIL 和 SMTP_PASSWORD；Gmail 开了两步验证的话，后者要用 myaccount.google.com/apppasswords 生成的应用专用密码。它把 send_email.py 写进自定义技能目录，然后回应「test it by sending an email saying hi」。片刻后收件箱出现「Hey from Nova!」——智能体宣布自己已四线作战：网页聊天、WhatsApp、Discord 和邮件。

   

3. 15

   加一个上班用的二号智能体

   `openclaw agents add work` 会创建第二个智能体，拥有自己的工作区、会话、认证档案、沙盒和工具策略。`openclaw agents list` 能看到 work 和 main，在 TUI 里用 `/agents` 随时切换。新的 work 智能体对 Nova 一无所知——一个空白同事，可以接上你的工作 Slack、工作邮箱和代码仓库；main 留给下班后的自己。

   

4. 16

   给高风险智能体上沙盒

   Docker Desktop 跑起来后，主讲人直接命令智能体：「我刚跑了 scripts/sandbox-setup.sh，把 work 智能体设为 agent 作用域的沙盒」——它自己把沙盒模式设为 all、作用域设为 agent，并重启了网关。验证只要一句话：问「能看到我桌面文件吗？」会被拒——work 智能体只看得到 ~/.openclaw/sandboxes 下的沙盒。这就是不租 VPS 也能拿到的 VPS 级隔离；代价是文件要拷进沙盒才能用，而且能联网就仍有风险。

   

常见问题