OpenClaw(MACOS 安装部署)
一、介绍：
开源免费 · 清理收件箱、发送邮件、管理日历、办理登机手续。通过飞书、WhatsApp、Telegram 或任何你常用的聊天应用。
Mac、Windows 或 Linux。Anthropic、OpenAI 或本地模型。默认私有——你的数据属于你自己。
通过飞书、WhatsApp、Telegram、Discord、Slack 或 iMessage 与它对话。支持私聊和群聊。
记住你的一切并成为独一无二的你的 AI。你的偏好、你的上下文、你的 AI。
它可以浏览网页、填写表单、从任何网站提取数据。
读写文件、运行 Shell 命令、执行脚本。完全访问或沙箱模式——由你选择。
使用社区技能扩展或自己构建。它甚至可以自己编写技能。
二、安装 OpenClaw：
2.1 官方推荐的安装方式
安装脚本会自动处理 Node.js 检测、安装和初始化引导（Onboarding），是官方推荐的安装方式：
curl -fsSL https://openclaw.ai/install.sh | bash安装过程中可以配置模型，也可以跳过，安完之后再配置。
出现上面的界面，带有http://127.0.0.1:18789，就是安装完成了。
2.2 使用镜像安装方式
# 自动安装 Node.js 和所有依赖（使用国内镜像） curl -fsSL https://clawd.org.cn/install.sh | bash -s -- --registry https://registry.npmmirror.com三、模型配置
3.1 手动执行方式
这是最简单安全的方式，向导会帮你一步步重新配置，自动覆盖旧配置。
openclaw onboard选择yes,我知晓是个人使用的，不做其他限制。
选择QuickStart快速开始。
选择Use existing values 选择使用存在的配置。
这里我们选择Custom Provider自定义提供商。
输入自定义提供商的Base URL。
输入API key，这个是在自定义提供商里面创建的，对应的是密钥。
选择端点兼容性，我这里选择的是OpenAI-compatible,适配openai格式的。
输入模型ID。
输入端点ID，这里是他根据模型提供商的域名自动生成的，一般无需改动，但这里要记一下（例如 https://dashscope.aliyuncs.com/compatible-mode/v1），后面我们设置上下文大小以及最大tokens时，要用到。
选择channel，这里我们先跳过，选择Skip for now。
是否配置技能，这里还是选择先不配置，选择No。
是否配置hooks，选择Skip for now。
配置完成重启openclaw.
如果OpenClaw在配置自定义模型提供商时，默认的上下文窗口和最大Tokens参数会过于小，导致无法成功调用，我们需要在终端执行以下命令：
PS：注意需要调整上面要大家记住的端点ID，我的是custom-claude-chiddns-com，按实际的进行替换
# 设置上下文窗口、设置最大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]' 到这里我们就完成全部安装以及自定义模型配置。
3.2 直接编辑配置文件
打开配置文件
vim ~/.openclaw/openclaw.json{ "provider": "aliyun", "apiKey": "sk-xxxxxxxxxxxxxxxxxxxx", "model": "qwen-plus", // ... 其他配置 }修改 model 的值,保存并退出.
重启 OpenClaw 网关使配置生效:
openclaw gateway restart3.3 使用环境变量临时覆盖
如果你只是想临时测试某个模型，不想修改永久配置，可以用环境变量启动网关：
OPENCLAW_MODEL=qwen-long openclaw gateway start这样本次启动会使用 qwen-long，但配置文件中的值不会被改变。
四、验证安装
4.1 检查服务状态
# 查看网关运行状态 openclaw gateway status # 全面诊断检查（配置、连接、权限等） openclaw doctor # 查看整体状态 openclaw status4.2 访问控制界面
终端环境（无桌面 / 服务器，推荐）：
# 通过 TUI 在终端中直接管理 openclaw tui
桌面环境：
# 启动 Web 控制台 openclaw dashboard或在浏览器中访问：http://127.0.0.1:18789/
4.3 前台调试运行
如需调试，可在前台启动网关查看实时日志：
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 Bot）方式（无需穿透）： OpenClaw → 主动连接 Telegram 服务器 ← 手机发送消息 ↑ 出站连接，任何设备都能发起| 使用场景 | 连接方向 | 是否需要穿透 |
|---|---|---|
| Telegram 与 OpenClaw 对话 | OpenClaw → Telegram（出站） | ❌ 不需要 |
| 手机浏览器打开 OpenClaw 网页 | 手机 → OpenClaw（入站） | ✅ 需要 |
7.1 服务网络连接-出站方式
| 特性 | 说明 |
|---|---|
| 长轮询 (Long Polling) | OpenClaw 持续向 Telegram 服务器询问："有新消息吗？" |
| Webhook | OpenClaw 注册一个回调地址，但 Telegram 服务器主动推送 |
| 连接方向 | 永远是 OpenClaw → Telegram，不是反向 |
7.2 服务网络连接-入站方式
网页控制台场景： 手机浏览器 ──→ 想访问 192.168.1.100:18789 ↑ 这是内网地址，手机在外网无法直达 必须穿透：手机 ──→ 公网地址 ──→ 路由器 ──→ OpenClawopenclaw有三种部署方案可选:
方案一:局域网部署
原理:
📱 手机 ←→ WiFi ←→ 💻 电脑(运行OpenClaw服务)
适用场景:
- 在家办公
- 手机和电脑在同一WiFi下
- 快速体验和测试
优点:
- ✅ 配置最简单,5分钟搞定
- ✅ 不需要公网IP或服务器
- ✅ 内网速度快,延迟低
- ✅ 最安全,不暴露到公网
缺点:
- ❌ 出门后无法使用
- ❌ 手机需要连家里WiFi
方案二:内网穿透
原理:
📱 手机 ←→ 🌍 互联网 ←→ 🔌 穿透工具(frp/Tailscale) ←→ 💻 电脑
适用场景:
- 外出时也要使用
- 不想租服务器
- 需要随时随地访问
优点:
- ✅ 随时随地可用
- ✅ 无需公网IP
- ✅ Tailscale 等方案配置简单
- ✅ 成本低(Tailscale免费版够用)
缺点:
- ❌ 需要第三方服务
- ❌ 电脑需要一直开机
- ❌ 依赖中转节点稳定性
推荐工具:
- Tailscale - 零配置虚拟局域网(强烈推荐)
- frp - 老牌内网穿透工具
- ngrok - 简单但免费版有限制
- Cloudflare Tunnel - 自带HTTPS加密
操作步骤：
1）安装 Tailscale
# 安装 curl -fsSL https://tailscale.com/install.sh | sh # 启动并登录 sudo tailscale up # 查看状态 sudo tailscale status2）配置 OpenClaw 监听局域网
vim ~/.openclaw/openclaw.json{ "gateway": { "bind": "lan", "port": 18789 } }openclaw gateway restart3）手机端连接
- 手机安装 Tailscale App，登录同一账号
- 获取电脑在 Tailscale 中的 IP（如
100.x.x.x） - 手机浏览器访问：
http://100.x.x.x:18789
方案三:云服务器中转(生产级)
原理:
📱 手机 ←→ 🌍 互联网 ←→ ☁️ 云服务器(OpenClaw) ←→ 💻 电脑(Claude)
适用场景:
- 多人团队共享
- 要求高可用
- 电脑不方便长开机
- 多台电脑协同
优点:
- ✅ 最稳定可靠
- ✅ 支持多设备
- ✅ 可配置负载均衡
- ✅ 独立部署,灵活性强
缺点:
- ❌ 需要租服务器(成本约50-100元/月)
- ❌ 需要一定运维知识
- ❌ 配置相对复杂
