企业官网建设流程全解析

1. 先搞清楚 OpenClaw 到底在跑什么

OpenClaw 是一个可以部署在本地机器或云服务器上的开源 AI Agent 框架，核心由三块组成：Gateway 负责通信调度，Dashboard 提供可视化控制台，Skills 则是 Agent 能调用的能力插件集合。它和普通聊天工具最大的区别在于运行位置和权限边界——普通工具跑在云端、权限受限、不能持久执行；OpenClaw 跑在你自己的环境里，能读写文件、调用系统命令、请求外部 API，还能长时间后台运行。这意味着它适合想真正把 Agent 用起来的人：需要自动化处理本地任务、想接入自己的业务系统、或者要做一个能持续干活的执行体。但也正因为权限高，部署方式必须认真对待，不建议直接装在日常办公电脑上，独立服务器或容器隔离环境才是正确姿势。这篇就按从零到跑通的顺序，把 Node.js 和 Docker 两条路都走一遍，配置骨架直接给，报错排查也一并列出来。

2. 部署前先把 TaoToken 通道准备好

OpenClaw 本身是框架，它要调用大模型能力才能让 Agent 真正干活。这里我用 TaoToken 作为统一的模型接入通道，好处是一个 Key 可以覆盖多种模型，不用在配置文件里来回换不同厂商的地址和密钥。你需要先去官网注册并拿到 API Key，然后确认两件事：一是 Key 有余额或额度，二是你要用的模型名称在文档里有对应说明。

具体操作路径：打开官网 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，注册登录后进入控制台，在 API Keys 页面创建一个新 Key。创建时建议给 Key 起个能识别的名字，比如 openclaw-local，方便后面排查是哪个环境在用。拿到 Key 之后先别急着写进配置，用一条 curl 验证通道是否通：

curl -X POST https://taotoken.net/api/v1/chat/completions \ -H "Authorization: Bearer sk-你的Key" \ -H "Content-Type: application/json" \ -d '{ "model": "claude-3-5-sonnet", "messages": [{"role": "user", "content": "ping"}], "max_tokens": 16 }'

如果返回里有正常的 choices 内容，说明 Key 和网络都没问题。这一步很关键，因为后面 OpenClaw 报错时，你要能区分是框架问题还是通道问题。模型对话的调试入口在 https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，可以在网页上直接试模型是否可用。长期跑编码类 Agent 的话，Coding Plan 页面 https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 有更细的额度说明，按自己用量选就行。

3. Node.js 环境准备与 OpenClaw 安装

3.1 系统基础依赖

以 Ubuntu 22.04 为例，先更新系统并装基础工具：

sudo apt update sudo apt install -y git curl unzip build-essential

build-essential 别省，后面有些 skill 依赖原生模块编译，缺了会报 node-gyp 相关错误。

3.2 安装 Node.js 18+

OpenClaw 要求 Node 18 以上，推荐用 nvm 管理版本，避免和系统自带 Node 冲突：

curl -fsSL https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash source ~/.bashrc nvm install 18 nvm use 18 nvm alias default 18

验证：

node -v # 应输出 v18.x.x npm -v

如果 node -v 还是旧版本，检查 ~/.bashrc 里 nvm 的加载语句是否生效，重新 source 一次。

3.3 安装 OpenClaw CLI

最快的方式是全局安装：

npm install -g openclaw openclaw --version

看到版本号就说明 CLI 装好了。如果你要改源码或写自定义 skill，走源码方式：

git clone https://github.com/openclaw/openclaw.git cd openclaw npm install -g pnpm pnpm install pnpm build

源码方式后续命令前面要加 pnpm，比如 pnpm openclaw onboard。

4. 配置文件骨架与启动验证

4.1 config.toml 骨架

OpenClaw 的配置分两层：全局配置和 Agent 配置。全局配置一般在 ~/.openclaw/config.toml，骨架如下：

[gateway] host = "127.0.0.1" port = 18789 log_level = "info" [model] provider = "openai-compatible" base_url = "https://taotoken.net/api" api_key = "sk-你的Key" default_model = "claude-3-5-sonnet" timeout_seconds = 60 [agent] name = "local-agent" workspace = "/home/youruser/openclaw-workspace" max_concurrent_tasks = 2 [security] allow_shell = false allow_file_write = true allowed_paths = ["/home/youruser/openclaw-workspace"]

