企业官网建设流程全解析

1. OpenClaw 在 Windows 与苹果系统上到底能做什么

OpenClaw 是一个可以在本地电脑上运行的 AI 智能体框架，圈内人管它叫“小龙虾”。它和普通聊天机器人的区别在于：它能真正操作你的电脑——读写文件、整理目录、调用浏览器、执行脚本，把一句自然语言指令拆成多步任务并自动跑完。适合谁？适合不想写代码、但想让电脑帮忙干重复活的人，比如整理下载文件夹、批量重命名、把网页内容抓成表格。

“养虾”这个词就是这么来的：部署好 OpenClaw，相当于养了一只住在你电脑里的数字员工。Windows 和苹果系统都能跑，但两者的环境准备、配置文件路径、启动方式差别不小。这篇就按 Windows 和 macOS 两条线，从环境准备到首次启动全流程拆开讲，重点给出可复制的config.toml骨架和settings.json示例，再配启动验证和报错排查。你跟着做，目标是第一次就把虾养活。

需要先说明一点：OpenClaw 本身是开源项目，模型能力需要接一个兼容 OpenAI 协议的服务端点。我实测下来，用 TaoToken 这类聚合服务接模型比较省事，一个 Key 就能调多种模型，不用自己折腾本地推理环境。下面配置里会用到它的 API 地址。

2. 部署前的前置准备：TaoToken Key 与环境检查

2.1 为什么先拿 Key 再装虾

OpenClaw 启动后要连模型才能干活，所以 Key 得先备好。TaoToken 的控制台里可以创建 API Key，地址是 https://taotoken.net/api ，注册后在 API Keys 页面生成一串sk-开头的密钥，复制保存好，后面填进配置文件。

如果你只是先验证模型通不通，可以打开模型对话页面直接试；如果打算长期跑编码类、Agent 类任务，建议看下 Coding Plan，额度更划算。接入文档在 doc 页面，遇到参数不确定时对照着看。

2.2 Windows 环境检查

Windows 10/11 64 位即可。装之前确认三件事：一是系统盘至少留 5GB 空间；二是安装路径全程纯英文，不能有中文、空格、&、￥这类字符；三是临时关闭杀毒软件和系统防护的实时拦截，因为 OpenClaw 要模拟键鼠、读写文件，容易被误判。装完再开回来。

检查 Node 环境：打开 PowerShell，输入node -v。如果提示找不到命令，去 Node 官网下 LTS 版本装上，装完重开终端再验一次。OpenClaw 的运行依赖 Node 18 以上。

2.3 苹果系统环境检查

macOS 12 以上，Intel 和 Apple Silicon 都行。苹果这边多一步：如果从非 App Store 来源下载，首次打开会被 Gatekeeper 拦。解决方式是右键点应用选“打开”，或在“系统设置 → 隐私与安全性”里点“仍要打开”。

终端里同样验node -v。苹果系统自带终端够用，也可以用 iTerm2。Homebrew 用户可以直接brew install node，比手动下载省事。

3. 可复制的 config.toml 与 settings.json 配置

3.1 config.toml 骨架

OpenClaw 的主配置是config.toml，放在用户目录下的.openclaw文件夹里。Windows 路径是C:\Users\你的用户名\.openclaw\config.toml，macOS 是/Users/你的用户名/.openclaw/config.toml。没有这个文件夹就手动建一个。

# OpenClaw 主配置骨架 [gateway] host = "127.0.0.1" port = 18789 # 本地回环地址，不要改成 0.0.0.0，避免暴露到局域网 [model] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "sk-你的TaoToken密钥" model_name = "gpt-4o-mini" # 模型名按 TaoToken 文档里支持的写，换模型只改这一行 [agent] workspace = "D:/OpenClaw/workspace" # Windows 用正斜杠或双反斜杠；macOS 写 /Users/你的用户名/OpenClaw/workspace max_steps = 20 # 单条指令最多拆多少步，新手 20 够用，太大容易跑飞 [security] allow_shell = false # 先关掉 shell 执行，确认稳定后再按需打开 allow_file_write = true

几个参数说明：base_url填 TaoToken 的 API 地址，注意不要带多余路径；api_key就是控制台生成的那串；workspace是虾干活的目录，建议单独建一个，别直接指到系统盘根目录。max_steps控制任务拆解上限，防止一条模糊指令让它无限循环。

3.2 settings.json 示例

settings.json管的是界面和运行时行为，和config.toml放同一目录。

