Clawdbot 是一款运行于本地服务器的 AI 网关，支持多平台消息接入与企业微信集成。本文档涵盖从命令行验证、Web 控制台调试到 RESTful API、Webhook 事件驱动及 TypeScript/Python SDK 的全栈接入流程。重点说明如何配置网关令牌、调用本地模型（如 Ollama）、管理会话上下文以及通过插件系统扩展业务逻辑。所有数据存储在本地，确保隐私合规，适合需要私有化部署 AI 能力的开发团队快速落地智能助手应用。
Clawdbot 现已正式支持企业微信入口，这意味着你不仅能在 WhatsApp、Telegram、Discord 中与 AI 助手无缝对话，还能将智能服务深度集成进国内最主流的企业协作平台——企业微信。无需额外开发中间层，开箱即用的标准化接入能力，让团队内部知识问答、客服响应、流程自动化真正落地。
Clawdbot 就是一个你可以随时跟 AI 对话的智能助手，就像 ChatGPT 一样，但是： （支持 WhatsApp、Telegram、Discord、企业微信等） （使用你自己的 AI 模型，不依赖云端 API） （所有聊天记录、会话状态、配置文件均存储在你本地服务器） （开机自动启动，断网不中断，无外部依赖）
网关令牌为 dev-test-token，这是你访问 Web 控制台和调用 RESTful 接口的统一身份凭证。
Clawdbot 的本质，是一个可嵌入、可扩展、可自治的本地 AI 网关。它不是 SaaS 服务，而是一套运行在你物理或虚拟服务器上的完整软件栈，由三部分组成：
它不卖算力，不收订阅费，也不上传你的数据——你拥有全部控制权。开发者能改配置、换模型、加插件、写钩子；运维能看日志、设告警、做备份；业务方能直接在微信里问'上季度华东区销售额 TOP3 产品是什么'，AI 自动查数据库、生成图表、发群消息。
别被'全栈接入'吓到。Clawdbot 的设计哲学是：先跑通，再扩展。我们从最轻量的方式开始——终端直连。
打开终端，执行：
ps aux | grep clawdbot-gateway
如果看到类似输出，说明网关正在后台运行：
root 133175 0.8 2.1 1245678 89234 ? Ssl Jan10 12:45 node dist/index.js gateway
提示：Clawdbot 默认随系统启动，脚本位于
/root/start-clawdbot.sh，你也可以手动运行它。
若未运行，请执行：
bash /root/start-clawdbot.sh
该脚本会自动拉起网关、检查依赖、加载配置，并输出监听地址（通常是 http://0.0.0.0:18789）。
进入项目目录并发送第一条测试消息：
cd /root/clawdbot && node dist/index.js agent --agent main --message "你好，我是开发者"
预期返回类似内容：
{"id":"sess_abc123","role":"assistant","content":"你好！很高兴为你服务。我可以帮你写代码、查资料、总结文档，或者只是聊聊天。需要我做什么？"}
成功！这表示：
ollama/qwen2:1.5b）Clawdbot 支持三种对话方式，按开发介入程度由浅入深排列。我们推荐你按顺序体验，逐步建立对系统架构的理解。
这是最'裸'的调用方式，也是理解底层逻辑的起点。所有参数都通过 CLI 显式传递，没有隐藏行为。
# 发起新会话并提问
node dist/index.js agent --agent main --message "用 Python 写一个读取 CSV 并统计每列空值数量的脚本"
# 延续同一会话（AI 记得前文）
node dist/index.js agent --agent main --session-id sess_abc123 --message "把上面的脚本改成支持 Excel 格式"
# 指定思考强度（影响响应速度与质量平衡）
node dist/index.js agent --agent main --message "对比 Llama3 和 Qwen2 在中文长文本摘要任务上的优劣" --thinking high
当你要把 AI 输出喂给另一个系统时，JSON 是唯一可靠格式：
node dist/index.js agent --agent main --message "列出中国五大一线城市及 2023 年 GDP（单位：亿元），按 GDP 降序排列" --json
返回示例（真实可解析）：
{
"cities": [
{"name": "上海", "gdp": 47218},
{"name": "北京", "gdp": 43760},
{"name": "深圳", "gdp": 34602},
{"name": "广州", "gdp": 30355},
{"name": "重庆", "gdp": 30144}
]
}
开发者提示：
--json参数强制启用结构化模式，AI 会严格遵循 JSON Schema 输出，避免自由发挥导致解析失败。
浏览器访问 http://你的服务器 IP:18789，输入令牌 dev-test-token 即可进入图形界面。
这里不只是聊天窗口，更是实时调试中心：
Clawdbot 本次重大更新，原生支持企业微信应用接入。无需第三方中转，全程走官方 API。
第一步：在企业微信管理后台创建应用
第二步：配置 Clawdbot 企业微信适配器
cd /root/clawdbot && node dist/index.js wecom pair
按提示依次输入：
第三步：发布并授权
效果：员工发送'查报销进度'，AI 自动调用你公司的 OA 接口；发送'生成周报'，AI 从飞书多维表格拉取数据生成 Markdown 报告。
当你需要将 Clawdbot 深度集成进自有系统时，CLI 和 Web 界面就不再够用。下面才是真正的'开发者友好'部分。
Clawdbot 网关暴露了一组符合 OpenAPI 3.0 规范的 REST 接口，根地址为 http://你的服务器 IP:18789/api/v1。
| 方法 | 路径 | 用途 | 鉴权方式 |
|---|---|---|---|
POST | /chat/completions | 标准 OpenAI 兼容接口 | Bearer Token (dev-test-token) |
POST | /agents/main/chat | Clawdbot 原生接口（支持 session、thinking 等） | Bearer Token |
GET | /agents/main/sessions | 获取会话列表 | Bearer Token |
GET | /agents/main/sessions/{id} | 获取单个会话历史 | Bearer Token |
POST | /webhooks/trigger | 手动触发 Webhook（用于测试） | Bearer Token |
curl -X POST "http://192.168.1.100:18789/api/v1/agents/main/chat" \
-H "Authorization: Bearer dev-test-token" \
-H "Content-Type: application/json" \
-d '{ "message": "用 Node.js 写一个 Express 中间件，记录每个请求的耗时", "thinking": "medium", "session_id": "sess_dev_2024" }'
响应结构与 CLI 完全一致，确保前后端行为一致。
Clawdbot 支持双向 Webhook：既可接收外部系统推送（如 CRM 新线索），也能向你的服务推送事件（如用户提问、AI 回复完成）。
编辑 /root/.clawdbot/clawdbot.json，添加：
{
"webhooks": {
"incoming": {
"url": "https://your-api.com/clawdbot/incoming",
"method": "POST",
"headers": {
"X-API-Key": "your-secret-key"
}
}
}
}
Clawdbot 会在收到新消息时，以 application/json 格式推送：
{
"event": "message_received",
"channel": "wecom",
"user_id": "zhangsan",
"content": "帮我查一下客户王五的合同到期日",
"timestamp": "2024-01-26T09:30:45Z"
}
同样在配置文件中设置：
{
"webhooks": {
"outgoing": {
"url": "https://your-api.com/clawdbot/outgoing",
"method": "POST",
"headers": {
"X-API-Key": "your-secret-key"
}
}
}
}
AI 生成回复后，Clawdbot 会推送：
{
"event": "message_sent",
"channel": "wecom",
"user_id": "zhangsan",
"content": "客户王五的合同将于 2024 年 6 月 30 日到期。",
"session_id": "sess_dev_2024",
"latency_ms": 2340,
"model": "ollama/qwen2:1.5b"
}
关键优势：Webhook 事件包含完整上下文（渠道、用户、会话 ID、模型名、延迟），你无需自己维护映射关系。
Clawdbot 提供开箱即用的 SDK，屏蔽网络、鉴权、重试、序列化等细节。
import { ClawdbotClient } from '@clawdbot/sdk';
const client = new ClawdbotClient({
baseUrl: 'http://192.168.1.100:18789',
token: 'dev-test-token',
});
// 发送消息并获取结构化响应
const response = await client.chat.send({
message: '用 Python 生成一个斐波那契数列前 20 项',
thinking: 'low',
sessionId: 'sess_web_001'
});
console.log(response.content); // 直接拿到字符串结果
console.log(response.json?.code); // 如果启用了 --json，可安全访问 code 字段
from clawdbot import ClawdbotClient
client = ClawdbotClient(
base_url="http://192.168.1.100:18789",
token="dev-test-token"
)
# 同步调用
resp = client.chat.send(
message="把下面这段 SQL 改成支持分页的版本：SELECT * FROM users",
thinking="medium"
)
print(resp.content) # 异步调用（支持 asyncio）
import asyncio
async def main():
resp = await client.chat.async_send(
message="分析这个错误日志：Connection refused",
json=True
)
print(resp.json)
asyncio.run(main())
SDK 源码与文档托管于 github.com/clawdbot/sdk，支持 npm/pip 直接安装。
| 环节 | 检查命令 | 常见问题 | 解决方案 |
|---|---|---|---|
| Node.js 环境 | node -v && npm -v | 版本低于 18.x | `curl -fsSL https://deb.nodesource.com/setup_lts.x |
| Ollama 是否运行 | systemctl is-active ollama | 未启动或崩溃 | sudo systemctl start ollama && sudo systemctl enable ollama |
| 端口冲突 | sudo lsof -i :18789 | 18789 被占用 | 修改 /root/.clawdbot/clawdbot.json 中 gateway.port 字段 |
Clawdbot 的智能体不是黑盒。你可以通过两个层面注入领域知识：
编辑 /root/clawd/IDENTITY.md：
- Name: 小智（财务版）
- Role: 公司财务部 AI 助理
- Knowledge: 熟悉《企业会计准则》、SAP 财务模块操作、增值税申报流程
- Rules:
- 所有回答必须引用具体条款编号（如'依据财会〔2017〕22 号第 X 条'）
- 不猜测不确定的数据，明确说'需查询系统'
- 金额单位统一为'万元'，保留两位小数
重启网关后，AI 会严格遵循此设定。
在 /root/clawd/plugins/ 下新建 finance.js：
module.exports = {
name: 'finance',
description: '查询财务数据',
handler: async (params) => {
const res = await fetch('https://your-sap-api.com/financials', {
method: 'POST',
headers: {
'Authorization': 'Bearer ' + process.env.SAP_TOKEN
},
body: JSON.stringify(params)
});
return res.json();
}
};
然后在聊天中触发：
@小智 查询张三 2023 年差旅报销总额 → AI 自动识别意图，调用 finance 插件，返回结构化数据。
Clawdbot 汉化版不是又一个玩具项目，而是面向生产环境设计的 AI 接入基础设施。它解决了开发者在落地 AI 时最痛的三个问题：
你不需要成为大模型专家，也能让 AI 成为团队的生产力倍增器。Clawdbot 把复杂留给自己，把简单交给用户。
微信公众号「极客日志」，在微信中扫描左侧二维码关注。展示文案：极客日志 zeeklog
生成新的随机RSA私钥和公钥pem证书。 在线工具，RSA密钥对生成器在线工具，online
基于 Mermaid.js 实时预览流程图、时序图等图表，支持源码编辑与即时渲染。 在线工具，Mermaid 预览与可视化编辑在线工具，online
查找任何按下的键的javascript键代码、代码、位置和修饰符。 在线工具，Keycode 信息在线工具，online
JavaScript 字符串转义/反转义；Java 风格 \uXXXX（Native2Ascii）编码与解码。 在线工具，Escape 与 Native 编解码在线工具，online
使用 Prettier 在浏览器内格式化 JavaScript 或 HTML 片段。 在线工具，JavaScript / HTML 格式化在线工具，online
Terser 压缩、变量名混淆，或 javascript-obfuscator 高强度混淆（体积会增大）。 在线工具，JavaScript 压缩与混淆在线工具，online