几个点要注意：base_url 填 https://taotoken.net/api 即可，不要带多余路径；allow_shell 默认关掉，等确认 Agent 行为可控后再按需开；allowed_paths 一定要限制在工作目录，别写根目录。

4.2 settings.json 骨架

部分 skill 和 Dashboard 会读 settings.json，放在工作目录下：

{ "skills": { "enabled": ["http-request", "file-read"], "disabled": ["shell-exec"] }, "logging": { "level": "info", "file": "./logs/agent.log" }, "dashboard": { "enabled": true, "port": 18790 } }

4.3 初始化与启动

配置写好后执行 onboarding：

openclaw onboard --install-daemon

这一步会初始化 Gateway、生成本地配置、注册后台服务。完成后检查状态：

openclaw gateway status

正常输出包含 running、healthy、listening on port 18789。如果没起来，直接看日志：

openclaw gateway logs

启动 Dashboard：

openclaw dashboard

浏览器访问 http://127.0.0.1:18790，能看到 Agent 状态、会话记录、Skills 管理和 Gateway 连接情况就说明主链路通了。

5. Docker 方式部署与连通性测试

5.1 Docker 环境准备

服务器上装 Docker：

curl -fsSL https://get.docker.com | sh sudo usermod -aG docker $USER newgrp docker docker --version

5.2 用 Docker 跑 OpenClaw

先建工作目录和配置：

mkdir -p ~/openclaw-docker/{config,workspace,logs}

把上面第 4 节的 config.toml 放到 ~/openclaw-docker/config/ 下，注意 workspace 路径改成容器内路径 /workspace。然后启动容器：

docker run -d \ --name openclaw \ -p 18789:18789 \ -p 18790:18790 \ -v ~/openclaw-docker/config:/root/.openclaw \ -v ~/openclaw-docker/workspace:/workspace \ -v ~/openclaw-docker/logs:/workspace/logs \ --restart unless-stopped \ openclaw/openclaw:latest

查看日志确认启动：

docker logs -f openclaw

看到 gateway listening 和 dashboard ready 就对了。

5.3 连通性测试

不管哪种方式，跑通后做一次端到端验证。在 Dashboard 里新建一个会话，发一条指令让 Agent 读一个文件并总结：

echo "OpenClaw test content" > ~/openclaw-docker/workspace/test.txt

然后在 Dashboard 输入：读取 workspace 下的 test.txt 并告诉我内容。如果 Agent 返回了文件内容，说明模型通道、Gateway、Skill 三层都通了。这一步验证的是 Agent 可控性——它只在你允许的路径下操作，没有越权。

6. 常见报错排查

Gateway 起不来：先看 openclaw gateway logs。最常见的是 Node 版本不对（低于 18）和端口被占用。端口检查用 ss -tlnp | grep 18789，被占用就改 config.toml 里的 port。

Dashboard 打不开：如果是服务器部署，检查防火墙和安全组是否放行了 18790。本地的话确认 dashboard 进程在跑，ps aux | grep dashboard 看一眼。

模型调用返回 401：Key 写错或没带 Bearer 前缀。检查 config.toml 里 api_key 格式，重新用第 2 节的 curl 验证一次通道。

Skill 不生效：先确认 settings.json 里 enabled 列表包含该 skill，然后看日志有没有 schema 校验失败。改完配置要重启 Gateway，openclaw gateway restart。

Agent 行为不可控：检查 security 段，allow_shell 是否误开，allowed_paths 是否范围过大。建议先用只读类 skill 跑通，再逐步放开。

Docker 容器反复重启：docker logs 看具体错误，多半是挂载路径权限问题，给 workspace 目录加写权限：chmod -R 755 ~/openclaw-docker/workspace。

7. 接入文档与后续动作

跑通之后，建议把 Key 管理和接入细节再过一遍。API Keys 页面 https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 可以随时轮换 Key，接入文档 https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 里有各模型的参数说明和兼容格式。如果你要接 Claude Code 这类编码 Agent，参考 https://taotoken.net/claude-code-anthropic?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 的配置方式，base_url 和 Key 的填法跟本文一致。控制台 https://taotoken.net/console?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= 里能看用量和调用记录，排查问题时对照日志时间点很有用。整套跑下来，验收标准就五条：CLI 正常、Gateway running、Dashboard 可访问、至少一个 skill 生效、Agent 能完成一次完整任务。满足这五条，你的 OpenClaw 就算真正搭起来了。