OpenClaw AI助手本地部署完整教程
<h1><span style="font-size: 14px">换了套本地AI工具，叫OpenClaw。用了一段时间，稳定性不错，扩展性也比我预期的好用。顺手整理了份部署教程，给想尝鲜的朋友参考。</span></h1><h2>一、什么是OpenClaw</h2>
<p>OpenClaw是一个本地的AI助手框架，核心能力是<strong>多Agent协作</strong>。</p>
<p>你可以把它理解成：一个Gateway（网关） + 多个专业Agent（专家）。每个Agent专注一个领域——写作、编程、表格处理——你通过自然语言分配任务，Agent之间可以互相通信、协同完成复杂工作。</p>
<p>和单纯的聊天机器人比，OpenClaw的优势在于：</p>
<ul>
<li><strong>数据本地化</strong>：所有数据都在自己机器上，不用担心上传到第三方服务器</li>
<li><strong>多Agent并行</strong>：不同任务分配给不同专家，各干各的，互不干扰</li>
<li><strong>工作区隔离</strong>：每个Agent有独立的文件目录和记忆存储，不会串台</li>
<li><strong>插件生态</strong>：支持扩展，能对接各种外部服务</li>
</ul>
<h2>二、环境准备</h2>
<h3>Node.js（必须）</h3>
<p>OpenClaw基于Node.js运行，要求版本18以上。建议用nvm管理版本：</p>
<pre><code># Linux/macOS 安装nvm
curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.40.0/install.sh | bash
# 安装Node.js 22
nvm install 22
nvm use 22
# 验证
node -v</code></pre>
<h3>pnpm（必须）</h3>
<pre><code>npm install -g pnpm</code></pre>
<h3>Docker（建议安装）</h3>
<pre><code># Ubuntu/Debian
sudo apt update
sudo apt install docker.io docker-compose
sudo systemctl start docker
sudo systemctl enable docker
docker --version</code></pre>
<h3>AI模型API密钥（必须）</h3>
<p>至少准备一个AI模型的API密钥。推荐Anthropic（Claude系列）或OpenAI（GPT-4系列）。</p>
<h2>三、安装步骤</h2>
<h3>1. 安装CLI工具</h3>
<pre><code>npm install -g openclaw
openclaw --version</code></pre>
<h3>2. 初始化配置</h3>
<pre><code>openclaw init</code></pre>
<h3>3. 配置API密钥</h3>
<p>编辑 <code>~/.openclaw/config.yaml</code>：</p>
<pre><code>models:
default: claude-3-5-sonnet
providers:
anthropic:
api_key: sk-ant-xxxxx-your-key-here</code></pre>
<h3>4. 启动服务</h3>
<pre><code>openclaw gateway start</code></pre>
<p>访问 <code>http://localhost:3000</code> 登录即可。</p>
<h2>四、配置多Agent</h2>
<h3>创建写作Agent工作区</h3>
<pre><code>mkdir -p ~/.openclaw/workspace-writer</code></pre>
<h3>注册Agent</h3>
<p>编辑 <code>~/.openclaw/config.yaml</code>：</p>
<pre><code>agents:
writer:
name: 小文
model: claude-3-5-sonnet
workspace: workspace-writer
description: 写作专家</code></pre>
<h3>启动并使用</h3>
<pre><code>openclaw agent start writer
# Web界面左侧选择"小文"即可对话</code></pre>
<h2>五、常见问题</h2>
<h3>Q1: 端口被占用？</h3>
<p>修改config.yaml中的端口为其他端口（如4000），然后重启Gateway。</p>
<h3>Q2: API返回401？</h3>
<p>检查API密钥是否正确，保存后执行 <code>openclaw gateway restart</code>。</p>
<h3>Q3: Agent离线？</h3>
<pre><code>openclaw agent logs writer
openclaw agent stop writer
openclaw agent start writer</code></pre>
<h3>Q4: 升级OpenClaw？</h3>
<pre><code>npm update -g openclaw
openclaw gateway restart</code></pre>
<h2>六、写在最后</h2>
<p>OpenClaw部署本身不复杂，跟着教程走一般没问题。真正值得琢磨的是<strong>多Agent协作的使用场景</strong>——当你习惯了把任务拆分、分配给不同的专业Agent来处理，效率提升会很明显。有问题多查官方文档，去折腾吧。</p><br><br>
来源：https://www.cnblogs.com/chenjinhai/p/19827217
頁:
[1]