企业官网建设流程全解析

1. 先搞清楚 OpenClawan 到底在装什么

OpenClawan 是一套跑在你自己设备上的个人 AI 助手网关，核心是一个叫 Gateway 的本地服务，默认监听ws://127.0.0.1:18789。它把通讯渠道（Telegram、Slack、Discord、WebChat 等）、AI 智能体（Agent）、命令行工具、浏览器控制串在一起，你通过已经习惯的聊天窗口就能指挥它干活。适合谁？适合想把 AI 助手私有化、又不想被某个云端平台绑死的开发者，尤其是需要多智能体分工（一个写代码、一个查资料、一个管日程）的人。

很多人第一次装 OpenClawan 会卡在三个地方：Node 版本不够、Gateway 起不来、配置文件格式写错。这篇安装指南按「架构讲解 → 安装 → 配置对话终端 → 多智能体 → 技能安装 → 故障排除」的顺序走一遍，每一步都给可复制的命令和配置骨架。我试过在 macOS 和 WSL2 上各跑一遍，下面这套流程基本能一次过。

先看架构，理解了后面配置就不容易懵：

WhatsApp / Telegram / Slack / Discord / WebChat │ ▼ ┌───────────────────────┐ │ Gateway (控制平面) │ │ ws://127.0.0.1:18789 │ └───────────┬───────────┘ │ ┌───────────┼───────────┬──────────────┐ ▼ ▼ ▼ ▼ AI Agent CLI 命令行 WebChat 页面 浏览器控制(CDP)

Gateway 是唯一的核心，所有渠道消息都先到它这里，再由它分发给对应的 Agent。Workspace 是 Agent 的工作目录，它读上下文、存记忆、执行工具操作都在这里发生。记住这两点，后面openclaw.json里为什么有agents和channels两块就清楚了。

2. 安装前置：Node 版本与 TaoToken 接入准备

系统要求很硬：Node.js ≥ 22，这是必须的，低于这个版本 Gateway 会直接报错退出。操作系统支持 macOS、Linux、Windows（走 WSL2）。包管理器用 npm、pnpm 或 bun 都行。

安装命令三选一：

# macOS / Linux 一键脚本 curl -fsSL https://openclaw.ai/install.sh | bash # Windows PowerShell iwr -useb https://openclaw.ai/install.ps1 | iex # npm 全局安装 npm install -g openclaw@latest

装完跑引导，它会帮你生成初始配置并注册系统服务：

# 完整安装引导 + 安装系统服务 openclaw onboard --install-daemon # 只跑配置引导 openclaw onboard

检查是否装好：

openclaw gateway status openclaw dashboard

模型接入这块，OpenClawan 本身不绑定某一家模型服务，你可以把模型请求指向兼容 OpenAI 协议的服务。TaoToken 提供的就是这种兼容接口，官网在 https://taotoken.net/?utm_source=taotoken_aicg_blog_end&utm_medium=csdn&utm_campaign=rewrite&utm_content= ，API 端点是 https://taotoken.net/api 。先在控制台建一个 Key，后面填进配置里：

• 模型对话入口：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite
• API Keys 管理：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite
• 接入文档：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

注意：Key 只存在本地~/.openclaw/credentials/目录，别提交到 Git，也别贴进聊天记录。

3. 可复制配置：openclaw.json 骨架与对话终端

核心配置文件是~/.openclaw/openclaw.json，用 JSON5 格式，支持注释和尾随逗号，这点比纯 JSON 友好。先给一份最小可跑骨架：

{ "agents": { "defaults": { "workspace": "~/.openclaw/workspace", "model": { "primary": "anthropic/claude-sonnet-4-5", "fallbacks": ["openai/gpt-5.2"] }, "heartbeat": { "every": "30m", "target": "last" } } }, "channels": { "telegram": { "enabled": true, "botToken": "123456:ABC...", "dmPolicy": "pairing", "allowFrom": ["tg:123456789"] } }, "session": { "dmScope": "per-channel-peer", "reset": { "mode": "daily", "atHour": 4, "idleMinutes": 120 } } }

Workspace 目录结构长这样，建议先建好：

~/.openclaw/ ├── openclaw.json # 主配置 ├── workspace/ # 默认工作空间 │ ├── AGENTS.md # 操作指令和记忆 │ ├── SOUL.md # 人格、边界、语气 │ ├── TOOLS.md # 工具使用笔记 │ ├── USER.md # 用户信息 │ ├── MEMORY.md # 长期记忆（仅主会话加载） │ └── skills/ # 工作空间级技能 ├── agents/ # 多智能体会话存储 ├── skills/ # 全局技能 └── credentials/ # 凭证存储

对话终端（Channels）的 DM 安全策略必须选对，这是最容易出事的地方：

