Clawdbot 整合 Qwen3-32B 本地部署与 Web 访问指南

此时终端会输出类似：

INFO[0000] Clawdbot v0.4.2 starting...
INFO[0000] Ollama API endpoint: http://127.0.0.1:11434
INFO[0000] Web server listening on :8080

表示 Clawdbot 已就绪，正在将 http://localhost:8080 的所有请求，代理至 Ollama 的 /api/chat 接口。

2.3 验证基础链路是否通畅

别急着打开浏览器，先用命令行快速验证三层通路是否闭环：

# 1. 检查 Ollama 是否响应
curl -s http://127.0.0.1:11434/api/tags | jq '.models[].name' | grep qwen3

# 2. 检查 Clawdbot 是否转发成功（模拟一次聊天请求）
curl -s http://127.0.0.1:8080/api/chat \
  -H "Content-Type: application/json" \
  -d '{ "model": "qwen3:32b", "messages": [{"role": "user", "content": "今天天气怎么样？"}], "stream": false }' | jq -r '.message.content'

如果第二条命令返回了合理回答（例如'我无法获取实时天气信息，但你可以告诉我你所在的城市…'），恭喜你——模型、网关、协议三者已完全打通。

3. 代理配置：让 Web 访问真正'直连'

很多教程到这里就结束了，但实际使用中你会发现：浏览器直接访问 http://localhost:8080 是可以的，但一旦想用手机扫码、让同事远程访问、或嵌入到内部系统里，就会卡在跨域、端口暴露、HTTPS 等问题上。

Clawdbot 原生支持'网关模式'，即把 8080 端口的流量，无缝映射到另一个更友好的端口（比如 18789），同时自动注入 CORS 头、禁用缓存、适配长连接流式响应——这才是真正面向使用的配置。

3.1 启动带网关的 Clawdbot 实例

关闭上一步的进程（Ctrl+C），重新运行，加入网关参数：

./clawdbot \
  --ollama-url http://127.0.0.1:11434 \
  --port 8080 \
  --gateway-port 18789 \
  --gateway-host 0.0.0.0 \
  --cors-allowed-origins "*" \
  --enable-streaming

参数说明：

• --gateway-port 18789：对外暴露的 Web 端口，比 8080 更不易被占用，也避开常见扫描端口
• --gateway-host 0.0.0.0：允许局域网内其他设备访问（如手机、同事电脑）
• --cors-allowed-origins "*"：解决前端跨域问题，开发阶段可设为 *，生产环境建议指定域名
• --enable-streaming：开启流式响应，让文字像打字一样逐字出现，体验更自然

启动后，你会看到新增日志：

INFO[0000] Gateway server listening on [::]:18789
INFO[0000] CORS enabled for origins: [*]

3.2 局域网访问与防火墙放行（可选）

如果你的系统启用了防火墙（如 Ubuntu 的 ufw），需手动放行 18789 端口：

sudo ufw allow 18789
sudo ufw reload

然后，在同一局域网下的任意设备（手机、平板、另一台电脑）浏览器中输入：

http://<你的电脑 IP>:18789

如何查本机 IP？

• Linux：hostname -I | awk '{print $1}'
• macOS：ipconfig getifaddr en0

例如，若输出 192.168.3.12，就在手机浏览器输入 http://192.168.3.12:18789 —— 页面将立即加载，无需任何额外配置。

小技巧：用 npx localtunnel --port 18789 可临时生成公网 URL（如 https://xxx.loca.lt），方便远程演示，无需配置路由器端口映射。

4. Web 访问全流程：从打开页面到首次对话

现在，真正的'用户旅程'才开始。我们不再讲命令行，而是站在使用者视角，走完每一步。

4.1 首次打开页面：简洁即力量

访问 http://localhost:18789（或你的局域网 IP），你会看到一个干净的单页应用：顶部是标题