{ "ui": { "language": "zh-CN", "theme": "light", "show_gateway_status": true }, "runtime": { "auto_start_gateway": true, "log_level": "info", "log_dir": "./logs" }, "tools": { "browser": { "enabled": true, "headless": false }, "file": { "enabled": true, "max_file_size_mb": 50 } } }

headless设成false是为了第一次调试时能看到浏览器动作，确认没问题再改true后台跑。log_level保持info，出问题时改成debug能看到更细的调用链。

3.3 两个文件的配合关系

简单说，config.toml决定虾连哪个模型、在哪干活、权限多大；settings.json决定界面长什么样、日志记多细、哪些工具开着。改完任一文件都要重启 Gateway 才生效，这点后面验证环节会再提。

4. 启动验证与首次成功请求

4.1 启动 Gateway

Windows 上，进入解压后的目录，双击启动程序，或者在 PowerShell 里执行：

cd D:\OpenClaw .\openclaw.exe gateway start

macOS 上：

cd ~/OpenClaw ./openclaw gateway start

启动后终端会打印监听地址和端口，看到Gateway listening on 127.0.0.1:18789就说明服务起来了。第一次启动会初始化依赖，等 1 到 3 分钟属正常，别急着关窗口。

4.2 验证模型连通

新开一个终端，用 curl 打一下模型端点，确认 Key 和地址没问题：

curl https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的TaoToken密钥" \ -H "Content-Type: application/json" \ -d '{ "model": "gpt-4o-mini", "messages": [{"role": "user", "content": "回复两个字：在线"}] }'

返回 JSON 里choices[0].message.content是“在线”，说明模型侧通了。如果返回 401，是 Key 错了；返回 404，多半是base_url多写了或漏写了/v1，对照接入文档核对。

4.3 发第一条真实指令

回到 OpenClaw 主界面，右上角显示 Gateway 在线后，在底部输入框发一条低风险指令试水：

帮我列出 workspace 目录下所有文件，按修改时间从新到旧排序，输出成列表。

这条指令只读不写，适合验证文件工具是否正常。执行完界面会显示文件列表，日志里能看到工具调用记录。确认无误后，再试写操作，比如“在 workspace 下新建一个 notes 文件夹，把桌面上的 txt 文件复制进去”。

5. 本篇常见报错排查

5.1 Gateway 一直离线

先看终端有没有报错。最常见原因是端口被占，换一个端口，改config.toml里的port，重启。其次是配置文件语法错，TOML 对引号和括号敏感，用在线 TOML 校验器过一遍。第三是杀毒软件把进程拦了，临时关掉再启。

5.2 模型调用返回 401 或 403

九成是 Key 问题。检查api_key有没有多余空格，有没有把控制台里别的字段误填进来。如果 Key 刚生成，等十几秒再试，有时有同步延迟。403 还可能是模型名写错，TaoToken 文档里列了可用模型，照着填。

5.3 路径含中文导致启动失败

Windows 上这个坑最多。报错通常是“invalid path”或直接闪退。把安装目录和 workspace 都改成纯英文，比如D:\OpenClaw，别用“软件”“小龙虾”这类中文名。macOS 相对宽松，但也建议全英文路径，省得后面接工具时出幺蛾子。

5.4 第一次启动卡在加载中

正常现象，别慌。它在下载和初始化依赖。如果超过 5 分钟还没动静，看日志目录里的最新日志，通常是网络问题导致依赖拉取失败。换个网络环境重试，或者手动把依赖包放到指定目录。

5.5 指令执行到一半停住

多半是max_steps到了上限。把值调大，或者把指令拆得更具体。比如“整理下载文件夹”太模糊，改成“把下载文件夹里所有 jpg 按年月建文件夹归类”，步骤清晰，虾就不容易迷路。

6. 后续怎么把虾养得更顺手

跑通第一次之后，建议先把allow_shell保持关闭，用文件类和浏览器类工具跑一周，熟悉它的行为边界。等你知道它会在什么情况下调用什么工具了，再逐步放开权限。

模型方面，日常轻量任务用便宜的小模型就够，遇到复杂推理再切大模型，改config.toml里model_name一行即可，不用重装。想验证不同模型效果，直接在模型对话页面切换着试，比反复改配置快。

长期跑编码和 Agent 任务的话，Coding Plan 的额度模型更适合，省得频繁盯着用量。接入过程中遇到参数问题，API Keys 页面和接入文档是两个最该先翻的地方。虾养活了，接下来就是慢慢调教它干更多活。