Telegram 配置示例，streaming设成partial可以让回复边生成边显示：

{ "channels": { "telegram": { "enabled": true, "botToken": "your-bot-token", "dmPolicy": "pairing", "allowFrom": ["tg:123456789"], "streaming": "partial" } } }

4. 多智能体配置与技能安装

多智能体是 OpenClawan 比较有意思的部分，你可以给不同任务配不同的 Agent，各自有独立 workspace，互不干扰：

{ "agents": { "defaults": { "workspace": "~/.openclaw/workspace" }, "list": [ { "id": "main", "description": "通用助手" }, { "id": "coder", "workspace": "~/.openclaw/workspace-coder", "description": "编程专家" } ] } }

技能系统用来扩展能力，通过 ClawHub CLI 从 clawhub.com 安装。先装 CLI：

npm install -g clawhub

搜索和安装：

# 搜索 clawhub search "postgres backups" clawhub search "image generation" # 安装最新版 clawhub install baoyu-image-gen # 安装指定版本 clawhub install baoyu-image-gen --version 1.2.3

技能管理命令对照：

常用推荐技能：

技能本质是一个文件夹，里面SKILL.md定义能力和使用说明，其他文件是脚本和配置。装完后 OpenClawan 会自动识别，任务触发时自动调用，不用额外配置。想发布自己的技能：

clawhub login clawhub publish ./my-skill \ --slug my-skill \ --name "My Skill" \ --version 1.0.0 \ --changelog "Initial release"

5. 验证请求与成功结果

配置写完别急着用，先跑一轮验证。启动 Gateway：

# 前台运行，适合调试 openclaw gateway --port 18789 --verbose # 守护进程后台运行 openclaw gateway start

打开控制面板：

openclaw dashboard # 或浏览器直接访问 http://127.0.0.1:18789

发送测试消息：

openclaw message send --to +15555550123 --message "Hello from OpenClaw"

和智能体对话：

openclaw agent --message "帮我总结今天的会议" --thinking high

成功的话你会看到：Gateway 状态显示 running，dashboard 页面能打开，测试消息出现在目标渠道，agent 命令返回一段模型生成的文本。如果模型请求走的是 TaoToken 的兼容接口，返回内容正常就说明 Key 和端点都通了。想单独验证模型连通性，可以直接用模型对话页面发一条：https://taotoken.net/models?utm_source=taotoken_aicg_blog_end&utm_content=model_chat&utm_campaign=rewrite

常用 CLI 命令清单，建议存一份：

# Gateway 管理 openclaw gateway status openclaw gateway start openclaw gateway stop openclaw gateway restart # 配置管理 openclaw onboard openclaw config get agents.defaults.workspace openclaw config set agents.defaults.model.primary "openai/gpt-5.2" # 诊断工具 openclaw doctor openclaw doctor --fix openclaw logs --follow

6. 本篇常见错排查

Config validation failed：配置格式错误。JSON5 虽然宽松，但括号和引号还是要配对。跑openclaw doctor会指出具体哪一行。改完重启 Gateway。

Unauthorized：API Key 无效。检查credentials/目录下的凭证，确认 Key 没写错、没过期。如果用的是 TaoToken 的 Key，去控制台核对一下：https://taotoken.net/api-keys?utm_source=taotoken_aicg_blog_end&utm_content=api_keys&utm_campaign=rewrite

Session not found：会话已过期。发送/new重置，或者检查session.reset配置里的idleMinutes是不是设太短。

Gateway 起不来，端口被占：换端口openclaw gateway --port 18790，或者先openclaw gateway stop再启动。

技能装了但没生效：确认技能装在正确的 workspace 下，clawhub list能看到。有些技能需要额外配置 API Key，看SKILL.md里的说明。

Node 版本报错：node -v确认 ≥ 22，低了就升级。WSL2 用户注意别装成 Windows 侧的 Node。

安全上再强调一句：永远不要在未经保护的情况下公开 DM，用dmPolicy: "pairing"或allowlist，多用户环境加沙箱：

{ "agents": { "defaults": { "sandbox": { "mode": "non-main", "scope": "agent" } } } }

长期跑编码类任务或者多智能体协作，可以考虑 Coding Plan 来管理模型调用额度：https://taotoken.net/coding-plan?utm_source=taotoken_aicg_blog_end&utm_content=coding_plan&utm_campaign=rewrite 。接入细节和参数说明都在文档里：https://taotoken.net/doc?utm_source=taotoken_aicg_blog_end&utm_content=doc&utm_campaign=rewrite

排障时优先跑openclaw doctor --fix，大部分配置问题它能自动修。日志用openclaw logs --follow实时看，报错信息通常很直白。