本文介绍了 OpenClaw 在 macOS 上的安装部署流程。支持通过官方脚本或镜像源快速安装 Node.js 及依赖。提供三种模型配置方式：向导配置、直接编辑配置文件及使用环境变量临时覆盖。包含服务状态检查、Web 控制台访问及前台调试方法。详细列出了核心配置文件路径与环境变量设置。最后阐述了局域网、内网穿透及云服务器三种服务发布方案及其优缺点，帮助用户实现本地 AI 代理的私有化部署与远程访问。
开源免费，支持清理收件箱、发送邮件、管理日历及办理登机手续。可通过飞书、WhatsApp、Telegram 或常用聊天应用交互。
支持 Mac、Windows 或 Linux 系统。兼容 Anthropic、OpenAI 或本地模型，默认私有部署，数据由用户掌控。
支持与飞书、WhatsApp、Telegram、Discord、Slack 或 iMessage 对话，支持私聊和群聊。具备记忆能力，可学习用户偏好与上下文。
功能包括网页浏览、表单填写、数据提取、文件读写、Shell 命令执行及脚本运行。支持完全访问或沙箱模式，允许使用社区技能扩展或自定义构建。
安装脚本会自动处理 Node.js 检测、安装和初始化引导（Onboarding）：
curl -fsSL https://openclaw.ai/install.sh | bash
安装过程中可配置模型，也可跳过后续再配置。
安装完成后界面会显示 http://127.0.0.1:18789，表示服务已就绪。
# 自动安装 Node.js 和所有依赖（使用国内镜像）
curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com
这是最简单安全的方式，向导会逐步重新配置并覆盖旧配置。
openclaw onboard
按提示操作：
yes，确认是个人使用。QuickStart 快速开始。Use existing values 使用现有配置。Custom Provider 自定义提供商。Base URL。API key（在自定义提供商中创建）。OpenAI-compatible。Skip for now。No。Skip for now。配置完成后重启 OpenClaw。
若默认上下文窗口和最大 Tokens 过小导致调用失败，可在终端执行以下命令调整（注意替换实际的端点 ID）：
# 设置上下文窗口、设置最大 tokens
openclaw config set 'models.providers.custom-claude-chiddns-com.models[0].contextWindow' 400000
openclaw config set 'models.providers.custom-claude-chiddns-com.models[0].maxTokens' 128000
# 查询配置
openclaw config get 'models.providers.custom-claude-chiddns-com.models[0]'
打开配置文件：
vim ~/.openclaw/openclaw.json
修改 model 的值，保存退出后重启网关使配置生效：
openclaw gateway restart
示例配置：
{
"provider": "aliyun",
"apiKey": "sk-xxxxxxxxxxxxxxxxxxxx",
"model": "qwen-plus"
}
如需临时测试某个模型而不修改永久配置，可用环境变量启动网关：
OPENCLAW_MODEL=qwen-long openclaw gateway start
本次启动将使用 qwen-long，配置文件值不变。
# 查看网关运行状态
openclaw gateway status
# 全面诊断检查
openclaw doctor
# 查看整体状态
openclaw status
终端环境（无桌面/服务器，推荐）：
openclaw tui
桌面环境：
openclaw dashboard
或在浏览器中访问：http://127.0.0.1:18789/
如需调试，可在前台启动网关查看实时日志：
openclaw gateway --port 18789
| 路径 | 说明 |
|---|---|
~/.openclaw/openclaw.json | 主配置文件（JSON5 格式） |
~/.openclaw/workspace | 代理工作空间 |
~/.openclaw/.env | 环境变量文件（存放 API Key 等敏感信息） |
环境变量覆盖：
| 变量 | 说明 |
|---|---|
OPENCLAW_HOME | OpenClaw 主目录 |
OPENCLAW_STATE_DIR | 状态数据存储目录 |
OPENCLAW_CONFIG_PATH | 配置文件路径 |
配置文件 ~/.openclaw/openclaw.json 采用 JSON5 格式，缺失时使用安全默认值。
# 通过向导修改配置
openclaw configure
# 查看当前配置
openclaw config get
最小配置示例：
{
"agents": {
"defaults": {
"workspace": "~/.openclaw/workspace"
}
}
}
配置热更新 OpenClaw 支持混合重载模式：
常用命令速查：
| 命令 | 说明 |
|---|---|
openclaw onboard | 运行引导向导 |
openclaw gateway restart | 重新启动网关 |
openclaw gateway status | 查看网关状态 |
openclaw dashboard | 打开 Web 控制台 |
openclaw doctor | 诊断检查 |
openclaw status | 查看整体状态 |
openclaw logs --follow | 实时查看日志 |
openclaw channels login | 登录聊天渠道 |
openclaw configure | 修改配置 |
openclaw config get | 查看当前配置 |
openclaw agents add | 添加额外代理实例 |
OpenClaw 服务部署后有两种方式：主动向外连接（出站）或被动等待外部连接（入站）。
| 使用场景 | 连接方向 | 是否需要穿透 |
|---|---|---|
| Telegram 与 OpenClaw 对话 | OpenClaw → Telegram（出站） | ❌ 不需要 |
| 手机浏览器打开 OpenClaw 网页 | 手机 → OpenClaw（入站） | ✅ 需要 |
手机浏览器访问内网地址（如 192.168.1.100:18789）无法直达，必须穿透。
部署方案：
原理： 手机 ←→ WiFi ←→ 电脑 (运行 OpenClaw 服务)
适用场景： 在家办公、设备在同一 WiFi 下、快速体验。
优点： 配置简单、无需公网 IP、内网速度快、最安全。 缺点： 出门后无法使用、手机需连家里 WiFi。
原理： 手机 ←→ 互联网 ←→ 穿透工具 (frp/Tailscale) ←→ 电脑
适用场景： 外出使用、不想租服务器、随时随地访问。
优点： 随时随地可用、无需公网 IP、成本低。 缺点： 需第三方服务、电脑需常开、依赖中转节点。
推荐工具： Tailscale（强烈推荐）、frp、ngrok、Cloudflare Tunnel。
操作步骤：
安装 Tailscale
curl -fsSL https://tailscale.com/install.sh | sh
sudo tailscale up
sudo tailscale status
配置 OpenClaw 监听局域网
vim ~/.openclaw/openclaw.json
# 设置 gateway bind 为 lan
openclaw gateway restart
手机端连接
100.x.x.x）。http://100.x.x.x:18789原理： 手机 ←→ 互联网 ←→ 云服务器 (OpenClaw) ←→ 电脑 (Claude)
适用场景： 多人团队共享、高可用要求、电脑不便长开机。
优点： 稳定可靠、支持多设备、负载均衡、独立部署。 缺点： 需租服务器、有运维成本、配置复杂。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
将字符串编码和解码为其 Base64 格式表示形式即可。 在线工具，Base64 字符串编码/解码在线工具，online
将字符串、文件或图像转换为其 Base64 表示形式。 在线工具，Base64 文件转换器在线工具，online
将 Markdown（GFM）转为 HTML 片段，浏览器内 marked 解析；与 HTML 转 Markdown 互为补充。 在线工具，Markdown 转 HTML在线工具，online
将 HTML 片段转为 GitHub Flavored Markdown，支持标题、列表、链接、代码块与表格等；浏览器内处理，可链接预填。 在线工具，HTML 转 Markdown在线工具，online