clawmoat 0.7.0 → 1.0.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/.dockerignore +9 -0
- package/CHANGELOG.md +18 -0
- package/CONTRIBUTING.md +4 -2
- package/DEMO.md +87 -0
- package/Dockerfile +5 -18
- package/README.md +294 -8
- package/SECURITY.md +58 -10
- package/THREAT_MODEL.md +129 -0
- package/agent/README.md +131 -0
- package/agent/index.js +471 -0
- package/agent/install-service.sh +94 -0
- package/agent/openclaw-hook.js +453 -0
- package/agent/provider-setup.js +649 -0
- package/agent/setup.js +274 -0
- package/assets/BADGE-USAGE.md +20 -0
- package/assets/clawmoat-badge.svg +21 -0
- package/bin/clawmoat.js +468 -111
- package/docs/affiliates/dashboard.html +124 -0
- package/docs/affiliates/index.html +236 -0
- package/docs/agent-install.html +183 -0
- package/docs/ai-agent-security-scanner.html +10 -6
- package/docs/badge/index.html +149 -0
- package/docs/badge/scanning.svg +23 -0
- package/docs/blog/386-malicious-skills.html +262 -0
- package/docs/blog/40000-exposed-openclaw-instances.html +201 -0
- package/docs/blog/agent-trust-protocol.html +198 -0
- package/docs/blog/ai-agent-earns-commissions.html +230 -0
- package/docs/blog/bugmageddon-agent-firewall.html +174 -0
- package/docs/blog/calculator-math.html +180 -0
- package/docs/blog/clawmoat-vs-llamafirewall-nemo-guardrails.html +229 -0
- package/docs/blog/host-guardian-launch.html +18 -8
- package/docs/blog/ibm-experts-agent-runtime-protection.html +247 -0
- package/docs/blog/index.html +211 -9
- package/docs/blog/langchain-security-tutorial.html +18 -8
- package/docs/blog/mcp-30-cves-security-crisis.html +286 -0
- package/docs/blog/meta-researcher-rogue-agent.html +201 -0
- package/docs/blog/microsoft-openclaw-workstation-security.html +235 -0
- package/docs/blog/nist-ai-agent-standards-clawmoat.html +377 -0
- package/docs/blog/oasis-websocket-hijack.html +212 -0
- package/docs/blog/ollama-openclaw-security.html +160 -0
- package/docs/blog/openclaw-enterprise-readiness-claw10.html +199 -0
- package/docs/blog/openclaw-security-reckoning-2026.html +368 -0
- package/docs/blog/owasp-agentic-ai-top10.html +18 -8
- package/docs/blog/securing-ai-agents.html +18 -8
- package/docs/blog/supply-chain-agents.html +18 -8
- package/docs/business/index.html +525 -0
- package/docs/business/install.html +261 -0
- package/docs/checklist.html +174 -0
- package/docs/compare/index.html +122 -0
- package/docs/compare/lakera/index.html +62 -0
- package/docs/compare/llm-guard/index.html +49 -0
- package/docs/compare/snyk-agent-scan/index.html +63 -0
- package/docs/compare.html +10 -6
- package/docs/dashboard/index.html +520 -0
- package/docs/finance/index.html +220 -0
- package/docs/guides/business-deployment.html +770 -0
- package/docs/hall-of-fame.html +174 -0
- package/docs/index.html +447 -154
- package/docs/install.sh +557 -0
- package/docs/integrations/langchain.html +14 -6
- package/docs/integrations/openai.html +14 -6
- package/docs/integrations/openclaw.html +55 -7
- package/docs/plans/2026-03-26-threat-intel-api.md +255 -0
- package/docs/plans/2026-04-14-bugmageddon-marketing-pack.md +329 -0
- package/docs/plans/2026-04-14-clawmoat-v1-bugmageddon.md +248 -0
- package/docs/plans/2026-04-14-v1-release-update.md +91 -0
- package/docs/plans/2026-04-19-supabase-audit.md +68 -0
- package/docs/plans/2026-05-12-sales-push.md +303 -0
- package/docs/playground/index.html +893 -0
- package/docs/playground.html +4 -7
- package/docs/privacy-policy/index.html +122 -0
- package/docs/rfcs/defense-in-depth.md +467 -0
- package/docs/scan/index.html +358 -0
- package/docs/services/case-study.html +255 -0
- package/docs/services/downloads/install-openclaw.bat +45 -0
- package/docs/services/downloads/install-openclaw.command +38 -0
- package/docs/services/downloads/install-openclaw.sh +38 -0
- package/docs/services/get-started.html +165 -0
- package/docs/services/index.html +598 -0
- package/docs/services/multi-agent-security.html +284 -0
- package/docs/services/one-pager.html +99 -0
- package/docs/services/pitch-deck.html +229 -0
- package/docs/services/roi-calculator.html +258 -0
- package/docs/sitemap.xml +192 -2
- package/docs/support/index.html +135 -0
- package/docs/templates/customer-service/HEARTBEAT.md +61 -0
- package/docs/templates/customer-service/MEMORY.md +89 -0
- package/docs/templates/customer-service/SOUL.md +41 -0
- package/docs/templates/customer-service/USER.md +56 -0
- package/docs/templates/executive/HEARTBEAT.md +86 -0
- package/docs/templates/executive/MEMORY.md +92 -0
- package/docs/templates/executive/SOUL.md +44 -0
- package/docs/templates/executive/USER.md +62 -0
- package/docs/templates/finance/HEARTBEAT.md +58 -0
- package/docs/templates/finance/MEMORY.md +87 -0
- package/docs/templates/finance/SOUL.md +38 -0
- package/docs/templates/finance/USER.md +53 -0
- package/docs/templates/index.html +115 -0
- package/docs/templates/operations/HEARTBEAT.md +63 -0
- package/docs/templates/operations/MEMORY.md +68 -0
- package/docs/templates/operations/SOUL.md +38 -0
- package/docs/templates/operations/USER.md +49 -0
- package/docs/templates/sales/HEARTBEAT.md +55 -0
- package/docs/templates/sales/MEMORY.md +89 -0
- package/docs/templates/sales/SOUL.md +34 -0
- package/docs/templates/sales/USER.md +54 -0
- package/docs/terms-of-service/index.html +122 -0
- package/eslint.config.js +32 -0
- package/evals/README.md +29 -0
- package/evals/cases.json +390 -0
- package/evals/results.md +68 -0
- package/evals/run.js +180 -0
- package/examples/basic-usage.js +38 -0
- package/examples/demo-attack/demo.js +186 -0
- package/examples/python-quickstart/README.md +54 -0
- package/examples/python-quickstart/clawmoat_client.py +167 -0
- package/examples/video-demo/README.md +14 -0
- package/examples/video-demo/scene-a-normal.js +29 -0
- package/examples/video-demo/scene-b-attack-arrives.js +31 -0
- package/examples/video-demo/scene-c-hijack.js +44 -0
- package/examples/video-demo/scene-d-clawmoat.js +46 -0
- package/integrations/crewai/README.md +32 -0
- package/integrations/crewai/clawmoat_crewai/__init__.py +17 -0
- package/integrations/crewai/clawmoat_crewai/guard.py +103 -0
- package/integrations/crewai/pyproject.toml +21 -0
- package/integrations/langchain/README.md +91 -0
- package/integrations/langchain/clawmoat_langchain/__init__.py +17 -0
- package/integrations/langchain/clawmoat_langchain/callback.py +489 -0
- package/integrations/langchain/pyproject.toml +32 -0
- package/integrations/litellm/README.md +324 -0
- package/integrations/litellm/clawmoat_litellm/__init__.py +21 -0
- package/integrations/litellm/clawmoat_litellm/callback.py +329 -0
- package/integrations/litellm/clawmoat_litellm/proxy_middleware.py +224 -0
- package/integrations/litellm/pyproject.toml +74 -0
- package/integrations/openai-agents/README.md +392 -0
- package/integrations/openai-agents/clawmoat_openai_agents/__init__.py +20 -0
- package/integrations/openai-agents/clawmoat_openai_agents/guardrail.py +431 -0
- package/integrations/openai-agents/clawmoat_openai_agents/middleware.py +311 -0
- package/integrations/openai-agents/pyproject.toml +76 -0
- package/package.json +6 -5
- package/plugins/openclaw-adapter/PHASE1.md +439 -0
- package/plugins/openclaw-adapter/README.md +103 -0
- package/plugins/openclaw-adapter/SPEC.md +1644 -0
- package/plugins/openclaw-adapter/package.json +31 -0
- package/plugins/openclaw-adapter/src/index.test.ts +226 -0
- package/plugins/openclaw-adapter/src/index.ts +140 -0
- package/plugins/openclaw-adapter/tsconfig.json +14 -0
- package/server/data/threats.json +290 -0
- package/server/index.js +224 -10
- package/src/adapters/express.js +161 -0
- package/src/adapters/index.js +92 -0
- package/src/adapters/langchain.js +185 -0
- package/src/approval/index.js +456 -0
- package/src/ban-scanner.js +200 -0
- package/src/boundary-scanner.js +296 -0
- package/src/ci-scanner.js +279 -0
- package/src/code-scanner.js +245 -0
- package/src/enforce.js +166 -0
- package/src/finance/index.js +585 -0
- package/src/finance/mcp-firewall.js +486 -0
- package/src/formatters/json.js +80 -0
- package/src/formatters/sarif.js +388 -0
- package/src/guardian/alerts.js +34 -3
- package/src/guardian/gateway-monitor.js +590 -0
- package/src/guardian/index.js +41 -2
- package/src/index.js +105 -0
- package/src/integrations/agentmesh.js +501 -0
- package/src/language-detector.js +201 -0
- package/src/mcp-scanner.js +253 -0
- package/src/multimodal/index.js +579 -0
- package/src/obfuscation-scanner.js +457 -0
- package/src/policy-engine.js +402 -0
- package/src/scanners/dependency-attacks.js +128 -0
- package/src/scanners/prompt-injection.js +18 -0
- package/src/scanners/supply-chain.js +14 -0
- package/src/templates/default-config.yml +90 -0
- package/src/vuln-ops/exploitability.js +46 -0
- package/src/watch/live-monitor.js +720 -0
|
@@ -0,0 +1,770 @@
|
|
|
1
|
+
<!DOCTYPE html>
|
|
2
|
+
<html lang="en">
|
|
3
|
+
<head>
|
|
4
|
+
<link rel="icon" type="image/png" href="/favicon.png">
|
|
5
|
+
<link rel="apple-touch-icon" href="/apple-touch-icon.png">
|
|
6
|
+
<meta charset="UTF-8">
|
|
7
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
8
|
+
<title>Deploy AI Agents for Your Business — The Complete Guide | ClawMoat</title>
|
|
9
|
+
<meta name="description" content="Step-by-step guide to deploying secure AI agents for your business with OpenClaw and ClawMoat. Hardware, software, configuration, security, and team integration.">
|
|
10
|
+
<link rel="canonical" href="https://clawmoat.com/guides/business-deployment.html">
|
|
11
|
+
<meta property="og:title" content="Deploy AI Agents for Your Business — The Complete Guide">
|
|
12
|
+
<meta property="og:description" content="Everything you need to set up autonomous AI agents that handle real work for your company, secured by ClawMoat.">
|
|
13
|
+
<meta property="og:image" content="https://clawmoat.com/og-image.png">
|
|
14
|
+
<meta property="og:url" content="https://clawmoat.com/guides/business-deployment.html">
|
|
15
|
+
<meta property="og:type" content="article">
|
|
16
|
+
<meta name="twitter:card" content="summary_large_image">
|
|
17
|
+
<style>
|
|
18
|
+
*{margin:0;padding:0;box-sizing:border-box}
|
|
19
|
+
:root{--navy:#0F172A;--navy-light:#1E293B;--navy-mid:#334155;--blue:#3B82F6;--emerald:#10B981;--white:#F8FAFC;--gray:#94A3B8;--red:#EF4444;--amber:#F59E0B}
|
|
20
|
+
html{scroll-behavior:smooth}
|
|
21
|
+
body{font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,sans-serif;background:var(--navy);color:var(--white);line-height:1.7;overflow-x:hidden}
|
|
22
|
+
a{color:var(--blue);text-decoration:none}
|
|
23
|
+
a:hover{text-decoration:underline}
|
|
24
|
+
.container{max-width:860px;margin:0 auto;padding:0 24px}
|
|
25
|
+
|
|
26
|
+
nav{position:fixed;top:0;left:0;right:0;z-index:100;background:rgba(15,23,42,.92);backdrop-filter:blur(12px);border-bottom:1px solid rgba(59,130,246,.15);padding:16px 0}
|
|
27
|
+
nav .nav-inner{max-width:1140px;margin:0 auto;padding:0 24px;display:flex;align-items:center;justify-content:space-between}
|
|
28
|
+
.logo{font-size:1.25rem;font-weight:700;display:flex;align-items:center;gap:8px;color:var(--white)}
|
|
29
|
+
.nav-links{display:flex;gap:28px;align-items:center}
|
|
30
|
+
.nav-links a{color:var(--gray);font-size:.9rem;transition:color .2s}
|
|
31
|
+
.nav-links a:hover{color:var(--white);text-decoration:none}
|
|
32
|
+
.nav-links .btn-sm{color:var(--navy);background:var(--emerald);padding:6px 28px;border-radius:20px;font-weight:600;font-size:.85rem;white-space:nowrap}
|
|
33
|
+
.menu-toggle{display:none;background:none;border:none;color:var(--white);font-size:1.5rem;cursor:pointer}
|
|
34
|
+
|
|
35
|
+
.hero{padding:140px 0 60px;text-align:center;position:relative}
|
|
36
|
+
.hero::before{content:'';position:absolute;top:0;left:50%;transform:translateX(-50%);width:800px;height:600px;background:radial-gradient(circle,rgba(59,130,246,.1) 0%,transparent 70%);pointer-events:none}
|
|
37
|
+
.hero h1{font-size:clamp(2rem,5vw,3rem);font-weight:800;line-height:1.15;margin-bottom:16px;letter-spacing:-.03em;position:relative;z-index:1}
|
|
38
|
+
.hero h1 .highlight{background:linear-gradient(135deg,var(--blue),var(--emerald));-webkit-background-clip:text;-webkit-text-fill-color:transparent;background-clip:text}
|
|
39
|
+
.hero p{font-size:1.1rem;color:var(--gray);max-width:600px;margin:0 auto;position:relative;z-index:1}
|
|
40
|
+
|
|
41
|
+
.toc{background:var(--navy-light);border:1px solid rgba(255,255,255,.06);border-radius:12px;padding:28px 32px;margin:40px 0 60px}
|
|
42
|
+
.toc h2{font-size:1rem;text-transform:uppercase;letter-spacing:.1em;color:var(--emerald);margin-bottom:16px}
|
|
43
|
+
.toc ol{padding-left:20px}
|
|
44
|
+
.toc li{margin-bottom:8px}
|
|
45
|
+
.toc a{color:var(--gray);font-size:.95rem}
|
|
46
|
+
.toc a:hover{color:var(--white)}
|
|
47
|
+
|
|
48
|
+
article{padding-bottom:80px}
|
|
49
|
+
article h2{font-size:1.8rem;font-weight:700;margin:64px 0 24px;padding-top:24px;border-top:1px solid rgba(255,255,255,.06);letter-spacing:-.02em}
|
|
50
|
+
article h2:first-of-type{border-top:none;margin-top:0}
|
|
51
|
+
article h2 .num{color:var(--emerald);margin-right:8px}
|
|
52
|
+
article h3{font-size:1.2rem;font-weight:600;margin:32px 0 12px;color:var(--blue)}
|
|
53
|
+
article h4{font-size:1rem;font-weight:600;margin:24px 0 8px}
|
|
54
|
+
article p{color:var(--gray);margin-bottom:16px}
|
|
55
|
+
article ul,article ol{color:var(--gray);margin-bottom:16px;padding-left:24px}
|
|
56
|
+
article li{margin-bottom:8px}
|
|
57
|
+
article strong{color:var(--white)}
|
|
58
|
+
|
|
59
|
+
pre{background:var(--navy-light);border:1px solid rgba(255,255,255,.08);border-radius:10px;padding:20px 24px;overflow-x:auto;margin:16px 0 24px;font-size:.88rem;line-height:1.6}
|
|
60
|
+
code{font-family:'SF Mono',Monaco,Consolas,monospace;color:var(--emerald)}
|
|
61
|
+
pre code{color:var(--white)}
|
|
62
|
+
.cmd{color:var(--emerald)}
|
|
63
|
+
.comment{color:var(--gray);font-style:italic}
|
|
64
|
+
|
|
65
|
+
.option-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:20px;margin:24px 0}
|
|
66
|
+
.option-card{background:var(--navy-light);border:1px solid rgba(255,255,255,.06);border-radius:12px;padding:24px;text-align:center;transition:border-color .2s}
|
|
67
|
+
.option-card:hover{border-color:var(--emerald)}
|
|
68
|
+
.option-card.recommended{border-color:var(--emerald);position:relative}
|
|
69
|
+
.option-card.recommended::after{content:'RECOMMENDED';position:absolute;top:-10px;left:50%;transform:translateX(-50%);background:var(--emerald);color:var(--navy);font-size:.7rem;font-weight:700;padding:2px 12px;border-radius:10px;letter-spacing:.05em}
|
|
70
|
+
.option-card .icon{font-size:2.5rem;margin-bottom:12px}
|
|
71
|
+
.option-card h4{color:var(--white);margin-bottom:4px}
|
|
72
|
+
.option-card .price{font-size:1.5rem;font-weight:700;color:var(--emerald);margin-bottom:8px}
|
|
73
|
+
.option-card p{color:var(--gray);font-size:.85rem;margin:0}
|
|
74
|
+
|
|
75
|
+
.file-example{background:var(--navy-light);border-left:3px solid var(--blue);border-radius:0 10px 10px 0;padding:20px 24px;margin:16px 0 24px}
|
|
76
|
+
.file-example .filename{font-size:.8rem;font-weight:700;color:var(--blue);text-transform:uppercase;letter-spacing:.05em;margin-bottom:8px}
|
|
77
|
+
|
|
78
|
+
.template-grid{display:grid;grid-template-columns:repeat(auto-fit,minmax(240px,1fr));gap:20px;margin:24px 0}
|
|
79
|
+
.template-card{background:var(--navy-light);border:1px solid rgba(255,255,255,.06);border-radius:12px;padding:24px;transition:border-color .2s}
|
|
80
|
+
.template-card:hover{border-color:var(--blue)}
|
|
81
|
+
.template-card .icon{font-size:2rem;margin-bottom:8px}
|
|
82
|
+
.template-card h4{color:var(--white);margin-bottom:8px}
|
|
83
|
+
.template-card p{color:var(--gray);font-size:.85rem;margin:0}
|
|
84
|
+
.template-card ul{color:var(--gray);font-size:.85rem;margin:8px 0 0;padding-left:16px}
|
|
85
|
+
|
|
86
|
+
.faq-item{border-bottom:1px solid rgba(255,255,255,.06);padding:20px 0}
|
|
87
|
+
.faq-item summary{font-weight:600;color:var(--white);cursor:pointer;font-size:1.05rem;list-style:none;display:flex;align-items:center;gap:12px}
|
|
88
|
+
.faq-item summary::before{content:'▸';color:var(--emerald);font-size:1.2rem;transition:transform .2s}
|
|
89
|
+
.faq-item[open] summary::before{transform:rotate(90deg)}
|
|
90
|
+
.faq-item p{color:var(--gray);margin-top:12px;padding-left:24px}
|
|
91
|
+
|
|
92
|
+
.cta-box{background:linear-gradient(135deg,rgba(59,130,246,.15),rgba(16,185,129,.1));border:1px solid rgba(59,130,246,.3);border-radius:16px;padding:48px;text-align:center;margin:60px 0}
|
|
93
|
+
.cta-box h2{font-size:1.6rem;margin-bottom:12px;border:none;padding:0}
|
|
94
|
+
.cta-box p{color:var(--gray);margin-bottom:24px}
|
|
95
|
+
.btn{display:inline-flex;align-items:center;gap:8px;padding:14px 28px;border-radius:10px;font-weight:600;font-size:1rem;transition:all .2s;border:none;cursor:pointer;text-decoration:none}
|
|
96
|
+
.btn-primary{background:var(--blue);color:#fff}
|
|
97
|
+
.btn-primary:hover{background:#2563EB;text-decoration:none}
|
|
98
|
+
|
|
99
|
+
.alert{background:rgba(245,158,11,.1);border:1px solid rgba(245,158,11,.3);border-radius:10px;padding:16px 20px;margin:16px 0;color:var(--amber);font-size:.9rem}
|
|
100
|
+
.alert strong{color:var(--amber)}
|
|
101
|
+
|
|
102
|
+
footer{padding:40px 0;border-top:1px solid rgba(255,255,255,.06);text-align:center;color:var(--gray);font-size:.85rem}
|
|
103
|
+
|
|
104
|
+
@media(max-width:768px){
|
|
105
|
+
.nav-links{display:none}
|
|
106
|
+
.nav-links.open{display:flex;flex-direction:column;position:absolute;top:100%;left:0;right:0;background:var(--navy);padding:20px;gap:16px;border-bottom:1px solid var(--navy-mid)}
|
|
107
|
+
.menu-toggle{display:block}
|
|
108
|
+
.hero{padding:120px 0 40px}
|
|
109
|
+
.option-grid,.template-grid{grid-template-columns:1fr}
|
|
110
|
+
pre{padding:16px;font-size:.8rem}
|
|
111
|
+
}
|
|
112
|
+
</style>
|
|
113
|
+
</head>
|
|
114
|
+
<body>
|
|
115
|
+
|
|
116
|
+
<nav>
|
|
117
|
+
<div class="container">
|
|
118
|
+
<div class="logo"><a href="/"><img src="/logo.svg" alt="ClawMoat" style="height:44px"></a></div>
|
|
119
|
+
<button class="menu-toggle" onclick="document.querySelector('.nav-links').classList.toggle('open')" aria-label="Menu">☰</button>
|
|
120
|
+
<div class="nav-links">
|
|
121
|
+
<a href="/">Security</a>
|
|
122
|
+
<a href="/services/">AI Agents</a>
|
|
123
|
+
<a href="/blog/">Blog</a>
|
|
124
|
+
<a href="https://github.com/darfaz/clawmoat">GitHub ↗</a>
|
|
125
|
+
<a href="mailto:hello@clawmoat.com?subject=15-Min%20Discovery%20Call" class="btn-sm">Get Started</a>
|
|
126
|
+
</div>
|
|
127
|
+
</div>
|
|
128
|
+
</nav>
|
|
129
|
+
|
|
130
|
+
<div class="hero">
|
|
131
|
+
<div class="container">
|
|
132
|
+
<h1>Deploy <span class="highlight">AI Agents</span> for Your Business</h1>
|
|
133
|
+
<p>The complete guide to setting up a secure, autonomous AI agent system on dedicated hardware — connected to your team and working 24/7.</p>
|
|
134
|
+
</div>
|
|
135
|
+
</div>
|
|
136
|
+
|
|
137
|
+
<div class="container">
|
|
138
|
+
|
|
139
|
+
<nav class="toc">
|
|
140
|
+
<h2>Table of Contents</h2>
|
|
141
|
+
<ol>
|
|
142
|
+
<li><a href="#what-youll-build">What You'll Build</a></li>
|
|
143
|
+
<li><a href="#hardware">Hardware Setup</a></li>
|
|
144
|
+
<li><a href="#software">Software Installation</a></li>
|
|
145
|
+
<li><a href="#configuration">Agent Configuration</a></li>
|
|
146
|
+
<li><a href="#security">Security Hardening</a></li>
|
|
147
|
+
<li><a href="#team">Connecting Your Team</a></li>
|
|
148
|
+
<li><a href="#templates">Agent Templates</a></li>
|
|
149
|
+
<li><a href="#maintenance">Maintenance & Monitoring</a></li>
|
|
150
|
+
<li><a href="#faq">FAQ</a></li>
|
|
151
|
+
</ol>
|
|
152
|
+
</nav>
|
|
153
|
+
|
|
154
|
+
<article>
|
|
155
|
+
|
|
156
|
+
<!-- ===== 1. WHAT YOU'LL BUILD ===== -->
|
|
157
|
+
<h2 id="what-youll-build"><span class="num">1.</span> What You'll Build</h2>
|
|
158
|
+
|
|
159
|
+
<p>By the end of this guide, you'll have:</p>
|
|
160
|
+
|
|
161
|
+
<ul>
|
|
162
|
+
<li><strong>A dedicated AI agent</strong> running on hardware you own — not in someone else's cloud</li>
|
|
163
|
+
<li><strong>Secure communications</strong> with your team via Telegram, Slack, or email</li>
|
|
164
|
+
<li><strong>Automated workflows</strong> — daily reports, inbox monitoring, KPI tracking, customer responses</li>
|
|
165
|
+
<li><strong>Enterprise-grade security</strong> with ClawMoat protecting credentials, financial data, and compliance</li>
|
|
166
|
+
<li><strong>Full audit trails</strong> so you always know what your agent did and why</li>
|
|
167
|
+
</ul>
|
|
168
|
+
|
|
169
|
+
<p>Think of it as hiring a tireless team member who follows your SOPs exactly, never forgets a task, and works through weekends — all for the cost of a mini PC and an API subscription.</p>
|
|
170
|
+
|
|
171
|
+
<p><strong>Architecture overview:</strong></p>
|
|
172
|
+
<pre><code>┌─────────────────────────────────────────────┐
|
|
173
|
+
│ Your Hardware (Mini PC / Laptop / Mac) │
|
|
174
|
+
│ │
|
|
175
|
+
│ ┌──────────┐ ┌───────────┐ ┌──────────┐ │
|
|
176
|
+
│ │ OpenClaw │──│ ClawMoat │──│ Agent │ │
|
|
177
|
+
│ │ Runtime │ │ Security │ │ Workspace│ │
|
|
178
|
+
│ └────┬─────┘ └───────────┘ └──────────┘ │
|
|
179
|
+
│ │ │
|
|
180
|
+
└───────┼──────────────────────────────────────┘
|
|
181
|
+
│
|
|
182
|
+
┌────┴────────────────────┐
|
|
183
|
+
│ Channels │
|
|
184
|
+
├─────────────────────────┤
|
|
185
|
+
│ 💬 Telegram / Slack │
|
|
186
|
+
│ 📧 Email (IMAP/SMTP) │
|
|
187
|
+
│ 🌐 Web APIs │
|
|
188
|
+
└─────────────────────────┘</code></pre>
|
|
189
|
+
|
|
190
|
+
<!-- ===== 2. HARDWARE ===== -->
|
|
191
|
+
<h2 id="hardware"><span class="num">2.</span> Hardware Setup</h2>
|
|
192
|
+
|
|
193
|
+
<p>Your AI agent needs a machine that stays on. Three options, from free to premium:</p>
|
|
194
|
+
|
|
195
|
+
<div class="option-grid">
|
|
196
|
+
<div class="option-card">
|
|
197
|
+
<div class="icon">💻</div>
|
|
198
|
+
<h4>Option A: Existing Laptop</h4>
|
|
199
|
+
<div class="price">$0</div>
|
|
200
|
+
<p>Use what you have. Windows (WSL2), Mac, or Linux. Set it to never sleep and plug it in. Good for testing and small teams.</p>
|
|
201
|
+
</div>
|
|
202
|
+
<div class="option-card recommended">
|
|
203
|
+
<div class="icon">🖥️</div>
|
|
204
|
+
<h4>Option B: Beelink Mini PC</h4>
|
|
205
|
+
<div class="price">~$350–$400</div>
|
|
206
|
+
<p><strong>Beelink SER5 MAX</strong> (AMD Ryzen 7, 16GB RAM) or <strong>EQ12</strong> (Intel N100, 16GB). Silent, tiny, always-on. Perfect for a dedicated agent.</p>
|
|
207
|
+
</div>
|
|
208
|
+
<div class="option-card">
|
|
209
|
+
<div class="icon">🍎</div>
|
|
210
|
+
<h4>Option C: Mac Mini</h4>
|
|
211
|
+
<div class="price">$599</div>
|
|
212
|
+
<p>Apple M-series chip. Premium build quality, excellent power efficiency. Native macOS with great terminal support.</p>
|
|
213
|
+
</div>
|
|
214
|
+
</div>
|
|
215
|
+
|
|
216
|
+
<h3>Minimum Requirements</h3>
|
|
217
|
+
<ul>
|
|
218
|
+
<li><strong>CPU:</strong> 4 cores (any modern processor)</li>
|
|
219
|
+
<li><strong>RAM:</strong> 8GB minimum, 16GB recommended</li>
|
|
220
|
+
<li><strong>Storage:</strong> 128GB SSD (agents are lightweight)</li>
|
|
221
|
+
<li><strong>Network:</strong> Stable internet connection (wired preferred)</li>
|
|
222
|
+
<li><strong>Power:</strong> UPS recommended for business-critical deployments</li>
|
|
223
|
+
</ul>
|
|
224
|
+
|
|
225
|
+
<h3>Initial OS Setup</h3>
|
|
226
|
+
|
|
227
|
+
<h4>Windows (WSL2)</h4>
|
|
228
|
+
<pre><code><span class="comment"># Open PowerShell as Administrator</span>
|
|
229
|
+
<span class="cmd">wsl --install -d Ubuntu</span>
|
|
230
|
+
<span class="comment"># Restart, then open Ubuntu from Start menu</span>
|
|
231
|
+
<span class="comment"># Disable sleep: Settings → System → Power → Never</span></code></pre>
|
|
232
|
+
|
|
233
|
+
<h4>Mac</h4>
|
|
234
|
+
<pre><code><span class="comment"># Disable sleep</span>
|
|
235
|
+
<span class="cmd">sudo pmset -a disablesleep 1</span>
|
|
236
|
+
<span class="comment"># Enable auto-restart after power failure</span>
|
|
237
|
+
<span class="cmd">sudo pmset -a autorestart 1</span></code></pre>
|
|
238
|
+
|
|
239
|
+
<h4>Linux</h4>
|
|
240
|
+
<pre><code><span class="comment"># Disable suspend</span>
|
|
241
|
+
<span class="cmd">sudo systemctl mask sleep.target suspend.target hibernate.target hybrid-sleep.target</span></code></pre>
|
|
242
|
+
|
|
243
|
+
<!-- ===== 3. SOFTWARE ===== -->
|
|
244
|
+
<h2 id="software"><span class="num">3.</span> Software Installation</h2>
|
|
245
|
+
|
|
246
|
+
<p>Four commands. That's it.</p>
|
|
247
|
+
|
|
248
|
+
<h3>Step 1: Install Node.js</h3>
|
|
249
|
+
<pre><code><span class="cmd">curl -fsSL https://fnm.vercel.app/install | bash && fnm install 22</span></code></pre>
|
|
250
|
+
<p>Or use the official installer at <a href="https://nodejs.org">nodejs.org</a> — download the LTS version.</p>
|
|
251
|
+
|
|
252
|
+
<h3>Step 2: Install OpenClaw</h3>
|
|
253
|
+
<pre><code><span class="cmd">npm install -g openclaw</span></code></pre>
|
|
254
|
+
|
|
255
|
+
<h3>Step 3: Install ClawMoat</h3>
|
|
256
|
+
<pre><code><span class="cmd">npm install -g clawmoat</span></code></pre>
|
|
257
|
+
|
|
258
|
+
<h3>Step 4: Run the ClawMoat Installer</h3>
|
|
259
|
+
<pre><code><span class="cmd">curl -sSL https://clawmoat.com/install.sh | bash</span></code></pre>
|
|
260
|
+
|
|
261
|
+
<p>The installer will:</p>
|
|
262
|
+
<ul>
|
|
263
|
+
<li>Configure security policies and permission tiers</li>
|
|
264
|
+
<li>Set up audit logging</li>
|
|
265
|
+
<li>Create your agent workspace at <code>~/.openclaw/workspace/</code></li>
|
|
266
|
+
<li>Generate a security report</li>
|
|
267
|
+
</ul>
|
|
268
|
+
|
|
269
|
+
<h3>Step 5: Set Your API Key</h3>
|
|
270
|
+
<pre><code><span class="comment"># Anthropic (recommended)</span>
|
|
271
|
+
<span class="cmd">openclaw config set ANTHROPIC_API_KEY sk-ant-...</span>
|
|
272
|
+
|
|
273
|
+
<span class="comment"># Or OpenAI</span>
|
|
274
|
+
<span class="cmd">openclaw config set OPENAI_API_KEY sk-...</span></code></pre>
|
|
275
|
+
|
|
276
|
+
<h3>Step 6: Verify Everything Works</h3>
|
|
277
|
+
<pre><code><span class="cmd">openclaw status</span>
|
|
278
|
+
<span class="cmd">clawmoat scan</span></code></pre>
|
|
279
|
+
|
|
280
|
+
<!-- ===== 4. CONFIGURATION ===== -->
|
|
281
|
+
<h2 id="configuration"><span class="num">4.</span> Agent Configuration</h2>
|
|
282
|
+
|
|
283
|
+
<p>Your agent's behavior is defined by markdown files in <code>~/.openclaw/workspace/</code>. No code required — just plain English instructions.</p>
|
|
284
|
+
|
|
285
|
+
<h3>SOUL.md — Agent Personality</h3>
|
|
286
|
+
<p>This is who your agent <em>is</em>. It defines tone, behavior, and boundaries.</p>
|
|
287
|
+
|
|
288
|
+
<div class="file-example">
|
|
289
|
+
<div class="filename">~/.openclaw/workspace/SOUL.md — Finance Agent for Acme Corp</div>
|
|
290
|
+
<pre><code># SOUL.md — Acme Corp Finance Agent
|
|
291
|
+
|
|
292
|
+
You are Acme Corp's finance agent. You are precise, thorough,
|
|
293
|
+
and conservative with financial decisions.
|
|
294
|
+
|
|
295
|
+
## Core Behaviors
|
|
296
|
+
- **Always double-check numbers.** Never send a financial report
|
|
297
|
+
without verifying totals.
|
|
298
|
+
- **Flag anomalies.** If an expense is 20%+ above average, alert
|
|
299
|
+
the CFO immediately.
|
|
300
|
+
- **Be concise in reports.** Executives want the number, not the
|
|
301
|
+
story behind it.
|
|
302
|
+
- **Never authorize payments** without explicit human approval.
|
|
303
|
+
|
|
304
|
+
## Tone
|
|
305
|
+
Professional but not stiff. You're a trusted colleague, not a
|
|
306
|
+
robot reading a script.
|
|
307
|
+
|
|
308
|
+
## Boundaries
|
|
309
|
+
- Never share financial data outside approved channels.
|
|
310
|
+
- Never modify accounting records directly.
|
|
311
|
+
- Always cite your sources (which spreadsheet, which email).</code></pre>
|
|
312
|
+
</div>
|
|
313
|
+
|
|
314
|
+
<div class="file-example">
|
|
315
|
+
<div class="filename">~/.openclaw/workspace/SOUL.md — Operations Agent</div>
|
|
316
|
+
<pre><code># SOUL.md — Acme Corp Operations Agent
|
|
317
|
+
|
|
318
|
+
You are Acme Corp's operations coordinator. You keep things
|
|
319
|
+
running smoothly and hate bottlenecks.
|
|
320
|
+
|
|
321
|
+
## Core Behaviors
|
|
322
|
+
- **Proactive scheduling.** Don't wait to be asked — check
|
|
323
|
+
tomorrow's calendar every evening.
|
|
324
|
+
- **Vendor management.** Track delivery dates and flag delays
|
|
325
|
+
24 hours before they become problems.
|
|
326
|
+
- **Escalation rules:** Try to resolve issues yourself first.
|
|
327
|
+
Escalate to ops manager only if it requires budget approval
|
|
328
|
+
or involves safety.
|
|
329
|
+
|
|
330
|
+
## Tone
|
|
331
|
+
Direct, action-oriented. Use bullet points. Skip pleasantries
|
|
332
|
+
in status updates.</code></pre>
|
|
333
|
+
</div>
|
|
334
|
+
|
|
335
|
+
<div class="file-example">
|
|
336
|
+
<div class="filename">~/.openclaw/workspace/SOUL.md — Sales Agent</div>
|
|
337
|
+
<pre><code># SOUL.md — Acme Corp Sales Agent
|
|
338
|
+
|
|
339
|
+
You are Acme Corp's sales support agent. Your job is to keep
|
|
340
|
+
deals moving and reps informed.
|
|
341
|
+
|
|
342
|
+
## Core Behaviors
|
|
343
|
+
- **Follow up relentlessly.** If a prospect hasn't replied in
|
|
344
|
+
48 hours, draft a follow-up.
|
|
345
|
+
- **Prep meeting briefs.** Before any sales call, compile a
|
|
346
|
+
one-pager on the prospect (company size, recent news, pain
|
|
347
|
+
points).
|
|
348
|
+
- **CRM hygiene.** Update deal stages after every interaction.
|
|
349
|
+
- **Never negotiate pricing** without sales manager approval.
|
|
350
|
+
|
|
351
|
+
## Tone
|
|
352
|
+
Warm, professional, enthusiastic without being pushy.</code></pre>
|
|
353
|
+
</div>
|
|
354
|
+
|
|
355
|
+
<h3>USER.md — Team Member Profiles</h3>
|
|
356
|
+
<p>Tell your agent who it's working with.</p>
|
|
357
|
+
|
|
358
|
+
<div class="file-example">
|
|
359
|
+
<div class="filename">~/.openclaw/workspace/USER.md</div>
|
|
360
|
+
<pre><code># USER.md — Team Profiles
|
|
361
|
+
|
|
362
|
+
## Primary Contact
|
|
363
|
+
- **Name:** Sarah Chen, CFO
|
|
364
|
+
- **Timezone:** America/New_York
|
|
365
|
+
- **Preferences:** Prefers Slack. Wants daily summaries by 8 AM.
|
|
366
|
+
No messages after 9 PM unless urgent.
|
|
367
|
+
|
|
368
|
+
## Team Members
|
|
369
|
+
- **Mike Rodriguez** — Controller. Handles AP/AR approvals.
|
|
370
|
+
- **Lisa Park** — Operations Manager. Point of contact for
|
|
371
|
+
vendor issues.
|
|
372
|
+
- **James Wu** — CEO. Only contact for decisions above $10K.</code></pre>
|
|
373
|
+
</div>
|
|
374
|
+
|
|
375
|
+
<h3>MEMORY.md — Business Context</h3>
|
|
376
|
+
<p>Give your agent institutional knowledge that doesn't change often.</p>
|
|
377
|
+
|
|
378
|
+
<div class="file-example">
|
|
379
|
+
<div class="filename">~/.openclaw/workspace/MEMORY.md</div>
|
|
380
|
+
<pre><code># MEMORY.md — Acme Corp Context
|
|
381
|
+
|
|
382
|
+
## Company
|
|
383
|
+
- Industry: B2B SaaS (project management tools)
|
|
384
|
+
- Founded: 2019, Series A ($8M)
|
|
385
|
+
- Employees: 45
|
|
386
|
+
- Fiscal year: Jan-Dec
|
|
387
|
+
|
|
388
|
+
## Key Vendors
|
|
389
|
+
- AWS — primary cloud provider, account #1234-5678
|
|
390
|
+
- Stripe — payment processing
|
|
391
|
+
- QuickBooks Online — accounting system
|
|
392
|
+
|
|
393
|
+
## Important Policies
|
|
394
|
+
- All expenses over $500 need manager approval
|
|
395
|
+
- Vendor payments net-30 unless negotiated otherwise
|
|
396
|
+
- Monthly close deadline: 5th business day</code></pre>
|
|
397
|
+
</div>
|
|
398
|
+
|
|
399
|
+
<h3>HEARTBEAT.md — Automated Routines</h3>
|
|
400
|
+
<p>This file tells your agent what to do on its regular check-ins (every 30 minutes by default).</p>
|
|
401
|
+
|
|
402
|
+
<div class="file-example">
|
|
403
|
+
<div class="filename">~/.openclaw/workspace/HEARTBEAT.md</div>
|
|
404
|
+
<pre><code># HEARTBEAT.md — Automated Routines
|
|
405
|
+
|
|
406
|
+
## Every Check-in
|
|
407
|
+
- [ ] Check inbox for urgent emails (from: @acmecorp.com)
|
|
408
|
+
- [ ] Check calendar for meetings in next 2 hours
|
|
409
|
+
|
|
410
|
+
## Morning (8-9 AM ET)
|
|
411
|
+
- [ ] Generate daily cash position summary
|
|
412
|
+
- [ ] Send Sarah the overnight email digest
|
|
413
|
+
- [ ] Check for overdue invoices (30+ days)
|
|
414
|
+
|
|
415
|
+
## End of Day (5-6 PM ET)
|
|
416
|
+
- [ ] Compile today's activity summary
|
|
417
|
+
- [ ] Draft tomorrow's priority list
|
|
418
|
+
- [ ] Flag any unresolved issues
|
|
419
|
+
|
|
420
|
+
## Weekly (Monday Morning)
|
|
421
|
+
- [ ] Generate weekly KPI dashboard
|
|
422
|
+
- [ ] Summarize vendor payment status
|
|
423
|
+
- [ ] Review upcoming contract renewals (next 30 days)</code></pre>
|
|
424
|
+
</div>
|
|
425
|
+
|
|
426
|
+
<!-- ===== 5. SECURITY ===== -->
|
|
427
|
+
<h2 id="security"><span class="num">5.</span> Security Hardening</h2>
|
|
428
|
+
|
|
429
|
+
<p>This is where ClawMoat earns its keep. An unsecured AI agent with access to your business systems is a liability. ClawMoat turns it into a trusted employee with clear boundaries.</p>
|
|
430
|
+
|
|
431
|
+
<h3>Permission Tiers</h3>
|
|
432
|
+
<p>ClawMoat enforces three permission levels:</p>
|
|
433
|
+
|
|
434
|
+
<div class="option-grid">
|
|
435
|
+
<div class="option-card">
|
|
436
|
+
<div class="icon">🔒</div>
|
|
437
|
+
<h4>Worker</h4>
|
|
438
|
+
<p><strong>Read-only + safe tools.</strong> Can read files, search the web, check email. Cannot modify files, run shell commands, or access credentials. Best for: monitoring agents, research agents.</p>
|
|
439
|
+
</div>
|
|
440
|
+
<div class="option-card recommended">
|
|
441
|
+
<div class="icon">🛡️</div>
|
|
442
|
+
<h4>Standard</h4>
|
|
443
|
+
<p><strong>Read-write with guardrails.</strong> Can edit workspace files, send messages, run approved commands. Blocked from system files, credentials, and destructive operations. Best for: most business agents.</p>
|
|
444
|
+
</div>
|
|
445
|
+
<div class="option-card">
|
|
446
|
+
<div class="icon">⚡</div>
|
|
447
|
+
<h4>Full</h4>
|
|
448
|
+
<p><strong>Unrestricted (admin only).</strong> Full system access. Use only for trusted admin agents with human-in-the-loop oversight. Requires explicit opt-in.</p>
|
|
449
|
+
</div>
|
|
450
|
+
</div>
|
|
451
|
+
|
|
452
|
+
<h3>Forbidden Zones</h3>
|
|
453
|
+
<p>ClawMoat blocks agent access to sensitive paths by default:</p>
|
|
454
|
+
|
|
455
|
+
<pre><code><span class="comment"># These paths are automatically protected:</span>
|
|
456
|
+
~/.ssh/ <span class="comment"># SSH keys</span>
|
|
457
|
+
~/.aws/ <span class="comment"># AWS credentials</span>
|
|
458
|
+
~/.config/gcloud/ <span class="comment"># Google Cloud credentials</span>
|
|
459
|
+
~/.gnupg/ <span class="comment"># GPG keys</span>
|
|
460
|
+
/etc/shadow <span class="comment"># System passwords</span>
|
|
461
|
+
*.pem, *.key <span class="comment"># Private keys</span>
|
|
462
|
+
.env <span class="comment"># Environment secrets</span>
|
|
463
|
+
|
|
464
|
+
<span class="comment"># Add your own forbidden zones:</span>
|
|
465
|
+
<span class="cmd">clawmoat config add-forbidden "/path/to/financial-records"</span>
|
|
466
|
+
<span class="cmd">clawmoat config add-forbidden "/path/to/hr-data"</span></code></pre>
|
|
467
|
+
|
|
468
|
+
<h3>FinanceGuard</h3>
|
|
469
|
+
<p>For companies handling financial data, ClawMoat's FinanceGuard module adds extra protections:</p>
|
|
470
|
+
|
|
471
|
+
<ul>
|
|
472
|
+
<li><strong>PII detection:</strong> Automatically redacts Social Security numbers, credit card numbers, and bank account details from agent outputs</li>
|
|
473
|
+
<li><strong>Transaction limits:</strong> Prevents the agent from initiating transactions above a configurable threshold</li>
|
|
474
|
+
<li><strong>Segregation of duties:</strong> Ensures financial actions require human approval</li>
|
|
475
|
+
<li><strong>SOX compliance logging:</strong> Every financial data access is logged with timestamps, user context, and justification</li>
|
|
476
|
+
</ul>
|
|
477
|
+
|
|
478
|
+
<pre><code><span class="cmd">clawmoat enable financeguard</span>
|
|
479
|
+
<span class="cmd">clawmoat financeguard set-limit --amount 1000 --currency USD</span>
|
|
480
|
+
<span class="cmd">clawmoat financeguard require-approval --actions "payment,transfer,refund"</span></code></pre>
|
|
481
|
+
|
|
482
|
+
<h3>McpFirewall</h3>
|
|
483
|
+
<p>Control exactly which MCP tools your agent can access:</p>
|
|
484
|
+
|
|
485
|
+
<pre><code><span class="comment"># Allow only specific tools</span>
|
|
486
|
+
<span class="cmd">clawmoat mcp-firewall allow "email:read,email:send"</span>
|
|
487
|
+
<span class="cmd">clawmoat mcp-firewall allow "calendar:read"</span>
|
|
488
|
+
<span class="cmd">clawmoat mcp-firewall deny "filesystem:delete"</span>
|
|
489
|
+
|
|
490
|
+
<span class="comment"># Review current firewall rules</span>
|
|
491
|
+
<span class="cmd">clawmoat mcp-firewall list</span></code></pre>
|
|
492
|
+
|
|
493
|
+
<h3>Audit Trails</h3>
|
|
494
|
+
<p>Every agent action is logged for compliance review:</p>
|
|
495
|
+
|
|
496
|
+
<pre><code><span class="comment"># View recent agent activity</span>
|
|
497
|
+
<span class="cmd">clawmoat audit log --last 24h</span>
|
|
498
|
+
|
|
499
|
+
<span class="comment"># Export audit log for compliance</span>
|
|
500
|
+
<span class="cmd">clawmoat audit export --format csv --from 2026-01-01 --to 2026-01-31</span>
|
|
501
|
+
|
|
502
|
+
<span class="comment"># Set up alerts for sensitive actions</span>
|
|
503
|
+
<span class="cmd">clawmoat audit alert --on "credential_access,file_delete,external_send"</span></code></pre>
|
|
504
|
+
|
|
505
|
+
<!-- ===== 6. CONNECTING YOUR TEAM ===== -->
|
|
506
|
+
<h2 id="team"><span class="num">6.</span> Connecting Your Team</h2>
|
|
507
|
+
|
|
508
|
+
<h3>Telegram Bot Setup</h3>
|
|
509
|
+
<ol>
|
|
510
|
+
<li>Open Telegram, search for <strong>@BotFather</strong></li>
|
|
511
|
+
<li>Send <code>/newbot</code> and follow the prompts to name your bot</li>
|
|
512
|
+
<li>Copy the bot token</li>
|
|
513
|
+
<li>Configure OpenClaw:</li>
|
|
514
|
+
</ol>
|
|
515
|
+
<pre><code><span class="cmd">openclaw config set TELEGRAM_BOT_TOKEN "your-bot-token-here"</span>
|
|
516
|
+
<span class="cmd">openclaw channel add telegram</span>
|
|
517
|
+
<span class="cmd">openclaw gateway restart</span></code></pre>
|
|
518
|
+
<p>Your team can now message the bot directly or add it to a group chat.</p>
|
|
519
|
+
|
|
520
|
+
<h3>Slack Integration</h3>
|
|
521
|
+
<ol>
|
|
522
|
+
<li>Go to <a href="https://api.slack.com/apps">api.slack.com/apps</a> and create a new app</li>
|
|
523
|
+
<li>Under <strong>OAuth & Permissions</strong>, add scopes: <code>chat:write</code>, <code>channels:read</code>, <code>channels:history</code>, <code>users:read</code></li>
|
|
524
|
+
<li>Install the app to your workspace and copy the Bot Token</li>
|
|
525
|
+
<li>Configure OpenClaw:</li>
|
|
526
|
+
</ol>
|
|
527
|
+
<pre><code><span class="cmd">openclaw config set SLACK_BOT_TOKEN "xoxb-your-token"</span>
|
|
528
|
+
<span class="cmd">openclaw config set SLACK_APP_TOKEN "xapp-your-token"</span>
|
|
529
|
+
<span class="cmd">openclaw channel add slack</span>
|
|
530
|
+
<span class="cmd">openclaw gateway restart</span></code></pre>
|
|
531
|
+
|
|
532
|
+
<h3>Email Integration</h3>
|
|
533
|
+
<pre><code><span class="comment"># Configure IMAP for reading email</span>
|
|
534
|
+
<span class="cmd">openclaw config set EMAIL_IMAP_HOST "imap.gmail.com"</span>
|
|
535
|
+
<span class="cmd">openclaw config set EMAIL_IMAP_PORT 993</span>
|
|
536
|
+
<span class="cmd">openclaw config set EMAIL_USER "agent@yourcompany.com"</span>
|
|
537
|
+
<span class="cmd">openclaw config set EMAIL_PASSWORD "your-app-password"</span>
|
|
538
|
+
|
|
539
|
+
<span class="comment"># Configure SMTP for sending email</span>
|
|
540
|
+
<span class="cmd">openclaw config set EMAIL_SMTP_HOST "smtp.gmail.com"</span>
|
|
541
|
+
<span class="cmd">openclaw config set EMAIL_SMTP_PORT 587</span>
|
|
542
|
+
|
|
543
|
+
<span class="cmd">openclaw channel add email</span>
|
|
544
|
+
<span class="cmd">openclaw gateway restart</span></code></pre>
|
|
545
|
+
|
|
546
|
+
<div class="alert">
|
|
547
|
+
<strong>⚠️ Security tip:</strong> Use app-specific passwords (not your main password). For Gmail, enable 2FA and generate an app password at <a href="https://myaccount.google.com/apppasswords" style="color:var(--amber)">myaccount.google.com/apppasswords</a>.
|
|
548
|
+
</div>
|
|
549
|
+
|
|
550
|
+
<!-- ===== 7. AGENT TEMPLATES ===== -->
|
|
551
|
+
<h2 id="templates"><span class="num">7.</span> Agent Templates</h2>
|
|
552
|
+
|
|
553
|
+
<p>Pre-built configurations to get you started fast. Copy the SOUL.md and HEARTBEAT.md into your agent workspace and customize for your company.</p>
|
|
554
|
+
|
|
555
|
+
<div class="template-grid">
|
|
556
|
+
<div class="template-card">
|
|
557
|
+
<div class="icon">💰</div>
|
|
558
|
+
<h4>Finance Agent</h4>
|
|
559
|
+
<p>Accounts receivable/payable, cash flow monitoring, financial reporting, expense tracking.</p>
|
|
560
|
+
<ul>
|
|
561
|
+
<li>Daily cash position reports</li>
|
|
562
|
+
<li>Invoice aging alerts</li>
|
|
563
|
+
<li>Expense anomaly detection</li>
|
|
564
|
+
<li>Month-end close support</li>
|
|
565
|
+
</ul>
|
|
566
|
+
</div>
|
|
567
|
+
<div class="template-card">
|
|
568
|
+
<div class="icon">⚙️</div>
|
|
569
|
+
<h4>Operations Agent</h4>
|
|
570
|
+
<p>Scheduling, inventory tracking, vendor management, dispatch coordination.</p>
|
|
571
|
+
<ul>
|
|
572
|
+
<li>Delivery tracking & delay alerts</li>
|
|
573
|
+
<li>Inventory reorder triggers</li>
|
|
574
|
+
<li>Shift scheduling</li>
|
|
575
|
+
<li>Maintenance reminders</li>
|
|
576
|
+
</ul>
|
|
577
|
+
</div>
|
|
578
|
+
<div class="template-card">
|
|
579
|
+
<div class="icon">📈</div>
|
|
580
|
+
<h4>Sales Agent</h4>
|
|
581
|
+
<p>CRM updates, prospect follow-ups, meeting prep, proposal drafting.</p>
|
|
582
|
+
<ul>
|
|
583
|
+
<li>Auto follow-up sequences</li>
|
|
584
|
+
<li>Meeting brief generation</li>
|
|
585
|
+
<li>Deal pipeline tracking</li>
|
|
586
|
+
<li>Win/loss analysis</li>
|
|
587
|
+
</ul>
|
|
588
|
+
</div>
|
|
589
|
+
<div class="template-card">
|
|
590
|
+
<div class="icon">🎧</div>
|
|
591
|
+
<h4>Customer Service Agent</h4>
|
|
592
|
+
<p>Email triage, FAQ responses, ticket routing, escalation management.</p>
|
|
593
|
+
<ul>
|
|
594
|
+
<li>Auto-categorize inbound emails</li>
|
|
595
|
+
<li>Draft responses from knowledge base</li>
|
|
596
|
+
<li>SLA monitoring</li>
|
|
597
|
+
<li>Sentiment-based escalation</li>
|
|
598
|
+
</ul>
|
|
599
|
+
</div>
|
|
600
|
+
<div class="template-card">
|
|
601
|
+
<div class="icon">👔</div>
|
|
602
|
+
<h4>Executive Agent</h4>
|
|
603
|
+
<p>Calendar management, briefing prep, decision support, travel coordination.</p>
|
|
604
|
+
<ul>
|
|
605
|
+
<li>Daily morning briefings</li>
|
|
606
|
+
<li>Meeting prep packets</li>
|
|
607
|
+
<li>Decision memo drafting</li>
|
|
608
|
+
<li>Cross-team status rollups</li>
|
|
609
|
+
</ul>
|
|
610
|
+
</div>
|
|
611
|
+
</div>
|
|
612
|
+
|
|
613
|
+
<h3>Example: Finance Agent HEARTBEAT.md</h3>
|
|
614
|
+
<div class="file-example">
|
|
615
|
+
<div class="filename">HEARTBEAT.md — Finance Agent Template</div>
|
|
616
|
+
<pre><code># HEARTBEAT.md — Finance Agent
|
|
617
|
+
|
|
618
|
+
## Every Check-in (~30 min)
|
|
619
|
+
- [ ] Check email for payment confirmations or vendor invoices
|
|
620
|
+
- [ ] Monitor bank feed for new transactions
|
|
621
|
+
|
|
622
|
+
## Morning Routine (8 AM)
|
|
623
|
+
- [ ] Pull overnight bank transactions
|
|
624
|
+
- [ ] Generate daily cash position: opening balance, pending
|
|
625
|
+
inflows, pending outflows, projected closing
|
|
626
|
+
- [ ] Send CFO the morning financial snapshot
|
|
627
|
+
- [ ] Flag invoices past 30-day terms
|
|
628
|
+
|
|
629
|
+
## Midday (12 PM)
|
|
630
|
+
- [ ] Check AP aging report — flag anything due in 48 hours
|
|
631
|
+
- [ ] Verify any ACH/wire transfers initiated today
|
|
632
|
+
|
|
633
|
+
## End of Day (5 PM)
|
|
634
|
+
- [ ] Reconcile today's transactions
|
|
635
|
+
- [ ] Update cash flow forecast for next 7 days
|
|
636
|
+
- [ ] Send end-of-day summary to finance team
|
|
637
|
+
|
|
638
|
+
## Weekly (Monday 9 AM)
|
|
639
|
+
- [ ] Generate weekly P&L summary
|
|
640
|
+
- [ ] AR aging analysis with collection recommendations
|
|
641
|
+
- [ ] Vendor payment schedule for the week
|
|
642
|
+
- [ ] Budget vs actuals variance report
|
|
643
|
+
|
|
644
|
+
## Monthly (1st business day)
|
|
645
|
+
- [ ] Initiate month-end close checklist
|
|
646
|
+
- [ ] Generate preliminary financial statements
|
|
647
|
+
- [ ] Flag unusual variances (>10%) for review</code></pre>
|
|
648
|
+
</div>
|
|
649
|
+
|
|
650
|
+
<!-- ===== 8. MAINTENANCE ===== -->
|
|
651
|
+
<h2 id="maintenance"><span class="num">8.</span> Maintenance & Monitoring</h2>
|
|
652
|
+
|
|
653
|
+
<h3>Keep Your Agent Running</h3>
|
|
654
|
+
<pre><code><span class="comment"># Start the agent as a system service (auto-restarts on crash/reboot)</span>
|
|
655
|
+
<span class="cmd">openclaw gateway start</span>
|
|
656
|
+
|
|
657
|
+
<span class="comment"># Check status</span>
|
|
658
|
+
<span class="cmd">openclaw gateway status</span>
|
|
659
|
+
|
|
660
|
+
<span class="comment"># View live logs</span>
|
|
661
|
+
<span class="cmd">journalctl --user -u openclaw-gateway -f</span></code></pre>
|
|
662
|
+
|
|
663
|
+
<h3>Updates</h3>
|
|
664
|
+
<pre><code><span class="comment"># Update OpenClaw and ClawMoat</span>
|
|
665
|
+
<span class="cmd">npm update -g openclaw clawmoat</span>
|
|
666
|
+
|
|
667
|
+
<span class="comment"># After updating, restart the gateway</span>
|
|
668
|
+
<span class="cmd">openclaw gateway restart</span>
|
|
669
|
+
|
|
670
|
+
<span class="comment"># Re-run security scan after updates</span>
|
|
671
|
+
<span class="cmd">clawmoat scan</span></code></pre>
|
|
672
|
+
|
|
673
|
+
<h3>Review Audit Logs</h3>
|
|
674
|
+
<pre><code><span class="comment"># What did the agent do today?</span>
|
|
675
|
+
<span class="cmd">clawmoat audit log --last 24h --summary</span>
|
|
676
|
+
|
|
677
|
+
<span class="comment"># Did it access any sensitive data?</span>
|
|
678
|
+
<span class="cmd">clawmoat audit log --filter sensitive --last 7d</span>
|
|
679
|
+
|
|
680
|
+
<span class="comment"># Export for compliance review</span>
|
|
681
|
+
<span class="cmd">clawmoat audit export --format csv --to /tmp/audit-feb-2026.csv</span></code></pre>
|
|
682
|
+
|
|
683
|
+
<h3>Backup Agent Configuration</h3>
|
|
684
|
+
<pre><code><span class="comment"># Back up your entire agent workspace</span>
|
|
685
|
+
<span class="cmd">tar czf agent-backup-$(date +%Y%m%d).tar.gz ~/.openclaw/workspace/</span>
|
|
686
|
+
|
|
687
|
+
<span class="comment"># Or use git (recommended)</span>
|
|
688
|
+
<span class="cmd">cd ~/.openclaw/workspace && git init && git add -A && git commit -m "Agent config backup"</span></code></pre>
|
|
689
|
+
|
|
690
|
+
<h3>Monitoring Checklist</h3>
|
|
691
|
+
<ul>
|
|
692
|
+
<li><strong>Daily:</strong> Check <code>openclaw gateway status</code> — ensure it's running</li>
|
|
693
|
+
<li><strong>Weekly:</strong> Review <code>clawmoat audit log --last 7d --summary</code> for anomalies</li>
|
|
694
|
+
<li><strong>Monthly:</strong> Run <code>clawmoat scan</code> and update software</li>
|
|
695
|
+
<li><strong>Quarterly:</strong> Review and update SOUL.md, MEMORY.md, and permission tiers</li>
|
|
696
|
+
</ul>
|
|
697
|
+
|
|
698
|
+
<!-- ===== 9. FAQ ===== -->
|
|
699
|
+
<h2 id="faq"><span class="num">9.</span> Frequently Asked Questions</h2>
|
|
700
|
+
|
|
701
|
+
<details class="faq-item">
|
|
702
|
+
<summary>How much does it cost to run an AI agent?</summary>
|
|
703
|
+
<p>Hardware is a one-time cost ($0–$599). The ongoing cost is your AI API usage — typically $50–$300/month depending on how active your agent is. Anthropic's Claude and OpenAI's GPT-4 are the most common choices. This is dramatically cheaper than hiring a human for the same tasks.</p>
|
|
704
|
+
</details>
|
|
705
|
+
|
|
706
|
+
<details class="faq-item">
|
|
707
|
+
<summary>Is my company data safe?</summary>
|
|
708
|
+
<p>Yes — and this is the key advantage of the OpenClaw + ClawMoat approach. Your agent runs on <strong>your hardware</strong>, not in a shared cloud. Data never leaves your network unless you explicitly configure an external channel. ClawMoat adds permission controls, forbidden zones, and audit trails on top.</p>
|
|
709
|
+
</details>
|
|
710
|
+
|
|
711
|
+
<details class="faq-item">
|
|
712
|
+
<summary>Can the agent access our accounting software?</summary>
|
|
713
|
+
<p>Yes, through MCP (Model Context Protocol) integrations. OpenClaw supports MCP servers for QuickBooks, Xero, spreadsheets, databases, and custom APIs. ClawMoat's McpFirewall lets you control exactly which tools the agent can use.</p>
|
|
714
|
+
</details>
|
|
715
|
+
|
|
716
|
+
<details class="faq-item">
|
|
717
|
+
<summary>What happens if the agent makes a mistake?</summary>
|
|
718
|
+
<p>ClawMoat's audit trail records every action, so you can always see what happened and why. For high-stakes operations (payments, external communications), configure the agent to require human approval before acting. Start with <strong>Standard</strong> permission tier and narrow as needed.</p>
|
|
719
|
+
</details>
|
|
720
|
+
|
|
721
|
+
<details class="faq-item">
|
|
722
|
+
<summary>Can we run multiple agents?</summary>
|
|
723
|
+
<p>Yes. You can run multiple OpenClaw instances on the same machine, each with its own workspace, personality (SOUL.md), and security policies. A finance agent and an operations agent can run side by side without interfering.</p>
|
|
724
|
+
</details>
|
|
725
|
+
|
|
726
|
+
<details class="faq-item">
|
|
727
|
+
<summary>Do we need a dedicated IT person to manage this?</summary>
|
|
728
|
+
<p>No. Once set up, the system is largely self-maintaining. Updates are a single command (<code>npm update -g openclaw clawmoat</code>). Monitoring is a weekly 5-minute check. That said, we offer <a href="mailto:hello@clawmoat.com?subject=Managed%20Service">managed service plans</a> if you prefer hands-off operation.</p>
|
|
729
|
+
</details>
|
|
730
|
+
|
|
731
|
+
<details class="faq-item">
|
|
732
|
+
<summary>What if our internet goes down?</summary>
|
|
733
|
+
<p>The agent will pause and resume when connectivity returns. OpenClaw handles reconnection automatically. For business-critical deployments, we recommend a backup internet connection (e.g., cellular failover).</p>
|
|
734
|
+
</details>
|
|
735
|
+
|
|
736
|
+
<details class="faq-item">
|
|
737
|
+
<summary>Is this HIPAA/SOC 2/SOX compliant?</summary>
|
|
738
|
+
<p>The on-premise architecture (your hardware, your data) is a strong foundation for compliance. ClawMoat's audit trails, access controls, and FinanceGuard module support SOX and SOC 2 requirements. For HIPAA, additional configuration is needed — <a href="mailto:hello@clawmoat.com?subject=HIPAA%20Compliance">contact us</a> for guidance.</p>
|
|
739
|
+
</details>
|
|
740
|
+
|
|
741
|
+
<details class="faq-item">
|
|
742
|
+
<summary>How long does setup take?</summary>
|
|
743
|
+
<p>A basic setup takes 1–2 hours. A fully configured business agent with custom workflows, security hardening, and team integrations typically takes 1–2 days. Our <a href="/services/">done-for-you service</a> handles everything in 3–5 business days.</p>
|
|
744
|
+
</details>
|
|
745
|
+
|
|
746
|
+
</article>
|
|
747
|
+
|
|
748
|
+
<!-- CTA -->
|
|
749
|
+
<div class="cta-box">
|
|
750
|
+
<h2>Ready to Deploy?</h2>
|
|
751
|
+
<p>Follow this guide yourself, or let us handle the setup. Either way, your AI agent can be working by next week.</p>
|
|
752
|
+
<a href="mailto:hello@clawmoat.com?subject=Business%20Deployment" class="btn btn-primary">Get Help Setting Up →</a>
|
|
753
|
+
</div>
|
|
754
|
+
|
|
755
|
+
</div>
|
|
756
|
+
|
|
757
|
+
<footer>
|
|
758
|
+
<div class="container">
|
|
759
|
+
<div style="display:flex;gap:24px;justify-content:center;flex-wrap:wrap;margin-bottom:16px">
|
|
760
|
+
<a href="https://github.com/darfaz/clawmoat" style="color:var(--gray)">GitHub</a>
|
|
761
|
+
<a href="https://www.npmjs.com/package/clawmoat" style="color:var(--gray)">npm</a>
|
|
762
|
+
<a href="/blog/" style="color:var(--gray)">Blog</a>
|
|
763
|
+
<a href="mailto:hello@clawmoat.com" style="color:var(--gray)">hello@clawmoat.com</a>
|
|
764
|
+
</div>
|
|
765
|
+
<p style="text-align:center;color:var(--gray);font-size:.85rem">© 2026 ClawMoat</p>
|
|
766
|
+
</div>
|
|
767
|
+
</footer>
|
|
768
|
+
|
|
769
|
+
</body>
|
|
770
|
+
</html>
|